mpv-rpc/README.md

49 lines
1.8 KiB
Markdown

<div align="center">
<img align="center" src="./img/mpv_logo.png">
# `MPV Discord Rich Presence`
**Discord Rich Presence integration for MPV player written in Rust**
[![Release](https://img.shields.io/github/v/release/ryze312/mpv-rpc)](https://github.com/ryze312/mpv-rpc/releases)
[![Downloads](https://img.shields.io/github/downloads/ryze312/mpv-rpc/total)](https://github.com/ryze312/mpv-rpc/releases)
[![Last commit](https://img.shields.io/github/last-commit/ryze312/mpv-rpc)](https://github.com/ryze312/mpv-rpc/commits/master)
[![Issues](https://img.shields.io/github/issues/ryze312/mpv-rpc)](https://github.com/ryze312/mpv-rpc/issues)
[![License](https://img.shields.io/github/license/ryze312/mpv-rpc)](./LICENSE)
![Rich presence](./img/rich_presence.png)
</div>
# Features
- Simple installation configuration using JSON
- Ability to toggle activity using keybinding (default - D)
- Displays current file name and timestamps
- Displays track metadata (artist, title, album, track number)
- Displays cover art from MusicBrainz archive
- Rusty! 🦀
# Installation
*Only Linux is supported at the moment, see MPV docs, regarding C plugins*
1. Download [latest release](https://github.com/ryze312/mpv-rpc/releases/latest) and unzip it
2. Run the installer script
3. Keybindings can be changed in input.conf
4. Done!
# Why?
- Alternative solutions either require third-party dependencies or were unreliable in my experience
- Furthermore, none of them allow automatic pulling of cover art!
- Learning and gaining experience in Rust!
# Contributing
All issues and pull requests are welcome! Feel free to open an issue if you've got an idea or a problem. You can open a pull request if you are able to implement it yourself.
---
<p align="center">
<sub><strong>
Made with ponies and love!
<br/>
GNU GPL © Ryze 2023
</strong></sub>
</p>