• Add up to 16 sections, each with its own start, end, crossfade time, and repeat count.
• Choose what happens after a section: skip to the next, keep playing, or fade out.
• Skip the intro and fade straight into the first loop section.
• Adjust sections on a color-coded timeline and see where crossfades overlap.
• Preview a whole loop or just the join. The preview starts at the sound's saved volume.
• Use Currently Playing to break a loop, jump to the previous or next section, or turn loops off.
• Section controls still work between loops and after you press Break.
• Finished loops are cleared so they no longer appear as active in the API.

• Equal-power blending helps keep the change in volume smooth.
• Use the playlist's fade-out time or set a separate duration.
• Fade curves control how the volume rises and falls.
• Crossfades work when tracks advance on their own or you skip manually, and stay in sync for connected players.

• Static: use the same pause every time.
• Random: choose a pause between your minimum and maximum.
• Available in Sequential, Shuffle, and Simultaneous playback.

Choose Soundscape from the playlist's playback-mode picker. It appears alongside Soundboard, Sequential, Shuffle, and Simultaneous.

• Background tracks (beds): loop continuously. Start them together with Play All or individually.
• Occasional sounds (procedurals): use Uniform Random, Fixed Cadence, or Natural timing. Natural timing favors delays near the middle of your range.
• First sound: wait for the normal timing, stagger the first sounds, or play them immediately.
• Overlapping sounds: set a limit, called the polyphony cap. Independent, Linear, and Soft options control how play chances respond as the mix gets busier.
• Groups: give related sounds a shared limit and a cooldown after a sound finishes.
• Player sync: players hear the GM's chosen sounds with the same timing, stereo position, variations, and fades. Players can switch to their own random timing; background tracks and playlist controls still stay synced.
• Preview: listen to the full mix from the playlist or try one sound from its configuration sheet. Only you hear previews, and they don't change live playback.
• Individual controls: play or stop any sound. The playlist stops when its last sound ends.
• Procedural Roster: see each sound's timing, first-play behavior, play chance, and stereo position in one table.
• Fire Now: the GM can click the lightning-bolt button to trigger a sound. During live playback, players hear it too. It skips the group cooldown for testing but still respects overlap limits.

• See the playlist name and current track together.
• Control repeat, silence, crossfade, loops, playback mode, previous/next, pause/resume, and Stop.
• Adjust track and playlist volume with separate sliders.
• See fade-in and fade-out sections marked in gray on the progress bar.
• Keep loop controls available between sections and after Break.
• Expand Soundscape groups, see how many sounds are playing, or stop a whole group.
• Scroll within the panel while keeping the playlist list within reach.
• Keep your place in the playlist list when a track changes.

• Shuffle: choose Foundry Default, Exhaustive, Weighted Random, or Round-Robin.
• Fade-in: choose Logarithmic, Linear, S-Curve, or Steep in the world settings.
• Fade-out: control how the volume falls as a sound ends.
• Volume normalization: set a target for each playlist and exclude individual sounds when needed.
• Playlist looping: repeat the playlist with silence gaps or crossfades still in place.

Open Configure Settings > The Sound of Silence > Configure Playback Controller as a full GM.

• Automatic — prefer full GM gives connected full GMs priority over assistants. Accounts with the same role use a stable selection order.
• Choose a Preferred Playback Controller to delegate automatic playback to a particular GM or assistant. Offline accounts remain available in the list.
• Use Excluded Playback Controllers to keep bridge or automation accounts from running SoS automation. An account cannot be preferred and excluded at the same time.

Changes apply during playback without a reload. If the preferred account is unavailable, another eligible full GM takes over, followed by an assistant. The preferred account takes over again when it returns. With no eligible controller, local playback continues and SoS waits to author new automatic transitions.

These settings do not change anyone's manual playback permissions. Controller selection and handoff details appear only when Enable Debug Logging is on.

If you're tracking down a playback problem, Trace Currently Playing Timers adds timing details to the logs across clients.

GMs can compare what's happening on their own client and connected players' clients:

game.modules.get('the-sound-of-silence').api.requestClientDiagnostics()

After about three seconds, a dialog shows volume, fades, audio readiness, and playback timing for each client. Red highlights possible problems; amber marks active fades.

To update old loop setups, open Configure Settings → The Sound of Silence → Migrate Legacy Internal Loops. This permanently converts older loop settings to the current segment format after you confirm. Back up your world first and stop all playlists. Existing segment-based loops are left alone.

Warning: If the GM controls playback, setting Music Volume to exactly 0 and switching away from the tab can stall the audio clock. Keep it at 0.01, or mute the browser tab or app instead.

