EinTim23 6f29111c40 | ||
---|---|---|
cmake | ||
img | ||
osx | ||
rsrc | ||
src | ||
vendor | ||
win | ||
.clang-format | ||
.gitignore | ||
.gitmodules | ||
CMakeLists.txt | ||
LICENSE | ||
README.md | ||
settings.example.json |
README.md
PlayerLink
Cross platform, universal discord rich presence for media players.
System requirements
- Mac OS 10.15 or later
- Windows 10 1809 or later
- Pretty much any linux distribution with gtk3 and dbus support
Showcase
You can add predefined players to the settings.json to customise the name it shows in discord, edit the search button base url, and app icon. By default it will just display as "Music" without a search button or app icon.
Backends
Windows
The Windows backend is powered by Windows.Media.Control.GlobalSystemMediaTransportControlsSessionManager (horrible name I know) introduced in Windows 10 1809. It allows to query the system wide media information.
Mac OS
The Mac OS backend is powered by the private MediaRemote framework. It provides PlayerLink with the currently playing song information.
Linux
The linux backend is powered by MPRIS. It allows to query the system wide media information via dbus.
Config
Mac OS
~/Library/Application Support/PlayerLink
Linux
~/.config/PlayerLink
Windows
%appdata%\PlayerLink
An example on how to add custom apps to the config can be found here. In the future there will be a UI to configure custom apps in a more user friendly way.
Building
Prerequisites
Windows
- Visual Studio toolchain with CMake that supports C++ 17 and winrt. Clang or MSVC doesn't matter. You might be able to get mingw to work, but I personally had issues using winrt with mingw and therefore its unsupported.
- Git
Linux
- GTK3 developer libraries and includes
- A C++ 17 capable compiler (gcc or clang should both work)
- A C compiler
- CMake
- Git
Mac OS
- Xcode 11 or newer with the Mac OS toolchain installed
- CMake
- Git
How to build
-
Open your unix shell or Windows Developer Powershell
-
Clone the repository recursively to include submodules and enter the directory
git clone --recursive https://github.com/EinTim23/PlayerLink.git cd PlayerLink
-
Use CMake to configure the project
# for a release build cmake -S . -B build -DCMAKE_BUILD_TYPE=Release # for a debug build cmake -S . -B build
-
Build the project :)
# for a release build cmake --build build --config Release # for a debug build cmake --build build
Contributing
This repository is open for contributions. You can view the current roadmap here or implement your own features and then open a pull request. Please keep your code as consistent and clean as possible.
Credits
This project was heavily inspired by Alexandra Aurora's MusicRPC and her project may provide a better experience when being on Mac OS only.