mpv-discord

Discord Rich Presence Integration for MPV Media Player

_{Left: looping song in playlist (mouse hovering on small icon)
Right: paused in movie}

Features

• 🛠 Easy configuration
• 📦 No third-party dependencies
• 🚸 Simple installation (installer scripts included)
• 🏁 Cross-platform (embrace my beloved Golang!)
• ℹ️ Displays song metadata (title, artist, album)
• ⏳ Displays real time player state and timestamps

Why?

Currently, there are two alternatives I found on GitHub.

1. cniw/mpv-discordRPC
2. noaione/mpv-discordRPC

Discord RPC

In order to interact with Discord Rich Presence using RPC, the client needs to connect to Discord's IPC socket. However, both of the above alternatives do not keep a connection with Discord's IPC socket, which I think is rather unreliable.

See also: how mpv-discord works.

Third-party Dependencies

Both of the above alternatives require users to install third-party dependencies such as python-pypresence or lua-discordRPC. I found it hard to set up the dependencies and I also don't want to mess up my environment.

Installation

Installer scripts for Windows, Linux and OSX are provided.

1. Download .zip from the latest release and extract it.
   • or you can download .zip by clicking on the green download button in GitHub
   • or you can also use git clone https://github.com/tnychn/mpv-discord.git
2. Run the installer script of your platform.
   • run install_darwin.sh in Terminal for OSX
   • run install_linux.sh in Terminal for Linux
   • run install_windows.bat by double clicking on it for Windows
3. Before using, you must specify binary_path in the config file first.

Configurations

For OSX and Linux, config file is located in ~/.config/mpv/script-opts.

For Windows, config file is located in where the mpv.exe executable is.

• active (default: yes): whether to activate at launch (yes/no)
• binary_path: full path to the mpv-discord's binary file

How It Works

This plugin consists of 3 files.

1. discord.lua -- mpv user script
2. discord.conf -- configuration file
3. mpv-discord binary -- backend binary of the plugin

When mpv launches, mpv will run all the user scripts including discord.lua. Then discord.lua will read the configurations from discord.conf and do two things: (1) create an input-ipc-server socket of mpv. (2) start a subprocess of the mpv-discord binary. Then, mpv-discord will interact with the input-ipc-server to get the player state and properties of mpv. Finally, mpv-discord will update Discord's Rich Presence with the properties through Discord's IPC socket.

Contributing

If you have any ideas on how to improve this project or if you think there is a lack of features, feel free to open an issue, or even better, open a pull request. All contributions are welcome!

---

_{Made with ♥︎ by tnychn
MIT © 2021 Tony Chan}