From 299f5a1571773a46f6de414906d722554da83ffd Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 16 Feb 2017 18:36:50 +0100 Subject: [PATCH] Fix date, add logo, and minor layout changes --- .../media_player.gstreamer.markdown | 39 +++++++++--------- source/images/supported_brands/gstreamer.png | Bin 0 -> 8401 bytes 2 files changed, 20 insertions(+), 19 deletions(-) create mode 100644 source/images/supported_brands/gstreamer.png diff --git a/source/_components/media_player.gstreamer.markdown b/source/_components/media_player.gstreamer.markdown index b3efea9dce1..a27f7330386 100644 --- a/source/_components/media_player.gstreamer.markdown +++ b/source/_components/media_player.gstreamer.markdown @@ -2,28 +2,36 @@ layout: page title: "Gstreamer" description: "Instructions on how to integrate Gstreamer into Home Assistant." -date: 2017-02-016 10:00 +date: 2017-02-16 10:00 sidebar: true comments: false sharing: true footer: true ha_category: Media Player -featured: false +logo: gstreamer.png ha_release: 0.39 ha_iot_class: "Local Push" --- -The `gstreamer` platform allows you to play audio via a gstreamer pipeline. Practically, this means you can play audio directly on the computer running Home Assistant. It is particularly suited for playing TTS. Advanced users can specify a pipeline to transform the audio stream and/or redirect it elsewhere. - -## Setup +The `gstreamer` platform allows you to play audio via a [gstreamer](https://gstreamer.freedesktop.org/) pipeline. Practically, this means you can play audio directly on the computer running Home Assistant. It is particularly suited for playing TTS. Advanced users can specify a pipeline to transform the audio stream and/or redirect it elsewhere. To add a `gstreamer` media player to your installation, add the following to your `configuration.yaml` file: ```yaml +# Example configuration.yaml entry media_player: - platform: gstreamer ``` +Configuration variables: + +- **name** (*Optional*): Name the player. +- **pipeline** (*Optional*): `gst` pipeline description. + +Only the `music` media type is supported. + +## {% linkable_title Setup %} + And then install the following system dependencies: Debian/Ubuntu/Rasbian: @@ -35,13 +43,15 @@ sudo apt-get install python-gst-1.0 \ gstreamer1.0-tools ``` -Redhat/Centos/Fedora: +Red Hat/Centos/Fedora: ```bash sudo yum install -y python-gstreamer1 gstreamer1-plugins-good \ gstreamer1-plugins-ugly ``` +For Fedora replace `yum` with `dnf`. + If you're running Home Assistant in a virtual environment, you'll need to symlink the system Python's `gst` module into your virtual environment: ```bash @@ -54,18 +64,9 @@ On a Raspberry PI, you may need to add the Home Assistant user to the `audio` gr sudo usermod -a -G audio ``` -## Configuration - -Configuration variables: - -- **name** (*Optional*): Name the player. -- **pipeline** (*Optional*): `gst` pipeline description. - -Only the `music` media type is supported. - -## Example Usage - -### Using with TTS +## {% linkable_title Example Usage %} + +### {% linkable_title Using with TTS %} To play TTS on your local computer (for example, if you have speakers attached to your Raspberry PI: @@ -82,7 +83,7 @@ script: message: "example text-to-speech message" ``` -### Using with Snapcast +### {% linkable_title Using with Snapcast %} To play to a named pipe for consumption by Snapcast: diff --git a/source/images/supported_brands/gstreamer.png b/source/images/supported_brands/gstreamer.png new file mode 100644 index 0000000000000000000000000000000000000000..b25cdccde141151aebe41510b4fc5704ecd46471 GIT binary patch literal 8401 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 JVvW3I)PM4&i~;}v literal 0 HcmV?d00001