For the Foundry MCP Bridge, turn on Enable Debug Logging and Enable MCP Diagnostics, then use its module action tool. These tools are for GM troubleshooting and testing; leave MCP Diagnostics off during normal play. For example:

call-module-debug-action({
  moduleId: "the-sound-of-silence",
  action: "getStatus",
  args: {}
})

The built-in inspection tools check settings, assets, playback, and connected clients. They are GM-only, off by default, and do not create world documents. The available actions under api.diagnostics.actions are getStatus, validateSettings, validateAssets, collectClientDiagnostics, runSmokeTests, openWindow, parseText, validateText, and refreshClient.

• Status: getStatus shows which permissions and settings are enabled, along with audio readiness. Click inside each game client to unlock audio before testing playback.
• Client reports: use collectClientDiagnostics to compare clients. Add playlistIds to focus on particular playlists.
• Refresh: refreshClient needs confirmRefresh: true. Use scope: "client" for the current client or scope: "world" for all connected clients. World refresh also requires permission to change world settings. The bridge's reload-foundry-client tool is also available for a full reload.

Automated playback tests belong in a dedicated test world. They require Enable MCP Diagnostics and confirmMutation: true, and use short test tones to check fades, shuffle, loops, silence, soundscapes, and player sync.

• Use runAutomation and cleanupFixtures, or the specific actions controlPlayback, runPlaybackAutomation, runClientSyncAutomation, and cleanupPlaybackFixtures.
• Multiplayer tests normally need at least one connected player. Missing client responses or missing playback on an audio-ready client fail the check. Locked audio makes playback checks inconclusive.
• Cleanup removes only marked SoS test documents whose names start with SoS MCP Test -. Supply runId to limit cleanup to one test run.

Segment 1  00:00–01:30   Intro      loop 1×, skip to next
Segment 2  01:30–03:00   Phase 1    loop ∞
Segment 3  03:00–04:45   Phase 2    loop ∞
Segment 4  04:45–06:00   Victory    loop 1×, play through

The intro plays once, then Phase 1 loops. Press Break when the boss enters Phase 2. Press it again when the boss falls, and the victory section plays once before the track ends.

Module ID: monks-sound-enhancements · Can be used alongside SoS, with some overlap.

SoS takes over: the Currently Playing panel, playlist settings, and sound-effect volume slider.

Features you can keep: actor and token sounds, @Sound[] links, combat-turn sounds, dragging sounds between playlists, hotbar macros, playlist tooltips, and hiding names or playlists.

Module ID: playlistenchantment · Can be used alongside SoS, with some overlap.

SoS takes over: the Currently Playing panel, volume normalization, fades, playlist looping, and the controls to play, stop, or skip all playlists.

Features you can keep: dragging files in to upload audio, prehear previews, hotbar macros, and the hotbar hover popup.

Warning: Turn off Enchantment's alwaysFade setting to avoid conflicting fades. SoS includes a guard for it, but disabling it is the simplest way to avoid overlap.

SoS replaces PARTS.playing during the ready hook. It uses sos-sound-partial.hbs and sos-soundscape-group.hbs to display sound rows.

Foundry's selectors (.sound[data-sound-uuid], .current, .duration, .pause) remain available through hidden elements for compatibility. SoS styles use the --sos-* prefix, and buttons use data-sos-action. Scrolling over a volume control adjusts that control without scrolling the panel.

api.crossfadeToNext(playlist, fromSound)
api.startLoop(sound) / stopLoop(sound, options) / breakLoop(sound)
api.playSoundWithFadeIn(sound, overrideFadeInMs)
api.stopSoundWithFadeOut(sound, overrideFadeOutMs)
api.fade(sound, targetVolume, durationMs)
api.crossfade(soundOut, soundIn, durationMs)

api.getPlaylistConfig(playlist) / updatePlaylistConfig(playlist, updates)
api.getLoopConfig(sound)         / updateLoopConfig(sound, loopConfig)
api.getPlaybackMode(playlist)

api.isLooping(sound)
api.isCrossfadeScheduled(playlist)
api.isSilenceActive(playlist)
api.getCurrentLoopSegment(sound)
api.getAllLoopingSounds()
api.getActivePlaylists()

api.enableFeature(playlist, feature)  / disableFeature(playlist, feature)

api.requestClientDiagnostics()   // GM-only multi-client snapshot
api.inspectPlaylist(playlist) / inspectAll()
api.getMetrics() / resetMetrics()

api.findSounds(name)
api.toSeconds("01:30") / formatTime(seconds, showMs)
api.cleanup(playlist, options)

the-sound-of-silence.crossfadeStart      / crossfadeComplete
the-sound-of-silence.loopStart           / loopIteration / loopEnd
the-sound-of-silence.silenceStart        / silenceEnd