Torrent Streamer

Lightweight torrent streaming server built with Node.js and WebTorrent. Start playback while the torrent downloads (HTTP range supported).

Features

🎯 Core Streaming

• Instant Streaming: Start watching while downloading with WebTorrent
• HTTP Streaming: Direct browser playback with range request support
• DLNA/UPnP Casting: Cast to smart TVs and media devices
• AirPlay Support: Stream to Apple TV and AirPlay devices
• RTP/UDP Multicast: Efficient network streaming with SAP announcements

📚 Media Management

• Library System: Organize your media collection
• Watch History: Track viewing progress with resume functionality
• Bookmarks: Save favorites for quick access
• Metadata Management: Store titles, quality, year, and more
• Smart Filters: Search and filter by status, bookmarks, and quality

🎨 User Interface

• Modern Dashboard: Real-time streaming statistics and device discovery
• Responsive Design: Works on desktop, tablet, and mobile
• Dark/Light Themes: Comfortable viewing in any environment
• Tab Navigation: Organized sections for streaming, protocols, library, and settings

🎯 Advanced Features

• Subtitle Support: Auto-detection with 11 language support (.srt, .vtt, .sub, .ass, .ssa)
• Multi-Protocol Stats: Real-time monitoring of HTTP, DLNA, RTP, and AirPlay streams
• Device Discovery: Automatic detection of DLNA and AirPlay devices
• Session Management: Track active streams and playback state
• Peer Information: Monitor torrent health and download progress

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• FFmpeg (for RTP/UDP streaming)
• PM2 (for process management)

Installation

# Clone the repository
git clone https://github.com/yourusername/torrent-streamer.git
cd torrent-streamer
npm install
npm start

Open http://localhost:8881.

Usage

Web UI

• Open / in a browser, paste a magnet link, press Start.
• Copy the stream URL into a player (VLC: “Open Network Stream…”).

Note: docs/ui-variants/ contains older HTML experiments and is not served by server.js.

API

Start a torrent (replaces any currently-running torrent):

curl -X POST http://localhost:8881/start \
  -H "Content-Type: application/json" \
  -d '{"magnet":"magnet:?xt=urn:btih:..."}'

List files and select a specific file (useful for bundles):

curl http://localhost:8881/files
curl -X POST http://localhost:8881/select -H "Content-Type: application/json" -d '{"index":0}'

Stream the selected file:

• http://localhost:8881/stream

API reference

Method	Endpoint	Description
POST	/start	Start torrent from magnet link (auto-selects a file)
POST	/stop	Stop current torrent
POST	/select	Select file by index
GET	/status	Progress, speeds, peers, selected index
GET	/files	Torrent file list
GET	/stream	Stream selected file (supports Range)
GET	/healthz	Health check

Configuration

• PORT (default 8881)
• HOST (default 0.0.0.0)
• Downloads are stored under ./data/ (gitignored)

Deployment (PM2)

npm install -g pm2
./pm2-control.sh start
./pm2-control.sh logs

Project layout

server.js (API + streaming), public/ (UI), docs/ui-variants/ (not served), ecosystem.config.js + pm2-control.sh (PM2).

Contributing / changes

• Contributing guide: CONTRIBUTING.md
• Release notes: CHANGELOG.md

Legal

You are responsible for complying with local laws and the terms of the content you download/stream.

License

Note: This software is for personal use. Ensure you have the right to download and stream any content.