# Sounds

Sounds add audio to your automation — station announcements, warning signals, ambient effects, and more. They are played through the [Play sound](/docs/manual/automation/scripts/action/scenery.md) action in your scripts.

## Built-in library

Model Train Script includes 13 ready-to-use sounds:

| Sound                  | Description                              |
| ---------------------- | ---------------------------------------- |
| Gleis 1/2/3 Einfahrt   | Track 1/2/3 arrival announcement         |
| Gleis 1/2/3 Durchfahrt | Track 1/2/3 passing through announcement |
| Gleis 1/2/3 Abfahrt    | Track 1/2/3 departure announcement       |
| Schaffnerpfiff         | Conductor's whistle                      |
| Warnung                | Warning signal                           |
| Bellen                 | Dog barking                              |
| Schafherde             | Sheep sounds                             |

## Custom sounds

You can upload your own MP3 files (max 900 KB). Give each sound a name so you can easily select it when building scripts.

Use the preview button in the sound editor to listen before adding it to a script.

### Creating station announcements

A recommended workflow for realistic station announcements:

**1. Generate speech with a text-to-speech tool**

Use a free tool like [luvvoice.com](https://luvvoice.com/de):

* Language: German (Germany), Voice: Amala (Female)
* Settings: Rate +5% / Pitch -15%
* Example phrases:
  * "Auf Gleis ... bitte Vorsicht bei der Einfahrt"
  * "Achtung am Gleis .... Ein Zug fährt durch"
  * "Meine Damen und Herren an Gleis ... Bitte steigen sie ein. Vorsicht an den Türen und bei Abfahrt des Zuges"
* Download as MP3

**2. Edit with Audacity (free)**

* Delete silence and text breaks
* Effect - EQ and Filters - Bass and Treble: Bass -30 / Treble +5
* Effect - Delay and Reverb - Reverb: Defaults
* Effect - Delay and Reverb - Echo: 0.1 / 0.5
* Insert a station gong at the beginning of the file
* File - Export audio - MP3 default settings

## Using sounds in scripts

Add a **Play sound** action to any [automation script](/docs/manual/automation/scripts.md). You can choose whether the script waits for the sound to finish before continuing, or plays it in the background while the next action executes immediately.


---

# Agent Instructions: 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://modeltrainscript.gitbook.io/docs/manual/automation/sounds.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.
