Back to Projects
mpv-discordRPCX

mpv-discordRPCX

Discord Rich Presence integration for mpv Media Player, with support for cover art scraping from anime titles based on filename. Beautifully laid out and automatically set up.

Jun 2025 - Jun 2025 Less than a month

Tech Stack

LuaPythonREST APIs

mpv-discordRPCX

An mpv plugin for displaying currently playing media on Discord
Forked from mpv-discordRPC

ForewordKey FeaturesHow To UseConfigurationContact MeLicense

Foreword

The majority of the work in this fork comes from the original repo, credits to cniw for building a functional plugin. However I saw that the plugin wasnt actively being maintained and was missing a few features that would make it even better so I decided to maintain this fork. If you have any suggestions or feature requests please open an issue or contact me on Discord : @knuckles_was_taken

Key Features

How To Use

Dependencies

  1. Provided by user: mpv, Discord
  1. Included: Discord RPC, status-line,lua-discordRPC
  2. Optional: Python, pypresence
# Clone the repository
git clone https://github.com/ujjwal-dev23/mpv-discordRPC.git
cd mpv-discordRPC.git

# Use the appropriate install script
install-linux.sh
install-win.bat
install-osx.sh

Configuration

rpc_wrapper=lua-discordRPC
# Available option, to set `rpc_wrapper`:
# * lua-discordRPC
# * python-pypresence

periodic_timer=15
# Recommendation value, to set `periodic_timer`:
# value >= 1 second, if use lua-discordRPC,
# value >= 3 second, if use pypresence (for the python3::asyncio process),
# value <= 15 second, because discord-rpc updates every 15 seconds.

playlist_info=yes
# Valid value to set `playlist_info`: (yes|no)

hide_url=no
# Valid value to set `hide_url`: (yes|no)

loop_info=yes
# Valid value to set `loop_info`: (yes|no)

cover_art=yes
# Valid value to set `cover_art`: (yes|no)

mpv_version=yes
# Valid value to set `mpv_version`: (yes|no)

active=yes
# Set Discord RPC active automatically when mpv started.
# Valid value to `set_active`: (yes|no)

key_toggle=D
# Key for toggle active/inactive the Discord RPC.
# Valid value to set `key_toggle`: same as valid value for mpv key binding.
# You also can set it in input.conf by adding this next line (without double quote).
# "D script-binding mpv_discordRPC/active-toggle"

anime_scraping=yes
# Enables scraping of anime cover art, titles, and genres from Jikan API
# Valid values to set `anime_scraping`: (yes|no)

Contact Me

You may also like…

License

MIT


View All Projects