Fix date, add logo, and minor layout changes

This commit is contained in:
Fabian Affolter 2017-02-16 18:36:50 +01:00
parent 82e834aafc
commit 299f5a1571
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336
2 changed files with 20 additions and 19 deletions

View File

@ -2,28 +2,36 @@
layout: page layout: page
title: "Gstreamer" title: "Gstreamer"
description: "Instructions on how to integrate Gstreamer into Home Assistant." description: "Instructions on how to integrate Gstreamer into Home Assistant."
date: 2017-02-016 10:00 date: 2017-02-16 10:00
sidebar: true sidebar: true
comments: false comments: false
sharing: true sharing: true
footer: true footer: true
ha_category: Media Player ha_category: Media Player
featured: false logo: gstreamer.png
ha_release: 0.39 ha_release: 0.39
ha_iot_class: "Local Push" 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. 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.
## Setup
To add a `gstreamer` media player to your installation, add the following to your `configuration.yaml` file: To add a `gstreamer` media player to your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
# Example configuration.yaml entry
media_player: media_player:
- platform: gstreamer - 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: And then install the following system dependencies:
Debian/Ubuntu/Rasbian: Debian/Ubuntu/Rasbian:
@ -35,13 +43,15 @@ sudo apt-get install python-gst-1.0 \
gstreamer1.0-tools gstreamer1.0-tools
``` ```
Redhat/Centos/Fedora: Red Hat/Centos/Fedora:
```bash ```bash
sudo yum install -y python-gstreamer1 gstreamer1-plugins-good \ sudo yum install -y python-gstreamer1 gstreamer1-plugins-good \
gstreamer1-plugins-ugly 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: 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 ```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 <ha_user> sudo usermod -a -G audio <ha_user>
``` ```
## Configuration ## {% linkable_title Example Usage %}
Configuration variables: ### {% linkable_title Using with TTS %}
- **name** (*Optional*): Name the player.
- **pipeline** (*Optional*): `gst` pipeline description.
Only the `music` media type is supported.
## Example Usage
### Using with TTS
To play TTS on your local computer (for example, if you have speakers attached to your Raspberry PI: 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" message: "example text-to-speech message"
``` ```
### Using with Snapcast ### {% linkable_title Using with Snapcast %}
To play to a named pipe for consumption by Snapcast: To play to a named pipe for consumption by Snapcast:

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.2 KiB