mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-21 08:16:53 +00:00
Remove deprecated gstreamer integration (#39280)
This commit is contained in:
parent
9f144771cc
commit
97f7404e91
@ -1,104 +0,0 @@
|
||||
---
|
||||
title: GStreamer
|
||||
description: Instructions on how to integrate GStreamer into Home Assistant.
|
||||
ha_category:
|
||||
- Media player
|
||||
ha_release: 0.39
|
||||
ha_iot_class: Local Push
|
||||
ha_domain: gstreamer
|
||||
ha_platforms:
|
||||
- media_player
|
||||
ha_integration_type: integration
|
||||
related:
|
||||
- docs: /docs/configuration/
|
||||
title: Configuration file
|
||||
ha_quality_scale: legacy
|
||||
---
|
||||
|
||||
The `gstreamer` {% term integration %} 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 {% term "`configuration.yaml`" %} file.
|
||||
{% include integrations/restart_ha_after_config_inclusion.md %}
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
media_player:
|
||||
- platform: gstreamer
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: Name of the media player.
|
||||
required: false
|
||||
type: string
|
||||
pipeline:
|
||||
description: A `gst` pipeline description.
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
Only the `music` media type is supported.
|
||||
|
||||
## Setup
|
||||
|
||||
And then install the following system dependencies:
|
||||
|
||||
Debian/Ubuntu/Raspberry Pi OS (formerly Raspbian):
|
||||
|
||||
```bash
|
||||
sudo apt-get install python3-gst-1.0 \
|
||||
gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 \
|
||||
gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly \
|
||||
gstreamer1.0-tools
|
||||
```
|
||||
|
||||
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 `gi` module into your virtual environment:
|
||||
|
||||
```bash
|
||||
ln -s /path/to/your/installation/of/gi /path/to/your/venv/lib/python3.4/site-packages
|
||||
```
|
||||
|
||||
On a Raspberry Pi, you may need to add the Home Assistant user to the `audio` group:
|
||||
|
||||
```bash
|
||||
sudo usermod -a -G audio <ha_user>
|
||||
```
|
||||
|
||||
## Example usage
|
||||
|
||||
### Using with TTS
|
||||
|
||||
To play TTS on your local computer (for example, if you have speakers attached to your Raspberry Pi:
|
||||
|
||||
```yaml
|
||||
media_player:
|
||||
- platform: gstreamer
|
||||
|
||||
script:
|
||||
tts:
|
||||
sequence:
|
||||
- action: tts.google_say # or amazon_polly, voicerss, etc
|
||||
target:
|
||||
entity_id: media_player.gstreamer
|
||||
data:
|
||||
message: "example text-to-speech message"
|
||||
```
|
||||
|
||||
### Using with Snapcast
|
||||
|
||||
To play to a named pipe for consumption by Snapcast:
|
||||
|
||||
```yaml
|
||||
media_player:
|
||||
- platform: gstreamer
|
||||
pipeline: "audioresample ! audioconvert ! audio/x-raw,rate=48000,channels=2,format=S16LE ! wavenc ! filesink location=/tmp/snapcast_gstreamer"
|
||||
```
|
@ -561,6 +561,7 @@ layout: null
|
||||
/integrations/google_domains /more-info/removed-integration 301
|
||||
/integrations/gpmdp /more-info/removed-integration 301
|
||||
/integrations/griddy /more-info/removed-integration 301
|
||||
/integrations/gstreamer /more-info/removed-integration 301
|
||||
/integrations/hangouts /more-info/removed-integration 301
|
||||
/integrations/history_graph /more-info/removed-integration 301
|
||||
/integrations/htu21d /more-info/removed-integration 301
|
||||
|
Loading…
x
Reference in New Issue
Block a user