Soundbrett

# Soundbrett

A GM soundboard for Foundry VTT — play folder-organized audio in sync to your
players, or just the ones you choose, with persistent per-sound settings,
search & tagging, and switchable themes.

The Game Master opens a panel that lists every audio file from a configurable
folder (subfolders become categories). Sounds the GM starts are played back in
sync for connected players via sockets and can be controlled centrally (pause/resume, stop, loop, volume).

## Features

• **Folder-based library** — point the module at a folder; subfolders show up as
    collapsible categories.
  - **Synced playback** — sounds the GM triggers play for players too, kept in sync
    over sockets with a world-scope state so playback survives reloads and
    late-joining players catch up automatically.
  - **Central controls** — pause/resume, stop, loop and per-track volume, plus a
    "stop all" button.
  - **Per-sound settings (persistent)** — volume, loop, favorite, a custom display
    name and free-form tags are remembered per sound, independent of what is
    currently playing.
  - **Favorites** — star a sound to collect it in a dedicated Favorites group.
  - **Search** — filter by display name, original file name or tags; multi-term
    queries match any of the terms (OR).
  - **Tagging** — add comma-separated tags per sound to find them across the folder
    structure.
  - **Selective routing** — choose who hears a sound: everyone, only the GM, or
    specific players. Set a board-wide default and override it per sound.
  - **Preloading** — warm up players' audio buffers ahead of time so larger sounds
    start instantly and in sync (single sound or all favorites at once).
  - **Hotbar drag & drop** — drag a sound onto the macro bar to create a toggle
    macro for it.
  - **Theming** — a restrained neutral default theme, an "arcane" look, and a
    Warhammer Fantasy Roleplay (WFRP) skin that is offered only while the
    `wfrp4e` system is active.

## Requirements

Foundry VTT **v14** or later.

## Installation

In Foundry VTT, go to **Add-on Modules → Install Module** and paste the manifest
URL:

```
https://github.com/xFeirefizx/soundbrett/releases/latest/download/module.json
```

Then enable **Soundbrett** in your world's module settings.

## Usage

1. As GM, open the **Playlists** sidebar — Soundbrett adds a button there that
   opens the soundboard window.
2. In the module settings, set **Soundbrett Folder Path** to the folder that holds
   your audio files (subfolders become categories).
3. Click a tile to play a sound; use the controls under "Active Playback" to
   pause, loop, stop or adjust volume. Players hear whatever their routing allows.

Only GMs can open and operate the soundboard; players react passively to the
GM's actions.

## Configuration

• **Soundbrett Folder Path** (world) — the folder scanned for audio files.
  - **Theme** (world) — `neutral` (default), `arcane`, or `wfrp` (shown only when
    the wfrp4e system is active).

## Localization

English (the default language) and German are included. Contributions of further
languages are welcome.

## License

[MIT](LICENSE) © Feirefiz