> For the complete documentation index, see [llms.txt](https://modeltrainscript.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://modeltrainscript.gitbook.io/docs/manual/automation/sounds.md).

# 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.
