← Work
OpenStream icon, a floppy disk

Open source · macOS · Swift

OpenStream

Download unprotected video streams from a built-in browser, on Mac.

Role
Design and development
Context
Personal open-source project (MIT licence).
Status
Released
Technologies
  • Swift
  • SwiftUI
  • FFmpeg
  • CLI

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.