I built Wavecast, a Hugo theme and module that adds a persistent podcast/radio audio player to any Hugo site. Drop a shortcode into a page and the audio follows you across every page via a sticky footer bar for pause, seek, volume, and speed stay synced bidirectionally between the inline player and footer.
Most Hugo audio solutions embed a one-off player per page. Wavecast’s player survives SPA navigation (Turbolinks-ready), so your listener never loses their place. Play on an episode page, browse the docs, switch languages and the audio never stops.
Features:
- Persistent audio across page navigation with bidirectional inline/footer sync
- Chapter markers with click-to-seek and keyboard shortcuts
- Local files, AzuraCast streams, and iVoox episodes
- iTunes-compatible podcast RSS feed generation
- Light/dark mode with CSS custom properties
- Class-based Chroma syntax highlighting on docs code blocks (Monokai)
- Copy-to-clipboard on all code blocks with Turbolinks/Turbo SPA support
- 8-page bilingual docs (EN + ES) with live example site
- 5 demo programs, 15 demo episodes, including Linux Matter (Linux and open source)
- Security-hardened: CSP, XSS, SSRF protections built in
Demo and docs: Wavecast Radio
GitHub: GitHub - adurrr/wavecast: A Hugo theme and shortcode for podcast/radio audio websites · GitHub