Version 0.4.2

Version 0.4.2 includes several important bug fixes.

• Send Play directly instead of a PlayPause message depending on player status. This was an exception for Spotify that is no longer needed.
• Fix memory errors when an initialization error occurs.

Version 0.4.1

This version includes a fix to support unicode characters when printing metadata.

Version 0.4.0

This version adds the following features and bugfixes

• List players with cli -l option.
• Fix a bug in the build for some platforms
• Remove claim of mplayer support

Version 0.3.0

This release includes some major bugfixes and some new features mostly for the library for use in applications.

• Add the "stop" library and cli command
• Add the "exit" signal - emitted when the player exits
• Implement player class memory management
• Add version macros

The following quirks have been corrected (should not be breaking)

• Player "player_name" property getter returns the player name and not the DBus name
• Player "stop" event correctly emits "stop" and not "pause"
• Add include guards so only <playerctl/playerctl.h> can be included directly

Additional packages available by request

Version 0.2.1

This minor release adds a pkg-config file and relicenses the code under the LGPL.

Version 0.2.0

This release adds convenient metadata accessors and improves error handling

• Add get_artist method to player
• Add get_title method to player
• Add get_album method to player
• Add get_metadata_prop to player
• Add [KEY] option to metadata cli
• Bugfix: gracefully handle property access when connection to dbus fails by returning empty properties

Version 0.1.0

This release adds some new player commands and improves error handling

• Add the "next" CLI command and player method used to switch to the next track
• Add the "previous" CLI command and player method used to switch to the previous track
• Print an error message when no players are found in the CLI and propagate an error on initialization in this case in the library
• Print an error message when a command fails in the CLI and propagate an error in this case in the library

Initial Release

Playerctl is a command-line utility and library for controlling media players that implement the MPRIS D-Bus Interface Specification. Playerctl makes it easy to bind player actions, such as play and pause, to media keys.

For more advanced users, Playerctl provides an introspectable library available in your favorite scripting language that allows more detailed control like the ability to subscribe to media player events or get metadata such as artist and title for the playing track.