Narrator's Jukebox 3.0.4 - Download (Patreon)

Alright, here it is. The big one.

What's New in 3.0:

Ambience Layer Mixer - Stack up to 8 ambient sounds at once with individual volume controls. Save your favorite combinations as presets and load them with one click.

Player Widget - A compact, draggable widget that appears for players when you hit play. They can finally control their own volume without digging through menus. Comes in Mini and Micro modes.

Multi-Track Selection - Select multiple tracks in your library and add them to playlists at once. Ctrl+Click, Shift+Click, all the shortcuts you'd expect.

Redesigned Player Bar - Full-width, bigger controls, progress bar, and a broadcast/preview indicator so you always know what mode you're in.

Smart Shuffle - No more hearing the same track twice in a row on small playlists.

Public API - Full API for integration with other modules.

Multi-Language Support - English, Portuguese, German, Spanish, French, Japanese, and Polish.

Complete Refactor - Rewrote the entire codebase. 7,000 lines in one file became 35 modular files. Easier to maintain, easier to fix, easier to extend.

Bug Fixes:

Fixed socket not connecting (players couldn't hear music)

Fixed loop button not working

Fixed false "Failed to play" errors on Soundboard

Fixed scroll resetting on Soundboard

Fixed search not working in Soundboard/Ambience tabs

Fixed search bar losing focus while typingv3.0.1 Hotfix (Feb 5)

Fixed edit buttons not working across all libraries (Music, Ambience, and Soundboard). Clicking edit was showing a "Track not found" error instead of opening the edit dialog. Thanks to Frittz for the detailed bug report!v3.02 Hotfix (Feb 10)Fixed: Module breaking character sheets from other game systemsSome users reported that enabling Narrator's Jukebox would prevent PF2e character sheets (and potentially other systems) from opening, with a blockParams[0] is undefined error. This was caused by the module overwriting Foundry's built-in Handlebars helpers (eq, ne, gt, lt). All custom helpers are now properly namespaced to avoid conflicts.

Fixed: Player suggestions not playing after GM approvalWhen a player suggested a YouTube link and the GM approved it, clicking play would throw an "Invalid track" error. The approved track was being saved to the library without its URL and source type, making it unplayable. Suggestions now correctly carry over all track data.

Fixed: Bulk Import from Foundry Data folders not workingUsing the "Foundry Data" source in the Bulk Import dialog would immediately crash with an error. The folder scanning functionality was missing due to the v3.0 modular refactor. It has been reimplemented directly in the dialog. v3.0.4 Hotfix (Feb 11)

Bug Fixes

Fixed broadcast volume: Players no longer hear YouTube tracks at max volume. The GM's volume setting is now correctly synced when broadcasting.

Fixed CSS leaking into Foundry UI: Module styles no longer affect core Foundry elements (e.g., green playlist headers, oversized buttons, broken layouts).

Fixed "Add Ambience" dialog: It was opening twice when clicking the button—now it opens just once.

UI Fixes

Fixed broken styling: Addressed issues in Bulk Import, Add Sound, and Edit Moods dialogs where the dark theme was not being applied.

Fixed "Supported Formats" tooltip: It was displaying as inline text instead of a hover popup in Add Track dialogs.

Fixed section header buttons: "Add Music," "Add Ambience," and "Bulk Import" buttons were overflowing or being cut off.

Improved spacing: Better spacing between section titles and action buttons across all tabs.

---

A quick note about bugs

I'm one person. I test as much as I can, but bugs happen. If you find one, please report it on Discord in the bug-reports channel. I'll get to it as soon as I can.

If something is blocking you from using the module at all, tag @Widget in Discord and I'll get notified immediately. I'll try to push a hotfix as fast as possible.

That said, life happens. Personal stuff happens. I'm committed to making this the best it can be, but I also need your patience and understanding. If you're here, I hope you're in this journey with me. I'll give everything I can to you, but I need your kindness too.

Thank you for being part of this.

---

FINGERS CROSSED, NEW HOTFIX 11/02 - 22:00 IS LIVE.

How to Install

1. Remove your current version of Narrator's Jukebox from your modules folder

2. Download the zip below

3. Extract it into your Foundry modules folder

4. Make sure the extracted folder is named exactly narrator-jukebox

5. Restart Foundry and enable the module

That's it. Enjoy 3.0.4.