Narrator's Jukebox

A premium audio module for Foundry VTT - designed for how real sessions actually feel.

Music. Ambience. Sound effects. Player-ready broadcasts. All in one place, all built around how a GM thinks during play.

Narrator's Jukebox replaces the friction of juggling Spotify tabs, scattered audio modules, and inconsistent mood-setting with a single, polished workspace inside Foundry. Whether you're scoring a tense investigation, layering a tavern scene, or punching in a clutch sound effect at the perfect dramatic beat, the goal is the same: less wrestling with the tool, more time at the table.

What you get

A complete sound suite built around three pillars:

🎵 Music Library
Your curated tracks, organized into folders, playlists, and mood boards. Search, sort, filter, and drag-to-organize like a modern audio app. Each folder gets its own color identity. Smart shuffle. Persistent repeat modes. YouTube and local files coexist seamlessly.

🎚️ Ambience Mixer
Stack up to 8 ambience layers simultaneously with independent volumes. Save and load presets for your favorite scenes - Rainy Tavern, Forest Night, Burning Castle. Every layer is broadcastable to your players in real time.

🎛️ Soundboard
Quick-fire sound effects for the right dramatic moment. Big sampler-style pads, one-click play, persistent loop preferences per cue, and folder organization. Fire it during combat, mid-roleplay, or as a transition.

Plus: GM-to-player broadcast with live connection health, Mini and Micro window modes for tighter screen real estate, mood boards as visual tag shortcuts, session queue, right-click everywhere, and a polished player widget for non-GM users.

What's new in 4.0

Version 4.0 is a complete redesign from the ground up. Every screen has been rebuilt around a Spotify-inspired premium look - dark glass surfaces, cleaner typography, hero artwork using your real library, and a consistent visual language across the whole module.

New systems

• Session Queue - a real interactive queue. Add tracks as "Next" or to "Later," drag to reorder, see what's coming up, and clear it anytime. After your queue plays out, playback returns to whatever was running before.
• Session Health - connection dots for each online player so you can see at a glance who's receiving broadcasts. Click to resync, right-click for a full audio reset on their end.
• Right-click context menus - quick actions for any track, ambience layer, or soundboard cue. Each tab keeps its own color identity.
• Drag-and-drop in the Music Library - drop tracks straight into folders, with multi-select support.
• Master-detail Mood Boards editor - manage all your mood boards in one focused workspace with live preview, gradient presets, and image browsing.

Reimagined window modes

• Mini Mode is now a polished compact cockpit with full library, queue, ambience, and soundboard access.
• Micro Mode is a tiny floating capsule that opens into a full transport rail when you hover or click.
• The Player Widget for non-GM users got a beautiful broadcast panel with live status, music/ambience tabs, and player-side volume control.

Behavior changes worth knowing

• Broadcasting by default - start music, ambience, or soundboard cues, and your players hear them immediately. (You can switch to Preview anytime.)
• The Jukebox window is GM-only. Players use the floating Player Widget for volume control; a new Suggest a Track button lets them submit song requests without ever opening the main app - preventing accidental broadcast interruptions.
• Repeat mode is now a clear three-state toggle (Off / Track / Queue) and persists between sessions.
• Ambience layers loop automatically - beds stay beds.
• Soundboard cue loop is saved per cue - set it once on rain or fire and it stays that way.

A full changelog ships inside the module for the curious.

How it fits your session

• Between scenes - drag a track to the queue, change the mood, broadcast.
• During combat - fire soundboard cues for impacts and crits without breaking the playlist.
• Tavern scene - load an ambience preset, layer crowd + fire + rain.
• Tense roleplay - drop a track via mood board, lower the volume, let it breathe.
• Boss fight - repeat track on, broadcast on, watch the player health dots stay green.

The module is designed so common moves take one click and complex moves take two.

Built for real sessions

Narrator's Jukebox isn't a side project - it's the tool I built for myself first.

I'm a GM with nearly 30 years of storytelling, and every feature in this module exists because I needed it during play. The Session Queue exists because I wanted to line up the next track during a tense roleplay scene without breaking immersion. Session Health exists because I lost too many minutes asking "can you hear this?" The Spotify-inspired UI exists because clean tools feel like part of the craft, not a tax on it.

You'll feel that throughout. The defaults are what a GM actually wants. The interactions follow how you actually move during a session. The polish isn't decoration - it's there so the module disappears and the table stays present.

Compatibility & Requirements

• Foundry VTT v11, v12, v13
• Required dependency: socketlib - auto-installed by Foundry
• Audio support: local files (mp3, ogg, wav, m4a, opus, webm) and YouTube URLs
• Languages: English, Português (Brasil), Deutsch, Español, Français, 日本語, Polski
• Public API for module developers (game.modules.get('narrator-jukebox').api)

About Wand & Widgets

We're Wand & Widgets. We build premium modules for Foundry VTT - ambitious in scope, cinematic in design, and obsessed with UX. Crafted with love, from one storyteller to another. ❤️

If you'd like to support our work, get early access to upcoming modules, and hang out with our community, find us on Patreon at patreon.com/WandAndWidgets.