Skip to content
Snippets Groups Projects
Commit 8b4a6edf authored by David Trattnig's avatar David Trattnig
Browse files

docs: add info on device config

parent c0ed0422
No related branches found
No related tags found
No related merge requests found
......@@ -79,15 +79,22 @@ PulseAudio is deactivated.
If you want to choose a different device, edit the configuration file and set a value for `output_device_0`.
It's also possible to set ALSA hardware device IDs like `hw:0,0`. Check the FAQ below on how to
It is also possible to set ALSA hardware device IDs like `hw:0,0`. Check the FAQ below on how to
retrieve available audio device IDs.
$`\textcolor{green}{\text{Recommended audio device configuration}}`$
For better I/O performance it's recommended to create an ALSA PCM device named `pcm.aura_engine`.
For better I/O performance it is recommended to create a custom ALSA PCM device named `pcm.aura_engine`, matching your device settings.
You can use the sample configuration [`sample.asoundrc`](https://gitlab.servus.at/aura/engine-core/-/blob/main/config/sample.asoundrc) as a basis for creating such device. Consult the ALSA documentation on details. After creating such device verify its properly
assigned in the configuration file as `output_device_0="pcm.aura_engine"`.
The following command creates a symlink in `config/.asoundrc` to your ALSA config in your home directory:
```bash
make audio.alsa.init
```
## Configure the audio source locations
Engine Core is requires different audio sources in order to perform the playout.
......@@ -104,7 +111,7 @@ audio/fallback/
All audio files inside are played in a randomized order, in situations where nothing is scheduled.
The folder is being watched for changes. So you can add/remove audio on the fly.
This fallback feature is enabled by default, but cann be turned off in via the configuration.
This fallback feature is enabled by default, but can be turned off in via the configuration.
Instead of the fallback folder you can use a playlist in the `playlist` folder for fallback
scenarios. Its default file location is:
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment