Simple and powerful tool for streaming torrents.

Introduction

TorrServer is a program that allows users to view torrents online without the need for preliminary file downloading. The core functionality of TorrServer includes caching torrents and subsequent data transfer via the HTTP protocol, allowing the cache size to be adjusted according to the system parameters and the user's internet connection speed.

AI Documentation

Features

• Caching
• Streaming
• Local and Remote Server
• Viewing torrents on various devices
• Integration with other apps through API
• Torznab search (Jackett, Prowlarr, and similar indexer managers)
• Cross-browser modern web interface
• Optional DLNA server
• Optional GStreamer HLS remuxing and transcoding (-gst builds from release 141.10)
• Native MCP server for AI agents (OpenClaw, Hermes, and other MCP clients)
• External subtitles (SRT/ASS/SSA/VTT to WebVTT) for web players and external players

Getting Started

Installation

Download the application for the required platform in the releases page. After installation, open the link http://127.0.0.1:8090 in the browser. iOS is shipped as TorrServer-ios-TorrServerKit.xcframework.zip for embedding in a host app (see Build → iOS).

Standard binaries are named TorrServer-<platform>-<arch> (for example, TorrServer-linux-amd64). From release 141.10, optional GStreamer (gst) builds are named TorrServer-gst-<platform>-<arch>. Supported gst targets are Windows amd64, Linux amd64/arm64, and macOS amd64/arm64. The install scripts below can install either variant when the matching release asset is available.

Windows

Run TorrServer-windows-amd64.exe.

Linux

Interactive install (download first — preferred):

curl -fsSL https://raw.githubusercontent.com/YouROK/TorrServer/master/installTorrServerLinux.sh -o installTorrServerLinux.sh && chmod 755 installTorrServerLinux.sh && sudo bash ./installTorrServerLinux.sh

Other interactive one-liners (avoid curl | sudo bash, which hangs on modern sudo with use_pty):

sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/YouROK/TorrServer/master/installTorrServerLinux.sh)"

sudo bash <(curl -fsSL https://raw.githubusercontent.com/YouROK/TorrServer/master/installTorrServerLinux.sh)

Non-interactive pipe is fine when there are no prompts:

curl -fsSL https://raw.githubusercontent.com/YouROK/TorrServer/master/installTorrServerLinux.sh | sudo bash -s -- --install --silent

The script supports interactive and non-interactive installation, configuration, updates, and removal. When running the script interactively, you can:

• Install/Update: Choose to install or update TorrServer
• GStreamer build: For releases 141.10+ on amd64/arm64, choose the gst build with transcoding support (or pass --gst)
• Reconfigure: If TorrServer is already installed, you'll be prompted to reconfigure settings (port, auth, read-only mode, logging, BBR)
• Uninstall: Type Delete (or Удалить in Russian) to uninstall TorrServer

Command-line examples:

• Install a specific version:

bash sudo bash ./installTorrServerLinux.sh --install 135 --silent

• Update to latest version:

bash sudo bash ./installTorrServerLinux.sh --update --silent

• Install GStreamer build (141.10+):

bash sudo bash ./installTorrServerLinux.sh --install --gst sudo bash ./installTorrServerLinux.sh --update --gst --silent

• Reconfigure settings interactively:

bash sudo bash ./installTorrServerLinux.sh --reconfigure

• Check for updates:

bash sudo bash ./installTorrServerLinux.sh --check

• Downgrade to a specific version:

bash sudo bash ./installTorrServerLinux.sh --down 135

• Remove/uninstall:

bash sudo bash ./installTorrServerLinux.sh --remove --silent

• Change the systemd service user:

bash sudo bash ./installTorrServerLinux.sh --change-user root --silent

All available commands:

• --install [VERSION] - Install latest or specific version
• --update - Update to latest version
• --reconfigure - Reconfigure TorrServer settings (port, auth, read-only mode, logging, BBR)
• --check - Check for updates (version info only)
• --down VERSION - Downgrade to specific version
• --remove - Uninstall TorrServer
• --change-user USER - Change service user (root|torrserver)
• --gst - Install GStreamer build with transcoding support (141.10+, amd64/arm64 only)
• --root - Run service as root user
• --silent - Non-interactive mode with defaults
• --help - Show help message

macOS

Run in Terminal.app

curl -s https://raw.githubusercontent.com/YouROK/TorrServer/master/installTorrServerMac.sh -o installTorrServerMac.sh && chmod 755 installTorrServerMac.sh && bash ./installTorrServerMac.sh

The macOS install script supports the same commands as the Linux script, including --install, --update, --remove, --reconfigure, and --gst for the GStreamer build (141.10+).

Command-line examples:

• Install latest version:

bash bash ./installTorrServerMac.sh --install

• Install GStreamer build:

bash bash ./installTorrServerMac.sh --install --gst

• Update silently:

bash bash ./installTorrServerMac.sh --update --silent

Alternative install script for Intel Macs: https://github.com/dancheskus/TorrServerMacInstaller

IOCage Plugin (Unofficial)

On FreeBSD (TrueNAS/FreeNAS) you can use this plugin: https://github.com/filka96/iocage-plugin-TorrServer

NAS Systems (Unofficial)

• Several releases are available through this link: https://github.com/vladlenas
• Synology NAS packages repo source: https://grigi.lt

Server args

• --port PORT, -p PORT - web server port (default 8090)
• --ip IP, -i IP - web server bind addr (repeatable; default empty binds to all interfaces)
• --ssl - enables HTTPS for web server
• --sslport PORT - web server https port (default 8091). If not set, will be taken from db (if stored previously) or the default will be used.
• --sslcert PATH - path to SSL cert file. If not set, will be taken from db (if stored previously) or default self-signed certificate/key will be generated. Replacing the cert/key files (e.g. a certbot renewal) takes effect without a restart. An invalid user-supplied cert stops startup instead of being replaced.
• --sslkey PATH - path to SSL key file. If not set, will be taken from db (if stored previously) or default self-signed certificate/key will be generated.
• --force-https - with --ssl, the HTTP listener (--port) answers every request with 307 Temporary Redirect to the same path on HTTPS (--sslport). Requires --ssl (startup fails if --force-https is set without --ssl). Default is off. Media players and TVs usually can't use a self-signed certificate, see HTTPS.
• --http-media - with --force-https, keep serving media URLs (/stream, /play, /playlist, /playlistall, which DLNA also uses, and GStreamer HLS under /gst/<hash>/) over plain HTTP for players that can't use HTTPS; everything else still redirects. Stream URLs and Basic auth credentials then travel unencrypted, so only use it on a trusted network and never expose the HTTP port to the internet. Requires --force-https.

• --https-only - with --ssl, don't open the plain HTTP port (--port) at all: the UI, API, media, DLNA links and Bonjour all use HTTPS on --sslport. Unlike --force-https, clients using the usual http://host:<port> address can't send credentials or requests over plain HTTP before being redirected. Use it with a trusted certificate, see HTTPS; with the self-signed one, players and TVs won't play. Requires --ssl; can't be combined with --http-media.

• --path PATH, -d PATH - database and config dir path

• --logpath LOGPATH, -l LOGPATH - server log file path
• --weblogpath WEBLOGPATH, -w WEBLOGPATH - web access log file path
• --rdb, -r - start in read-only DB mode
• --httpauth, -a - enable HTTP Auth on all requests
• --dontkill, -k - don't kill server on signal
• --ui, -u - open torrserver page in browser
• --torrentsdir TORRENTSDIR, -t TORRENTSDIR - autoload torrents from dir
• --torrentaddr TORRENTADDR - Torrent client address (format [IP]:PORT, ex. :32000, 127.0.0.1:32768 etc.)
• --pubipv4 PUBIPV4, -4 PUBIPV4 - set public IPv4 addr
• --pubipv6 PUBIPV6, -6 PUBIPV6 - set public IPv6 addr
• --searchwa, -s - allow search without authentication
• --maxsize MAXSIZE, -m MAXSIZE - max allowed stream size (in Bytes)
• --tgtoken TGTOKEN, -T TGTOKEN - Telegram bot token
• --fusepath FUSEPATH, -f FUSEPATH - FUSE mount path
• --webdav - enable WebDAV
• --proxyurl PROXYURL - set proxy URL for BitTorrent traffic (HTTP, SOCKS4, SOCKS5, SOCKS5H), example: socks5h://user:password@example.com:2080
• --proxymode PROXYMODE - set proxy mode: "tracker" (only HTTP trackers, def