An updated Discord rich presence for VLC media player.
This is a modified version of the Pigpog/vlc-discord-rpc project, which is no longer being actively maintained. We have updated and enhanced the project by adding new features, such as album and show covers.
If you have any issues, that may not be a bug related, or any ideas for the project stop by our Discord.
- Download the code from this repository, then unzip it.
- Install Node.js. You must use version 17.5 at the minimum due to fetch!
- Make an application and get your Discord Application ID.
- In the storage folder, make a file called
config.js
, and copy over the contents ofexample_config.js
. - Proceed to the next step if you would like to use spotify art, or just go to step 8.
- OPTIONAL: Retrieve your Spotify API key.
- Add both of these values in the
./Storage/config.js
file under therichPresenceSettings
andspotify
area if you are choosing to use the album art. - In
./Storage/config.js
right before thespotify
area, set useSpotify to true. - OPTIONAL: Add your OMDb Api Key as the movieApiKey. This will allow you to display movies as movies, instead of videos.
- Open a terminal, move to the folder you downloaded from this repository, and run
npm i
then runnode .
.
- Open VLC.
- Select Tools in the top menu bar.
- Select Preferences.
- At the bottom left, select all.
- Select Main Interfaces.
- Check the box labelled Web.
- Back where we selected Main Interfaces, select the caret next to it.
- Select Lua.
- Enter a password into the Lua HTTP box. It does not matter what this is, but you will need to add it to your config.
- Update any needed values in your config. Change detached to true. You MUST set your own password and make sure to include it in VLC.
- Start VLC, then run the program as normal.
Note: Do not touch the port or address unless you know what you are doing! 8080 is VLC's default HTTP port.
If you would like to change the default icons for pause, play, or VLC in your discord status, you will need to have a link to an image (which must end in .png, .jpg, or something similar). You can do this by using imgur, or any site of your choosing. Then, simply replace the link in the iconNames part of the config.js.
To use an uploaded file instead of a link you need to do the following:
- Sign in to the Discord Developer Portal.
- Go to your application you created during setup.
- On the left sidebar, click Rich Presence.
- You should be under the Art Assets section, but if not click the Art Assets button.
- Add your images, and choose names for them.
- Go into your config.js, and under the iconNames section, set the icon to the name you choose for your image.
- Give it a minute or two, and then you should see it working. For other users, it may take a few hours for your images to show up.
If you would like to display shows and movies as such, instead of a video, you will need to use our custom metadata script.
- Install FFMPEG
- Add FFMPEG to PATH.
- In the vlc-rpc project folder, change directories into the Metadata folder by using
cd Metdata
in the terminal/console. - Run
node metadata.js
ornode metadata_folder.js
. The folder option will automatically go through each file in the folder (excluding any file names including "meta") and just ask if it's a show/movie. The file will be named the original name +_meta
. - Fill in the prompts. For the movie name, please use the one found on IMDB (generally you do not have to worry about this).
- Optional: Add your movie api key to
config.js
. Movies will be displayed as videos otherwise. - Start watching your new file in VLC.