~~NOTOC~~
====== xfce4-mpc-plugin - Music Player Daemon(MPD) Client Plugin ======

A simple client plugin for Music Player Daemon.

  * **[[#Screenshot|Screenshot]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

Features :
  * Send Play/Stop/Next/Previous command to MPD.
  * Uses media icons names from icon-naming-spec (at least nuvola, tango and rodent themes provides these icons)
  * Decrease/increase volume using the mouse wheel.
  * Show the current volume, status and title as a tooltip when hovering the mouse over the plugin.
  * Show a simple playlist window upon middle-click, permitting to select a track to play
  * Configurable MPD host/port/password.
  * Toggles repeat/random features + enable/disable MPD outputs in the right-click menu.
  * Launch configurable client (gmpc, xterm -e ncmpc,..) through right-click menu
  * Configurable markup for tooltip and playlist, using a gmpc-like markup :
     * The playlist accepts %artist%, %title%, %album% and %track%
     * The tooltip accepts the same variables as well as %vol%, %status% and %newline%

----

===== Usage =====

  - [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
  - Right-click on the added plugin, select **Properties** to open the settings window. 

===== Screenshot =====

<figure "MPC Plugin Panel Indicator and Dropdown Menu">
{{:panel-plugins:mpc-plugin_panel_indicator_dropdown.png|MPC Plugin Panel Indicator and Dropdown Menu}}
</figure>

<figure "MPC Plugin Panel Indicator and Playlist">
{{:panel-plugins:mpc-plugin_panel_indicator_playlist.png|MPC Plugin Panel Indicator and Playlist}}
</figure>

<figure "MPC Plugin Properties Window">
{{:panel-plugins:mpc-plugin_properties_window.png|MPC Plugin Properties Window}}
</figure>

----

===== Latest Release =====

{{rss>https://archive.xfce.org/feeds/project/xfce4-mpc-plugin 1 date 2h}}

[[https://gitlab.xfce.org/panel-plugins/xfce4-mpc-plugin/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-mpc-plugin/|Download current release]]** (older versions of this component are also available here)

[[|Back to Top]]

----

===== Source code repository =====

[[https://gitlab.xfce.org/panel-plugins/xfce4-mpc-plugin]]

----

===== Reporting Bugs =====

  * **[[:panel-plugins:xfce4-mpc-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports


[[|Back To Top]]
----
[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]