From df4e6bbd0f256b8bf1d9ba0941f69dd1faf3a200 Mon Sep 17 00:00:00 2001 From: Igor Katson Date: Mon, 26 Aug 2024 14:29:33 +0100 Subject: [PATCH] update README --- README.md | 34 +++++++++++++++++++++++++++------- 1 file changed, 27 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 4c1ccab..c6d44cc 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,23 @@ Download it in [Releases](https://github.com/ikatson/rqbit/releases) for OSX and Rqbit desktop +## Streaming support + +rqbit can stream torrent files and smartly block the stream until the pieces are available. The pieces getting streamed are prioritized. All of this allows you to seek and live stream videos for example. + +You can also stream to e.g. VLC or other players with HTTP URLs. Supports seeking too (through various range headers). +The streaming URLs look like http://IP:3030/torrents//stream/ + +## Integrated UPnP Media Server + +rqbit can advertise managed torrents to LAN, e.g. your TVs and stream torrents there (without transcoding). Seeking to arbitrary points in the videos is supported too. + +Usage from CLI + +``` +rqbit --upnp-server-hostname server start ... +``` + ## Performance Anecdotally from a few reports, rqbit is faster than other clients they've tried, at least with their default settings. @@ -57,6 +74,10 @@ If you have rust toolchain installed, this should work: cargo install rqbit ``` +## Docker + +Docker images are published at [ikatson/rqbit](https://hub.docker.com/r/ikatson/rqbit) + ## Build Just a regular Rust binary build process. @@ -99,13 +120,10 @@ Use a regex here to select files by their names. - Pausing / unpausing / deleting (with files or not) APIs - Stateful server - Web UI - -### Bugs, missing features and other caveats - -PRs are very welcome. - -- Only supports BitTorrent V1 over TCP -- As this was created for personal needs, and for educational purposes, documentation, commit message quality etc. leave a lot to be desired. +- Streaming, with seeking +- UPNP port forwarding to your router +- UPNP Media Server +- Fastresume (no rehashing) ## HTTP API @@ -165,6 +183,8 @@ Supported query parameters, all optional: - crates/sha1w - wrappers around sha1 libraries - crates/peer_binary_protocol - the protocol to talk to peers - crates/dht - Distributed Hash Table implementation +- crates/upnp - upnp port forwarding +- crates/upnp_serve - upnp MediaServer - desktop - desktop app built with [Tauri](https://tauri.app/) ## Motivation