Skip to content

Presets

Jump to bottom
Scr0ols edited this page Jun 4, 2026 · 4 revisions

Presets

A preset is a named collection of volume overrides. When a preset is active, its values take priority over your base config for the sounds it defines.

Multiple presets can be active at the same time. If two active presets both define a volume for the same sound, the one with the bigger deviation from 100% wins (i.e. silence always beats a small reduction).

Opening the Presets screen

From the main screen, click Presets (top bar) to open the sidebar, then click Manage at the bottom of the sidebar. Alternatively, the Presets screen can be opened directly from the button in the top bar if the sidebar is already open.

The Presets screen

The left side of the screen is a list of all your presets. Each row shows:

  • An ON/OFF badge — click to toggle the preset active/inactive
  • The preset name
  • The assigned keyboard shortcut (if any), shown as e.g. [Ctrl+Alt+R]
  • A star button — marks/unmarks the preset as a favorite (appears in the sidebar on the main screen)

Click a preset row to open its detail panel on the right side.

Creating a preset

Click New Preset at the bottom of the Presets screen. Enter a name and confirm.

The new preset is created with a copy of all entries in your base config that differ from 100%. If your base config has no modified sounds, the preset starts empty.

Detail panel tabs

Selecting a preset opens a panel on the right with the following tabs:

Color

Pick one of the 18 preset colours, or select Custom to enter a hex value (RRGGBB format). The chosen colour is used as an accent in the preset list and sidebar.

Rename

Enter a new name for the preset and click Save name.

Shortcut

Assign a keyboard shortcut to toggle this preset without opening the UI. See Preset Shortcuts for details.

Edit Sounds

Opens a full sound list scoped to this preset. Each slider here modifies the preset's volume override for that sound, independently from the base config.

  • Setting a slider to 100% removes the override for that sound from the preset (the base config value will apply instead)
  • Setting a slider to 0% adds a silent override
  • The list has its own Category/Object filters, search bar, Simple/Detail view toggle, and mute button — they work the same as the main screen

Import from config (footer button): copies all sounds and blocks with volume ≠ 100% from your base config into this preset. Useful to "snapshot" your current base config as a preset.

Delete

Deletes the preset. A confirmation dialog is shown. This action cannot be undone.

Volume resolution

When a preset is active, its overrides are applied on top of the base config. The full priority order is:

  1. Volatile mute layer (mute button on the main screen or in the preset editor) — takes absolute priority, not saved to disk
  2. Active presets — if multiple active presets define the same sound, the one with the biggest deviation from 100% wins
  3. Base config (soundtweaks.json / soundtweaks_blocks.json)
  4. Default — 100%, no change

Favorites sidebar

Presets marked as favorites (star in the preset list) appear in the collapsible sidebar on the main screen. Each entry shows the preset name and whether it's ON or OFF. Clicking an entry toggles it. The sidebar is opened/closed with the Presets button in the main screen's top bar.

Preset state persistence

  • Active/inactive state is saved to soundtweaks_presets.json and persists across game restarts
  • Favorite order is saved in the order you added them
  • If you rename or delete a preset, references in the favorites and active lists are updated automatically

Clone this wiki locally