Plugin Documentation

• Continuous audio playback via HTML5 <audio>
• Play, pause, previous, next controls
• Shuffle and repeat modes
• Scrubber / seek bar with elapsed and total time display
• Mini player — fixed to the viewport bottom; playback continues while scrolling
• Automatic track advance at end of queue
• Deep-link track selection via ?bs_track=<id> URL parameter
• Cast button — cast to Google Cast (Chromecast) or Apple AirPlay directly from the player controls

• Full-width hero card — edge-to-edge within the player container
• Artwork image as card background (blurred, cover-fit)
• Background video — looping video that plays behind the EQ (replaces artwork when set)
• Smooth crossfade between tracks
• Animated gradient overlay with user-configurable colour, opacity, type, and angle
• “Now Playing” status indicator with animated pulse dot
• Large track title with display font; artist name below

• Google Cast (Chromecast) — the Cast button appears automatically in browsers that support the Cast API (Chrome on desktop and Android); listeners can send audio to any Chromecast or Google-enabled speaker on the same network
• Apple AirPlay — on Safari for iOS and macOS the native AirPlay picker appears, allowing listeners to route audio to AirPlay-compatible speakers, Apple TV, or HomePod
• Both controls use the browser’s native casting APIs — no additional app or plugin is required on the listener’s device
• The cast button is displayed in the player controls area and only rendered when the listener’s browser reports cast capability

• Drag-to-reorder in the admin — order reflects live on the player
• Track number, title, artist, duration, like button, and action icons per row
• Accent-colour left bar and highlight on the currently playing track
• EQ animation icon on the active row
• Track icons always visible: 65% opacity on inactive rows, 100% on the current track

• Share button per track with a modal containing a pre-filled link and message
• One-click copy of the shareable URL
• Social share buttons: X/Twitter, Facebook, WhatsApp, Email
• Customisable share message with {title} and {artist} placeholders
• Each track has a deep-link URL: ?bs_track=<id>

• Like button on the now-playing card and per tracklist row
• Session-gated — one like per track per browser session
• Like count displayed on the card with toast notification
• Three heart styles: classic filled ♥, outline ♡, bold red ❤
• Admin popularity table with bar graph, per-track counts, bump controls, and reset buttons

• Download button in the brand bar above the card
• Gated download modal — prompts the listener to support the artist before downloading
• Honesty / honour-system bypass link for returning supporters
• Per-track download file — can differ from the streaming MP3 if needed
• Configurable modal message, button labels, and window width

• Attach a WebVTT (.vtt) or SRT (.srt) file to any track via the media library
• Bandstand parses the cues and displays the active lyric line in real time on the now-playing card
• Enable or disable globally in the Lyrics settings tab

• Band logo upload (PNG with transparency recommended)
• Player title with show/hide toggle
• Accent colour picker — applied to EQ, progress bar, buttons, and highlights
• Display font and body font selectors: theme fonts, Bandstand bundled fonts, or system fonts
• Bundled fonts: Fraunces (serif display) and DM Mono (monospace body)
• Dark-mode design system with CSS custom properties throughout

Settings are organised across five tabs in Bandstand → Settings.