Merge lp:~alfonsosanchezbeato/media-hub/initial-docs into lp:media-hub

[Alfonso Sanchez-Beato]

Initial documentation for media-hub snap.

Initial documentation for media-hub snap.

[Jim Hodapp (jhodapp)]

Looks good, some things to fix inline below.

review: Needs Fixing

[lp:~alfonsosanchezbeato/media-hub/initial-docs]

215. By Alfonso Sanchez-Beato on 2017-03-21

Address review comments

[Alfonso Sanchez-Beato (alfonsosanchezbeato)]

@jhodapp, thanks for the review. Comments addressed and branch refreshed.

[Jim Hodapp (jhodapp)]

LGTM

review: Approve

=== added directory 'docs'
=== added file 'docs/index.md'
--- docs/index.md	1970-01-01 00:00:00 +0000
+++ docs/index.md	2017-03-21 09:09:53 +0000
@@ -0,0 +1,39 @@
+---
+title: "Media Hub"
+table_of_contents: False
+---
+
+# About Media Hub
+
+Media Hub is a simple and lightweight media playback service.  It implements the
+[MPRIS DBus
+interface](https://specifications.freedesktop.org/mpris-spec/latest/) and plays
+audio and video files. Among other features, it supports:
+
+ * Centralized system media playback and control
+ * Track lists
+ * Various simultaneous clients
+ * Hardware video decoding
+
+## Installing Media Hub
+
+It can be installed as a snap doing
+
+```text
+$ snap install media-hub
+```
+
+## Using Media Hub
+
+It can be used jointly with mediaplayer-app. To install this client:
+
+```text
+$ snap install --devmode mediaplayer-app
+$ snap connect mediaplayer-app:mpris media-hub:mpris
+```
+
+After this, files in Music or Videos folders can be played:
+
+```text
+$ mediaplayer-app Music/file.mp3
+```