← Work
OpenStream
Download unprotected video streams from a built-in browser, on Mac.
- Design and development
- Personal open-source project (MIT licence).
- Released
The problem
Saving a video served over HLS or DASH means chaining several command-line tools, and the pages that host it are full of ads and redirects.
Constraints
- Native macOS app, installable with one command.
- No DRM circumvention (Widevine, FairPlay, PlayReady): only unencrypted streams are supported.
- FFmpeg is used as an external binary, without linking its libraries.
The solution
A SwiftUI app with a built-in browser that blocks pop-ups, ads and alerts, detects the page’s streams and assembles them into MP4. Alongside it, openstream-cli exposes the same features as JSON so an agent (chat, cron, bot) can detect, download and follow new episodes.
What was built
- HLS, MPEG-DASH and progressive MP4 detection.
- Built-in browser that blocks pop-ups and redirects.
- Favourites, seasons, digest of new episodes.
- Command-line interface for agents, with a documented contract (JSON and exit codes).
- Install script and GitHub releases with bundled FFmpeg.
Results
Version 0.1.18 is released on GitHub. The app is not yet notarised by Apple.
What it shows
A polished native application with clear, deliberate limits, and a command-line interface designed to be driven by an agent rather than by a person.