Ginzzzu’s Music Deck

Ginzzzu’s Music Deck

Ginzzzu’s Music Deck is a compact vertical music dock for Foundry VTT v13+, providing fast and convenient access to playlists and individual tracks.
The module is designed to offer a cleaner, more efficient workflow for managing music during gameplay.

Core Features

🎵 Vertical Dock Interface

• A slim, floating panel on the right side of the screen

• Automatically shifts when the Foundry sidebar opens

• Playlist buttons expand leftward on hover for full titles

• Optional auto-collapse behavior

🔍 Global Search

• Search field filters playlists, tracks, and favorite aliases

• Matching playlists auto-expand for easier navigation

⭐ Favorite Playlists

• Middle-click a playlist to toggle “favorite” status

• Favorite playlists are sorted alphabetically and pinned at the top

• Distinctive golden outline for quick identification

❤️ Favorite Tracks (Virtual Playlist)

• Middle-click a track to add it to the virtual Favorites playlist

• Newly added tracks automatically expand the Favorites section

• Favorite tracks are visually highlighted in their original playlists

• Does not modify original playlist structures

✏ Track Aliases

• Tracks in Favorites can be renamed without affecting the original files

• Aliases are displayed in UI and included in search

• Tooltip shows both alias and original name

🔈 Per-Track Volume Slider

• Right-click any track to open a compact volume slider

• Adjusts real Foundry track volume in real time

• Slider persists while dragging and closes on outside click

🎨 Playlist Color Picker

• Right-click a playlist to select a color from a configurable palette

• Options include:

  • Apply color

  • Remove color

  • Reset all playlist colors

• Palette values fully configurable in module settings

• Supports the “Color Picker” module for advanced color input

🎨 Colored Playlist Grouping

• Playlists with custom colors (applied via the palette) can be grouped above normal playlists

• They remain below Favorites

• Sorted alphabetically inside this group

• Feature can be enabled or disabled in settings

🚫 Playlist Filtering by Prefix

• New setting: “Hide playlists starting with…”

• Any playlist whose name begins with the specified prefix (e.g. !, #, _hidden) will not appear in the Music Deck

• Useful for:

  • Scene-specific playlists

  • GM-only playlists

  • Temporary playlists

• Hidden playlists still remain in Foundry’s native Playlist sidebar

🧭 Layout Customization

• Three new settings allow precise dock placement:

  • Top Offset (px)

  • Bottom Offset (%)

  • Right Offset (px)

• Helps avoid overlap with other UI modules or custom layouts

• Deck now automatically shrinks when few playlists are visible (no more blocking empty space!)

Settings & Customization

• Playlist button width

• Hover expand width

• Auto-collapse other playlists

• Use folder color

• Truncate favorite playlist names

• 8 configurable palette colors

• Group colored playlists 

• Hide playlists by prefix 

• Top/Bottom/Right deck offsets

Compatibility

• Designed for Foundry VTT 13+

• Uses standard playlist APIs — compatible with all sound-related modules

• Works with optional “Color Picker” module

Installation

Install using the module manifest URL: https://raw.githubusercontent.com/Ginzzzu/ginzzzu-music-deck/main/module.json