Simplify local media sources more info (#21153)

Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
Paulus Schoutsen 2022-01-12 00:03:55 -08:00 committed by GitHub
parent 86700872b5
commit add1c9c9e4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -3,17 +3,28 @@ title: "Setting up local media sources"
description: "More information on how to set up local media sources in Home Assistant." description: "More information on how to set up local media sources in Home Assistant."
--- ---
In order to use the media browser with Home Assistant, it needs to know where to Home Assistant has a local media folder. Any audio or video files placed in this folder will be accessible via the media browser.
find your local media.
## Home Assistant OS and Supervised The easiest way to manage your local media is using the {% my supervisor_addon title="Samba" addon="core_samba" %}.
No action is needed from your end to set it up. Home Assistant will ## Using custom folders
automatically use the "media" folder that is provided on these systems.
It is also possible to set up custom and additional media directories. To do
so, you'll need to adjust the [core configuration][basic-configuration].
This example adds the two media folders to Home Assistant:
```yaml
# Example configuration.yaml
homeassistant:
media_dirs:
media: /media
recording: /mnt/recordings
```
## Home Assistant Container ## Home Assistant Container
If you run the Home Assistant Container in, for example, Docker, you'll need to If you run the Home Assistant Container you'll need to
add a Docker volume mount to the Home Assistant container, to mount in add a Docker volume mount to the Home Assistant container, to mount in
your local media. your local media.
@ -45,8 +56,7 @@ in a similar fashion as listed in the command above.
## Home Assistant Core ## Home Assistant Core
If you run Home Assistant Core directly in, for example, a Python virtual If you run Home Assistant Core you'll need to create a media folder yourself.
environment, you'll need to create a media folder yourself.
By default, Home Assistant will look for the `media` folder inside your current By default, Home Assistant will look for the `media` folder inside your current
Home Assistant configuration folder. Home Assistant configuration folder.
@ -59,19 +69,4 @@ Then you'll need to create a media folder in that same path:
`/home/frenck/.homeassistant/media` `/home/frenck/.homeassistant/media`
## Using custom folders
It is also possible to set up custom and additional media directories. To do
so, you'll need to adjust the [core configuration][basic-configuration].
This example adds the two media folders to Home Assistant:
```yaml
# Example configuration.yaml
homeassistant:
media_dirs:
media: /media
recording: /mnt/recordings
```
[basic-configuration]: /docs/configuration/basic/#media_dirs [basic-configuration]: /docs/configuration/basic/#media_dirs