> For the complete documentation index, see [llms.txt](https://audalaxy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://audalaxy.gitbook.io/docs/json-configurations-for-audio/json-configurations-for-audio.md).

# JSON Configurations for Audio

The following options and configurations are available for optimising audio streming and playout.

{% hint style="info" %}
You can find the complete JSON schema with all available settings [here](/docs/json-configuration-guide-advanced-settings/json-configuration-guide-for-advanced-settings.md).
{% endhint %}

## Authentication

**Basic access**

The simplest technique for enforcing access controls.

```json
{
    "mountacl": {
        "username": "",
        "password": ""
    }
}
```

**Token access**

Audalaxy supports authentication by using a Token. Token-Based Authentication, relies on a signed JSON Web Token (JWT) that is sent to the server on each request.

## Auto switch to fallback stream

The Auto Switch function can be used to replace an audio source that is no longer available - for example, as a fallback for a simulcast.

<figure><img src="/files/uEOLIZkS1d1hEcA0DkFN" alt=""><figcaption></figcaption></figure>

### Workflow

Create a new additional source for this channel with the right incoming bitrate and select the fallback master server (the naming in the UI is a bit misleading, it’s not only “mid-roll trigger inside source”).

<figure><img src="/files/kw0x423lVc5tSP8bmIcV" alt=""><figcaption></figcaption></figure>

When creating listener mounts transcoding should be “forced”. Otherwise transcoding will be skipped if the source and listener mount have the same spec (e.g. same bitrate/format). The fallback mechanism is part of our transcodings so it needs to be enabled.

<figure><img src="/files/ogQHr9h0MZBmEnPDXPfk" alt=""><figcaption></figcaption></figure>

A special setting for the channel has to be created in “Advanced Settings”. This is the place for all settings that don’t have an UI and is written in JSON.

<figure><img src="/files/kiYXoP4DxiE7IwM4MNhi" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Please check if there is a red mark in the sidbar. In this case the JSON is not valid and can not be saved.
{% endhint %}

### Description Structure of the JSON document

* parameters silence, noise and threshold are freely configurable
* configuration per channel
* transcoding feature necessary

```json
{
    "fallback": {
        "url": "http://api.streamabc.net/sources/mounts/redirect/qc_0dm7w3mdgo3b_koaz",
        "max_silence": "10",
        "min_noise": "10",
        "threshold": "-30"
    }
}
```

<mark style="color:red;">`fallback`</mark> is the Key for the settings

<mark style="color:red;">`url`</mark> is the StreamURL of the fallback stream. You can just copy the URL of the source here. However, we have a special service that redirects to the source if a channelkey (our unique ID for a channel) is given. It auto-selects fallback mounts. The syntax is <http://api.streamabc.net/sources/mounts/redirect>/\<channelkey> Just use the channelkey of the current channel here. You can find it under “Setup”

<mark style="color:red;">`max_silence`</mark> is the number of seconds that the stream has to be silent before switching to fallback

<mark style="color:red;">`min_noise`</mark> is the number of seconds without silence before switching back

<mark style="color:red;">`threshold`</mark> is the audio level in dB that is considered silence

### Special use cases

1. If the fallback is a Audalaxy cloud playout there is no need to add an additional source. In that case use the special URL <http://api.streamabc.net/sources/mounts/redirect>/\<channelkey>/playout and replace \<channelkey> with the channelkey of the playout channel.
2. In case of sources with integrated bitflips we need a dedicated fallback url for every codec and bitrate as it is not possible to transcode these channels (in order to not loose the bitflips)

## Geoblocking / Geostreaming

In disallowed countries an audio file is played and the stream stopped.

```json
{
    "geo_allow_countries": ["DE","AT"],
    "geo_fallback": "https://url.zu.einer.audiodatei",
    "geo_active_hours": [20,21]
}
```

<mark style="color:red;">`geo_allow_countries`</mark>

Array specification of which countries are allowed to stream freely, all others are blocked; specify as ISO code

<mark style="color:red;">`geo_fallback`</mark>

URL to a file that is played as an announcement

<mark style="color:red;">`geo_active_hours`</mark>

Optional array with hours as a number when blocking is active. If it is always to be active, omit this block or specify an empty array

## Metadata delay

In advanced settings you can specify that the incoming metadata should be delayed (in seconds).

```json
{
    "metadata_delay": 30
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://audalaxy.gitbook.io/docs/json-configurations-for-audio/json-configurations-for-audio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.