Oddysee - HLS Audio Player by Karelle Hofler Oddysee - HLS Audio Player by Karelle Hofler

Oddysee - HLS Audio Player

Karelle Hofler

Karelle Hofler

Most HLS (HTTP Live Streaming) libraries are built video-first, with audio treated as an afterthought. Oddysee flips that — a framework-agnostic core that wraps HLS.js into a simple, audio-focused API, plus a dedicated React hook package for convenience.
I built it after running into the gap directly: I needed authenticated, signed-URL audio streaming (HLS makes content meaningfully harder to rip than a plain file URL, which matters for protecting original audio) and couldn't find a library built for that use case. Oddysee supports custom auth headers configured once and reused across every request, a three-phase deferred seek model to prevent glitching during scrubbing, and session lifecycle handling so the player recovers gracefully from stale or expired streams instead of breaking.
Since launch, it's passed nearly 3,000 combined npm downloads across both packages and received its first outside contributor pull request, which I reviewed and merged — I now maintain an open contributor pipeline with labeled "good first issue" tickets for ongoing development.
Like this project

Posted Jun 27, 2026

Developed Oddysee, a framework-agnostic audio streaming API and React hook.

Likes

0

Views

0

Timeline

Dec 8, 2025 - Ongoing