# Radiotray-NG MPRIS
## Overview
Radiotray-NG MPRIS is a wrapper for [Radiotray-NG](https://github.com/ebruck/radiotray-ng) to add an [MPRIS2
interface](https://specifications.freedesktop.org/mpris-spec/latest/) which integrates well with desktop environments
(like [GNOME](https://extensions.gnome.org/extension/1379/mpris-indicator-button/),
[KDE](https://community.kde.org/MPRIS) or [XFCE](https://docs.xfce.org/panel-plugins/xfce4-pulseaudio-plugin/start)) or
desktop independent music player control tools like [playerctl](https://github.com/altdesktop/playerctl).
## Installation
First, you need a working installation of [Radiotray-NG](https://github.com/ebruck/radiotray-ng).
Radiotray-NG MPRIS is available on PyPI and can be installed with `pip`:
```bash
python3 -m pip install radiotray-ng-mpris
```
Please note that at least Python 3.10 is required (because of its dependency
[`mpris_server`](https://pypi.org/project/mpris-server/)). You can check your installed Python version with
```bash
python3 --version
```
If your Python version is too old, you don't want to use `pip` for the installation or you don't care about Python at
all, you can also download self-contained executables (no Python installation required) for Linux x64 from the [releases
page](https://github.com/IngoMeyer441/radiotray-ng-mpris/releases).
If you run an Arch-based system, you can also install Radiotray-NG MPRIS from the
[AUR](https://aur.archlinux.org/packages/radiotray-ng-mpris/):
```bash
yay -S radiotray-ng-mpris
```
In this case, Radiotray-NG will be installed as a package dependency automatically.
## Usage
Run
```bash
radiotray-ng-mpris
```
on the command line (or any application finder) to start Radiotray-NG and the MPRIS2 integration. Any MPRIS2 control
interface should start working with Radiotray-NG immediately.
Exit the application by quitting Radiotray-NG or the wrapper script (press `<Ctrl-c>` on the command line).
## Command line options
```text
usage: radiotray-ng-mpris [-h] [-p] [-V]
[-q | --error | --warn | -v | --debug]
radiotray-ng-mpris is a wrapper script for radiotray-ng to provide an MPRIS2
interface.
options:
-h, --help show this help message and exit
-p, --play start playback immediately
-V, --version print the version number and exit
-q, --quiet be quiet (default: "False")
--error print error messages (default: "False")
--warn print warning and error messages (default: "True")
-v, --verbose be verbose (default: "False")
--debug print debug messages (default: "False")
```
Raw data
{
"_id": null,
"home_page": "https://github.com/IngoMeyer441/radiotray-ng-mpris",
"name": "radiotray-ng-mpris",
"maintainer": null,
"docs_url": null,
"requires_python": "~=3.10",
"maintainer_email": null,
"keywords": "multimedia",
"author": "Ingo Meyer",
"author_email": "IJ_M@gmx.de",
"download_url": "https://files.pythonhosted.org/packages/01/e1/c3695336a0a56cb8e91d5e0a5a672022352e4b268ab822df732233e749b5/radiotray_ng_mpris-0.1.3.tar.gz",
"platform": null,
"description": "# Radiotray-NG MPRIS\n\n## Overview\n\nRadiotray-NG MPRIS is a wrapper for [Radiotray-NG](https://github.com/ebruck/radiotray-ng) to add an [MPRIS2\ninterface](https://specifications.freedesktop.org/mpris-spec/latest/) which integrates well with desktop environments\n(like [GNOME](https://extensions.gnome.org/extension/1379/mpris-indicator-button/),\n[KDE](https://community.kde.org/MPRIS) or [XFCE](https://docs.xfce.org/panel-plugins/xfce4-pulseaudio-plugin/start)) or\ndesktop independent music player control tools like [playerctl](https://github.com/altdesktop/playerctl).\n\n## Installation\n\nFirst, you need a working installation of [Radiotray-NG](https://github.com/ebruck/radiotray-ng).\n\nRadiotray-NG MPRIS is available on PyPI and can be installed with `pip`:\n\n```bash\npython3 -m pip install radiotray-ng-mpris\n```\n\nPlease note that at least Python 3.10 is required (because of its dependency\n[`mpris_server`](https://pypi.org/project/mpris-server/)). You can check your installed Python version with\n\n```bash\npython3 --version\n```\n\nIf your Python version is too old, you don't want to use `pip` for the installation or you don't care about Python at\nall, you can also download self-contained executables (no Python installation required) for Linux x64 from the [releases\npage](https://github.com/IngoMeyer441/radiotray-ng-mpris/releases).\n\nIf you run an Arch-based system, you can also install Radiotray-NG MPRIS from the\n[AUR](https://aur.archlinux.org/packages/radiotray-ng-mpris/):\n\n```bash\nyay -S radiotray-ng-mpris\n```\n\nIn this case, Radiotray-NG will be installed as a package dependency automatically.\n\n## Usage\n\nRun\n\n```bash\nradiotray-ng-mpris\n```\n\non the command line (or any application finder) to start Radiotray-NG and the MPRIS2 integration. Any MPRIS2 control\ninterface should start working with Radiotray-NG immediately.\n\nExit the application by quitting Radiotray-NG or the wrapper script (press `<Ctrl-c>` on the command line).\n\n## Command line options\n\n```text\nusage: radiotray-ng-mpris [-h] [-p] [-V]\n [-q | --error | --warn | -v | --debug]\n\nradiotray-ng-mpris is a wrapper script for radiotray-ng to provide an MPRIS2\ninterface.\n\noptions:\n -h, --help show this help message and exit\n -p, --play start playback immediately\n -V, --version print the version number and exit\n -q, --quiet be quiet (default: \"False\")\n --error print error messages (default: \"False\")\n --warn print warning and error messages (default: \"True\")\n -v, --verbose be verbose (default: \"False\")\n --debug print debug messages (default: \"False\")\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A wrapper script for Radiotray-NG which provides an MPRIS2 interface.",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/IngoMeyer441/radiotray-ng-mpris"
},
"split_keywords": [
"multimedia"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6044b4c77f8a14bc65db9e2bb8ffbaaa7a605f321c2485ae9f8c52af8f117712",
"md5": "222505ff00b1fa608ffc725ceb58c83d",
"sha256": "1db54a0a42663f493eda62b4bba4ee3c4deb26449639eb3f32318d763556342a"
},
"downloads": -1,
"filename": "radiotray_ng_mpris-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "222505ff00b1fa608ffc725ceb58c83d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.10",
"size": 9286,
"upload_time": "2024-10-02T13:58:55",
"upload_time_iso_8601": "2024-10-02T13:58:55.744183Z",
"url": "https://files.pythonhosted.org/packages/60/44/b4c77f8a14bc65db9e2bb8ffbaaa7a605f321c2485ae9f8c52af8f117712/radiotray_ng_mpris-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "01e1c3695336a0a56cb8e91d5e0a5a672022352e4b268ab822df732233e749b5",
"md5": "b38877730addd93c8780520599baa2be",
"sha256": "5304fdc79ef91354b360bbafce5115a627d43073dedc88ee38c1274e54dce51e"
},
"downloads": -1,
"filename": "radiotray_ng_mpris-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "b38877730addd93c8780520599baa2be",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.10",
"size": 10217,
"upload_time": "2024-10-02T13:58:57",
"upload_time_iso_8601": "2024-10-02T13:58:57.206707Z",
"url": "https://files.pythonhosted.org/packages/01/e1/c3695336a0a56cb8e91d5e0a5a672022352e4b268ab822df732233e749b5/radiotray_ng_mpris-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 13:58:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "IngoMeyer441",
"github_project": "radiotray-ng-mpris",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "radiotray-ng-mpris"
}
JSON
