Open Source Torrent Streaming

fluxstream,torrents that flow

Explore CLI →
~curl-fsSLhttps://raw.githubusercontent.com/scythe504/fluxstream/main/scripts/install.sh|bash
100%open source & free
DHT/PEXtrackerless peer discovery
<5saverage start latency

Unified Playback

Content Streaming

Fluxstream is a sleek, self-hosted media client for torrent-based libraries. Play Creative Commons open movies, public domain video archives, or your personal legally sourced media collections instantly on-the-fly.

Connect your own self-hosted feeds and personal media indexes, or paste magnet links to stream files directly in a clean, web-based player.

* Note: The actual UI of the self-hosted web client will differ.

fluxstream.app/providers/cc-media/sintel
Streaming: Sintel.2010.1080p.mkvBuffering <3s
Available Streams
Sintel.2010.1080p.mkv
Blender Open Movies650 MB
BigBuckBunny.2008.1080p.mkv
Creative Commons Feed276 MB
TearsOfSteel.2012.720p.mkv
Archive.org Feed543 MB
Magnet: Sintel.2010.480p.mp4Ready to Stream

Inputting a torrent magnet link connects your browser player directly to the peer-to-peer network to start streaming.

Legal Disclaimer & Compliance

Fluxstream is a pure software-only media player and link parsing engine. It does not index, host, distribute, or facilitate access to copyrighted or unlicensed media files. The project does not maintain or verify the legality of third-party media providers. Users are solely responsible for ensuring that all addon configurations link exclusively to legally sourced content in accordance with their respective local laws. Fluxstream disclaims all liability for unauthorized or illegal content accessed via user configurations.

Distribution Architecture

Interactive Swarm Simulator

Test how video seeking works. Click on any block in the buffer map below to seek to that timestamp and watch how the downloader responds.

Simulation Settings

Select Loading Strategy

SEEK TARGETBlock 0 (00:00)
ACTIVE DOWNLOADIdle
DOWNLOAD SPEED3.4 MB/s
PLAYBACK STATE BUFFERING
DHT Peer Connection Map
8 nodes connected
PEER DENSITY: HighAVERAGE PING: 24ms
Buffer Timeline0 / 24 blocks

Supported Environments

System Requirements

Run Fluxstream natively on your desktop client, deploy it instantly using Docker, or compile and run it directly from source.

Platform

Desktop Clients

Natively supported on Windows (Windows 10 and 11), macOS (macOS 12 Monterey and above), and Linux distributions running Kernel 5.0 or later.

Deployment

Docker Engine

Deploy and host a localized streaming node inside a Docker container, with pre-configured network ports and automated storage volume bindings.

Development

Compile from Source

Build the core command-line utility and web interface locally. Requires Go (version 1.22 or higher) and Node.js (version 20 or higher) on the host machine.

$ fluxstream --help

Command Line Reference

Control your local streaming daemon, configure self-hosted media feeds, and query directories directly from the CLI shell.

fluxstream cli guide
v0.4.0
███████╗██╗     ██╗   ██╗██╗  ██╗███████╗████████╗██████╗ ███████╗ █████╗ ███╗   ███╗
██╔════╝██║     ██║   ██║╚██╗██╔╝██╔════╝╚══██╔══╝██╔══██╗██╔════╝██╔══██╗████╗ ████║
███████╗██║     ██║   ██║ ╚███╔╝ ███████╗   ██║   ██████╔╝█████╗  ███████║██╔████╔██║
██╔═══╝╝██║     ██║   ██║ ██╔██╗ ╚════██║   ██║   ██╔══██╗██╔══╝  ██╔══██║██║╚██╔╝██║
██║     ███████╗╚██████╔╝██╔╝ ██╗███████║   ██║   ██║  ██║███████╗██║  ██║██║ ╚═╝ ██║
╚═╝     ╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝
Usage:
  fluxstream [command]

Available Commands:
  help        Help about any command
  setup       Sets up required configs and docker engine (if not installed)
  start       Start the Fluxstream server
  status      Shows the status of the server whether running or not
  stop        Stops the Fluxstream server
  where       Prints the url for the web app

Flags:
  -h, --help      help for fluxstream
  -v, --version   version for fluxstream

Use "fluxstream [command] --help" for more information about a command.

Internal Specs

Beta Phase

Technical Reference

Deep dive into Fluxstream's underlying architecture, core libraries, performance limitations, and open-source licensing.

How it Works?

Fluxstream works by converting incoming BitTorrent streams directly into sequential HTTP media feeds. Instead of downloading files entirely, the core daemon prioritizes downloading the header and beginning segments of video files.

Once the player requests a stream, the engine buffers the initial chunks and feeds them into the player. Unneeded blocks are garbage-collected automatically based on storage quotas.

AGPL-3.0 License

Fluxstream is free software licensed under the GNU Affero General Public License. This ensures the engine remains open-source, and any modifications deployed as network services are shared back with the community.

Read License Spec

Core Tech Stack

GolangStreaming Server
SQLiteConfig & State DB
anacrolix/torrent Engine Core ClientFFmpeg Demuxer & Transcoder
Next.jsWeb App Client
TypeScriptFrontend Safety

Known Limitations (Beta)

  • Magnet link format support only (raw torrent files are not currently parsed).
  • Single file stream mapping (extracts and plays only the primary media file in directories).
  • Single language subtitles (embedded track mapping is supported, selection switches are in development).

Submit Feature Feedback

Fluxstream is expanding dynamically during its beta stages. Want to request support for multi-file directories, custom index feeds, or alternative audio streams?

Request Additions

Deep Dive

Under the Hood

Clarifications on architecture, storage management, privacy, and media playback operations.