SDL - Stream Downloader CLI

sdl is a simple command-line tool written in Go for downloading HTTP Live Streaming (HLS) video streams.

Installation

go install ./...

This installs the sdl binary into your GOBIN (defaults to ~/go/bin). Ensure this directory is on your PATH.

Usage

sdl https://example.com/path/to/playlist.m3u8

The downloader automatically picks the highest-bandwidth variant when given a master playlist, downloads the segments, and transmuxes them into an .mp4 container. You can override the output filename:

sdl -o myvideo.mp4 https://example.com/path/to/playlist.m3u8

Features

Follows HTTP redirects (up to 5 hops)
Supports HLS master playlists (auto-select highest bandwidth variant)
Produces .mp4 output via ffmpeg
Respects basic HTTP timeouts (30 seconds per request)

Limitations

Requires ffmpeg in PATH for transmuxing
No retry logic beyond standard HTTP redirects

Development

go build ./...
go test ./...

Contributions and issue reports are welcome!

1.1 KiB Raw Blame History