🏷️ Utilize Lanyard to display your Discord Presence in your GitHub Profile
Special thanks to @Phineas for creating Lanyard, and making this project possible
First, join the Lanyard Discord (if you haven't already) for this to work.
In a README.md
file, include the following, replacing :id
with your Discord user ID:
[![Discord Presence](https://lanyard.cnrad.dev/api/:id)](https://discord.com/users/:id)
It should display something similar to the following (I am using my Discord user ID as an example):
When others click it, they will be directed to your actual Discord profile. Neat!
There are a few options to customize this display using query parameters:
Append the query param theme=:theme
to the end of the URL, replacing :theme
with either light
or dark
. This will change the background and the font colors, but the background can be overridden with the Background Color parameter.
Append the query param bg=:color
to the end of the URL, replacing :color
with a hex color of your choice (omit the #)
Append the query param borderRadius=:radius
to the end of the URL, replacing :radius
with a radius of your choice. (default 10px
)
If you have an animated avatar, append the query param animated=:bool
to the end of the URL, replacing :bool
with true
or false
. This is set to true
by default.
If you don't want the default "I'm not currently doing anything!
" as your idle message, you can change it by appending idleMessage=:yourmessage
to the end of the URL.
If you'd like to show your global display name as well as your username, append the query param showDisplayName=true
to the end of the URL. This is set to false
by default.
If you don't want people seeing your status, append the query param hideStatus=true
to the end of the URL. Your status is shown by default if you have one.
If you don't want people seeing the elapsed time on an activity, append the query param hideTimestamp=true
to the end of the URL. Elapsed time is shown by default.
If you don't want people seeing the badges you have on Discord, append the query param hideBadges=true
to the end of the URL. Badges are shown by default.
If you don't want people seeing the profile you have on Discord, append the query param hideProfile=true
to the end of the URL. Profile are shown by default.
If you don't want people seeing the your activity, append the query param hideActivity=true
to the end of the URL or use hideActivity=whenNotUsed
to hide activity section when there's no activity to display. Activity are shown by default.
If you don't want display a specific application, append the query param ignoreAppId=:app_id
to the end of the URL, IDs separate by ,
.
If you don't want people seeing your discriminator (most likely for privacy reasons), append the query param hideDiscrim=true
to the end of the URL. Your discriminator is shown by default.
[![Discord Presence](https://lanyard-profile-readme.vercel.app/api/94490510688792576?theme=light&bg=809ecf&animated=false&hideDiscrim=true&borderRadius=30px&idleMessage=Probably%20doing%20something%20else...)](https://discord.com/users/94490510688792576)
Note: Current Nitro & Boosting badges do not work due to Discord API limitations, unless you currently have an animated avatar, in which case it will display the Nitro badge.
If you're using this in your profile, feel free to show support and give this repo a ⭐ star! It means a lot, thank you :)