Audacious Discord RPC

Discord Rich Presence (RPC) plugin for Audacious!
Displays what you’re vibing to in your Discord profile. 🧑‍🎤🎶

This is a modernisation hard-fork by onegen of darktohka/audacious-plugin-rpc (made in 2018, abandoned in 2022) by DarkTohka et al.
It migrates the plugin from the deprecated discord/discord-rpc to the modernised EclipseMenu/discord-presence, allowing it to use the new LISTENING activity type (“Listening to...”) and a progress bar.

Original (v1.x):

This Fork (v2):

This Fork + Experimental ‘Fetch Cover Art’ Option (WiP):

_{Note: Cover art fetching is experimental, unstable and WiP. It is available as an opt-in setting. Covers are fetched from MusicBrainz (CAA).}

Installation

Note

It is not possible to install this plugin on sandboxed immutable distributions of Audacious like Flatpak or Snap.

This plugin is not included in the official Audacious plugins, so it has to be added to the Audacious plugin directory manually. Audacious is usually installed system-wide, so administrator privilages will likely be required.
Plugin is compiled for Linux and Windows (10+).

1. Get the discord-rpc plugin file. In the releases section, see the latest version – a ZIP file with the compiled plugin should be available for Linux and Windows. Releases labeled "Pre-Release" have yet-untested features and might cause crashes – if that sounds bad to you, stick to "Latest". :)

   The plugin file is discord-rpc.so for Linux and discord-rpc.dll for Windows.

2. Find the plugin directory. More specific notes on finding it are in the included INSTALL.[PLATFORM].txt. On Linux, you can find the directory via pkg-config if you installed Audacious as a system package:

   echo "$(pkg-config --variable=plugin_dir audacious)/General"

   On Windows, it depends on where you installed the music player. The default location is C:\Program Files (x86)\Audacious. The plugin directory is within that installation folder in lib\audacious\General subdirectory, so with the default root: C:\Program Files (x86)\Audacious\lib\audacious\General.

   On all platforms it should be called ‘General’ and be filled with other default plugins (.so or .dll files).

3. Copy the plugin there. Once you found the directory, copy the discord-rpc.{so,dll} file there. You’ll likely need administrator (sudo) privilages if installed system-wide. A shortcut for Linux users:

   sudo cp ~/Downloads/discord-rpc.so $(pkg-config --variable=plugin_dir audacious)/General/

4. Enable the plugin. In Audacious, open ‘Services’ on the top menu, then open ‘Plug-Ins’ and in the ‘General’ tab, you should see ‘Discord RPC’ as shown on the screenshot below. Checking the box will enable the plugin. The plugin has a few configurable options, which you can change by clicking ‘Settings’ with the plugin highlighted.

If you encounter any issues or crashes, please, open an issue! I want this to work so if something is broken, I’ll do my best to fix it. Alternatively, if you’re good with C++, and feel like helping out, check if you can’t fix something yourself. PRs are always appreciated! ❤️

This plugin prints a good amount of debug info when enabled. To specifically see only the plugin’s logs, run Audacious from a terminal like so:

audacious -VV 2>&1 | grep --line-buffered -i 'RPC'

audacious -VV o+e>| grep --line-buffered -i 'RPC' # for nushell

Uninstallation

To uninstall the plugin, simply delete the discord-rpc.so file from the Audacious ‘General’ plugins directory (see step 2 of Installation above). A quick shell command:

sudo rm $(pkg-config --variable=plugin_dir audacious)/General/discord-rpc.so

Also, if you used the older (original) version of the plugin (pre-fork), you might want to delete that, too. The older file was called libaudacious-plugin-rpc.so.

sudo rm $(pkg-config --variable=plugin_dir audacious)/General/libaudacious-plugin-rpc.so

Building

Making a full-on release can take a while. At times, an issue can be fixed on git master but it can take a while until a release with a fix is made. If you are more technically aligned or want to help with development, you can always build this plugin yourself.

Pre-requisites, no matter the platform, is Git, CMAKE and a C++ building toolchain. On Linux, you need to install cURL and Audacious development libraries via the native package manager (or wrapper idc) as audacious-dev (Debian/Ubuntu-based DEB) or audacious-devel (Red Hat-based RPM). The development libraries should be automatically installed on Arch-based distributions. On Windows, you need a MSYS2 MINGW64 environment. To ensure all you need is installed on there, run this:

pacman -Syu
pacman -S base-devel git mingw-w64-x86_64-toolchain mingw-w64-x86_64-gcc mingw-w64-x86_64-glib2 mingw-w64-x86_64-cmake mingw-w64-x86_64-pkg-config

For cover art fetching capabilities, Linux uses cURL and Windows uses built-in WinHTTP. On distributions without cURL, it is possible to build the plugin with this functionality unavailable.

After ensuring all the pre-requisites are installed, building is just a matter of calling cmake:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

The built version should be optimised for speed (-Ofast). For debugging needs, you can use -DCMAKE_BUILD_TYPE=Debug which adds -Og and bakes in debug symbols. The resulting discord-rpc.so (Linux) or discord-rpc.dll (Windows) should then be copied to general plugins directory, as described above. Linux users can use an install command for this:

sudo cmake --install build

Licence

This is a free and open-source software, licensed under the MIT licence.

• TL;DR;NAL: Do absolutely whatever you want with the code, just include the LICENCE file if you re-distribute it.
• See LICENCE file or tl;drLegal for more details.

Credits

• onegen – developer of this continuation fork
• Derzsi “DarkTohka” Dániel, et al. – developers of the original plugin
• Олександр “Prevter” Немеш – developer of discord-presence, the used Discord RPC library
• and additionally all the Discord & Audacious developers and contritutors.