From 83d6fd98176428141994ab36c1579c4e33896273 Mon Sep 17 00:00:00 2001
From: Fabio Manganiello <blacklight86@gmail.com>
Date: Sun, 5 Nov 2017 01:11:13 +0100
Subject: [PATCH] README

---
 README.md | 42 ++++++++++++++++++++++++++++--------------
 1 file changed, 28 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 9ff559531d..1928b0c75a 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,20 @@ Edit the file to include:
 
 Each target device is identified by a unique device_id in the messages sent over your account. The device_id is the hostname by default, unless changed in config.yaml.
 
+Shell interface
+---------------
+
+`runbullet` installs `pusher`, a command-line tool to send PushBullet messages to the connected devices in the format used by runbullet.
+
+Some examples:
+
+```shell
+pusher --target laptop --action shell.exec --cmd "scp /home/user/photos/*.jpg backup_host:/mnt/hd/photos"
+pusher --target raspberrypi --action music.mpd.play
+```
+
+The logic to execute is specified by the `--action` option, whose format is `package_name.method_name` (with method_name part of the package main class).
+
 Available plugins
 -----------------
 
@@ -31,6 +45,20 @@ Available plugins
 pusher --target laptop --action shell.exec --cmd "scp /home/user/photos/*.jpg backup_host:/mnt/hd/photos"
 ```
 
+* `runbullet.plugins.music.mpd`: Controls the playback on a mpd/mopidy music server. Requires the package `mpd2` on the target machine. Example:
+
+```shell
+pusher --target raspberry --action music.mpd.play
+```
+
+Configure the plugin through an entry like this in your `config.yaml`:
+
+```yaml
+music.mpd:
+    host: your_mpd_host
+    port: 6600
+```
+
 * `runbullet.plugins.switch.wemo`: Controls a WeMo Switch smart switch device. Requires the package `ouimeaux` on the target machine. Example:
 
 ```shell
@@ -43,20 +71,6 @@ pusher --target raspberry --action switch.wemo.on
 pusher --target raspberry --action light.hue.set_scene --scene "Sunset" --group "Living Room"
 ```
 
-Testing
--------
-
-`runbullet` installs `pusher`, a command-line tool to send PushBullet messages to the connected devices in the format used by runbullet.
-
-Some examples:
-
-```shell
-pusher --target laptop --action shell.exec --cmd "scp /home/user/photos/*.jpg backup_host:/mnt/hd/photos"
-pusher --target raspberrypi --action music.mpd.play
-```
-
-The logic to execute is specified by the `--action` option, whose format is `package_name.method_name` (with method_name part of the package main class).
-
 Writing your plugins
 --------------------