Skip to content

Presets

Jump to bottom
Scr0ols edited this page Jun 5, 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 define a volume for the same sound, the one with the bigger deviation from 100% wins — 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. You can also get there directly from the top bar button if the sidebar is already open.

The Presets screen

The left side lists 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 favorite button — marks/unmarks the preset for the sidebar on the main screen

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

Creating a preset

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

The new preset starts 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

Color

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

Rename

Enter a new name 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 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 — the base config value applies 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 — same as the main screen, but with different behavior: here the mute writes to the preset's config. Click once → sets all visible sounds to 0% in the preset JSON. Click again → sets them to 100%, which removes the override (100% means "use base config value").

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

Delete

Deletes the preset. A confirmation dialog is shown. This can't be undone.

Volume resolution

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

  1. Volatile mute layer — the mute button on the main screen. 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 appear in the collapsible sidebar on the main screen. Each entry shows the preset name and its current ON/OFF state. Clicking toggles it. The sidebar is opened and closed with the Presets button in the top bar.

Preset state persistence

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

Clone this wiki locally