player_do
=========
player_do provides a simple command line interface to control whatever media
player is running on your computer. It has been designed for and tested on
Linux.
It is designed to allow you to configure the media buttons on your keyboard
(play, pause, next etc.) to Do The Right Thing without having to change anything
if you switch to a different media player.
It also includes commands ``install_gnome``, ``install_mate``,
``install_gnome3``, and ``install_cinnamon`` to help set up keyboard shortcuts
initially on GNOME2/Mate/GNOME3/Cinnamon. It can, however, be used with any
system where you can map keyboard shortcuts to commands.
The currently supported media players can be seen by running ``player_do --help``.
Those that have been tested include the following:
* Audacious
* Amarok
* Banshee
* Clementine
* cmus
* Exaile
* Guayadeque
* moc
* MPD (configurable using MPD_HOST and MPD_PORT environment variables like mpc)
* pianobar
* Quodlibet
* Rhythmbox (needs MPRIS plugin installed and enabled)
* shell-fm (0.8 and later)
* VLC (2.0 and later)
* Firefox, Chrome (when playing some media like videos and podcasts)
Many other players will be supported due to support for the MPRIS DBUS protocol,
without a specific backend. If you only need support for those players, consider
using `MPRIS-remote <http://incise.org/mpris-remote.html>`_ or `playerctl
<https://github.com/altdesktop/playerctl>`_.
To add more supported programs, see the existing code in the ``backends``
directory. Patches gratefully received!
Installation
------------
You need Python 3.8 or later. You can use pip to install::
pip install playerdo
However, we recommend the use of `pipx <https://pypi.org/project/pipx/>`_ to
install it into its own virtualenv, using your standard system Python 3,
with “system” libraries available (due to the DBUS requirement below)::
pipx install playerdo --system-site-packages --python `which python3`
You also need to install Python DBUS bindings. We recommend doing this at
the system level. On Debian-like systems this is usually done with one of the
following packages::
python-dbus
python3-dbus
An alternative to system-level Python DBUS is to use pipx to install them::
pipx inject playerdo dbus-python
(If an appropriate binary wheel for dbus is not found, the above may require
development packages to be installed, including ``libglib2.0-dev`` and
``libdbus-1-dev`` and Python development headers).
After installation, you can use ``player_do test`` to ensure everything expected
is available. It’s normal to see error messages relating to players that you
do not use or have installed.
Usage
-----
Control the currently active player using commands like::
player_do playpause
player_do next
For all commands and other options, see::
player_do --help
Links
-----
Download: https://pypi.python.org/pypi/playerdo
Source code: https://github.com/spookylukey/playerdo
Bug tracking: https://github.com/spookylukey/playerdo/issues
Changes: https://github.com/spookylukey/playerdo/blob/master/CHANGES.rst
Raw data
{
"_id": null,
"home_page": "http://bitbucket.org/spookylukey/playerdo",
"name": "playerdo",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "music media MPRIS player command interface wrapper",
"author": "Luke Plant",
"author_email": "luke@lukeplant.me.uk",
"download_url": "https://files.pythonhosted.org/packages/3d/f0/55ba67b9abb498fcb880270e3aba7d3095e1a81b15b0d42c1269403306c8/playerdo-2.1.tar.gz",
"platform": null,
"description": "player_do\n=========\n\nplayer_do provides a simple command line interface to control whatever media\nplayer is running on your computer. It has been designed for and tested on\nLinux.\n\nIt is designed to allow you to configure the media buttons on your keyboard\n(play, pause, next etc.) to Do The Right Thing without having to change anything\nif you switch to a different media player.\n\nIt also includes commands ``install_gnome``, ``install_mate``,\n``install_gnome3``, and ``install_cinnamon`` to help set up keyboard shortcuts\ninitially on GNOME2/Mate/GNOME3/Cinnamon. It can, however, be used with any\nsystem where you can map keyboard shortcuts to commands.\n\nThe currently supported media players can be seen by running ``player_do --help``.\nThose that have been tested include the following:\n\n* Audacious\n* Amarok\n* Banshee\n* Clementine\n* cmus\n* Exaile\n* Guayadeque\n* moc\n* MPD (configurable using MPD_HOST and MPD_PORT environment variables like mpc)\n* pianobar\n* Quodlibet\n* Rhythmbox (needs MPRIS plugin installed and enabled)\n* shell-fm (0.8 and later)\n* VLC (2.0 and later)\n* Firefox, Chrome (when playing some media like videos and podcasts)\n\nMany other players will be supported due to support for the MPRIS DBUS protocol,\nwithout a specific backend. If you only need support for those players, consider\nusing `MPRIS-remote <http://incise.org/mpris-remote.html>`_ or `playerctl\n<https://github.com/altdesktop/playerctl>`_.\n\nTo add more supported programs, see the existing code in the ``backends``\ndirectory. Patches gratefully received!\n\nInstallation\n------------\n\nYou need Python 3.8 or later. You can use pip to install::\n\n pip install playerdo\n\nHowever, we recommend the use of `pipx <https://pypi.org/project/pipx/>`_ to\ninstall it into its own virtualenv, using your standard system Python 3,\nwith \u201csystem\u201d libraries available (due to the DBUS requirement below)::\n\n pipx install playerdo --system-site-packages --python `which python3`\n\nYou also need to install Python DBUS bindings. We recommend doing this at\nthe system level. On Debian-like systems this is usually done with one of the\nfollowing packages::\n\n python-dbus\n python3-dbus\n\n\nAn alternative to system-level Python DBUS is to use pipx to install them::\n\n pipx inject playerdo dbus-python\n\n(If an appropriate binary wheel for dbus is not found, the above may require\ndevelopment packages to be installed, including ``libglib2.0-dev`` and\n``libdbus-1-dev`` and Python development headers).\n\nAfter installation, you can use ``player_do test`` to ensure everything expected\nis available. It\u2019s normal to see error messages relating to players that you\ndo not use or have installed.\n\nUsage\n-----\n\nControl the currently active player using commands like::\n\n player_do playpause\n player_do next\n\n\nFor all commands and other options, see::\n\n player_do --help\n\n\n\nLinks\n-----\nDownload: https://pypi.python.org/pypi/playerdo\n\nSource code: https://github.com/spookylukey/playerdo\n\nBug tracking: https://github.com/spookylukey/playerdo/issues\n\nChanges: https://github.com/spookylukey/playerdo/blob/master/CHANGES.rst\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Control various media players from a single command line interface.",
"version": "2.1",
"project_urls": {
"Homepage": "http://bitbucket.org/spookylukey/playerdo"
},
"split_keywords": [
"music",
"media",
"mpris",
"player",
"command",
"interface",
"wrapper"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e6a54f7bd038147baf992dea2e34c53ed1cfd63a870a136d0bc321539a81f31d",
"md5": "297858dcecdba6743d6ce780fd90541a",
"sha256": "dbbf00e4dd850d1c7d748e519e0bb32f8d9eaa998486b891081f4c3328897758"
},
"downloads": -1,
"filename": "playerdo-2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "297858dcecdba6743d6ce780fd90541a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3819,
"upload_time": "2023-09-01T14:49:44",
"upload_time_iso_8601": "2023-09-01T14:49:44.720282Z",
"url": "https://files.pythonhosted.org/packages/e6/a5/4f7bd038147baf992dea2e34c53ed1cfd63a870a136d0bc321539a81f31d/playerdo-2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3df055ba67b9abb498fcb880270e3aba7d3095e1a81b15b0d42c1269403306c8",
"md5": "c6a75c0f37eabb6400fed39112724cfa",
"sha256": "8a79a436676bc6a362e917af66b4070fd7c5f4c043a93ff25c3e40488d6e8343"
},
"downloads": -1,
"filename": "playerdo-2.1.tar.gz",
"has_sig": false,
"md5_digest": "c6a75c0f37eabb6400fed39112724cfa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4920,
"upload_time": "2023-09-01T14:49:45",
"upload_time_iso_8601": "2023-09-01T14:49:45.754248Z",
"url": "https://files.pythonhosted.org/packages/3d/f0/55ba67b9abb498fcb880270e3aba7d3095e1a81b15b0d42c1269403306c8/playerdo-2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-01 14:49:45",
"github": false,
"gitlab": false,
"bitbucket": true,
"codeberg": false,
"bitbucket_user": "spookylukey",
"bitbucket_project": "playerdo",
"lcname": "playerdo"
}
JSON