Update README
This commit is contained in:
parent
25189ce161
commit
1a5716a734
2 changed files with 21 additions and 20 deletions
40
README.md
40
README.md
|
|
@ -4,7 +4,26 @@
|
||||||
|
|
||||||
# rqbit - bittorrent client in Rust
|
# rqbit - bittorrent client in Rust
|
||||||
|
|
||||||
**rqbit** is a bittorrent client written in Rust.
|
**rqbit** is a bittorrent client and server written in Rust. Has HTTP API and Web UI, and can be used as a library.
|
||||||
|
|
||||||
|
## Usage quick start
|
||||||
|
|
||||||
|
### Optional - start the server
|
||||||
|
|
||||||
|
Assuming you are downloading to ~/Downloads.
|
||||||
|
|
||||||
|
rqbit server start ~/Downloads
|
||||||
|
|
||||||
|
### Download torrents
|
||||||
|
|
||||||
|
Assuming you are downloading to ~/Downloads. If the server is already started, ```-o ~/Downloads``` can be omitted.
|
||||||
|
|
||||||
|
rqbit download -o ~/Downloads 'magnet:?....' [https?://url/to/.torrent] [/path/to/local/file.torrent]
|
||||||
|
|
||||||
|
## Web UI
|
||||||
|
Access with http://localhost:3030/web/
|
||||||
|
|
||||||
|
<img width="995" alt="Screenshot 2023-11-27 at 09 30 10" src="https://github.com/ikatson/rqbit/assets/221386/d9403763-d162-492b-a718-a857ef4dd1e6">
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
|
|
@ -22,20 +41,6 @@ Just a regular Rust binary build process.
|
||||||
|
|
||||||
cargo build --release
|
cargo build --release
|
||||||
|
|
||||||
## Usage quick start
|
|
||||||
|
|
||||||
### Optional - start the server
|
|
||||||
|
|
||||||
Assuming you are downloading to ~/Downloads.
|
|
||||||
|
|
||||||
rqbit server start ~/Downloads
|
|
||||||
|
|
||||||
### Download torrents
|
|
||||||
|
|
||||||
Assuming you are downloading to ~/Downloads. If the server is already started, ```-o ~/Downloads``` can be omitted.
|
|
||||||
|
|
||||||
rqbit download -o ~/Downloads 'magnet:?....' [https?://url/to/.torrent] [/path/to/local/file.torrent]
|
|
||||||
|
|
||||||
## Useful options
|
## Useful options
|
||||||
|
|
||||||
### -v <log-level>
|
### -v <log-level>
|
||||||
|
|
@ -118,11 +123,6 @@ Supported query parameters, all optional:
|
||||||
- output_folder - the folder to download to. If not specified, defaults to the one that rqbit server started with
|
- output_folder - the folder to download to. If not specified, defaults to the one that rqbit server started with
|
||||||
- list_only=true|false - if you want to just list the files in the torrent instead of downloading
|
- list_only=true|false - if you want to just list the files in the torrent instead of downloading
|
||||||
|
|
||||||
## Web UI
|
|
||||||
Access with http://localhost:3030/web/
|
|
||||||
|
|
||||||
<img width="995" alt="Screenshot 2023-11-27 at 09 30 10" src="https://github.com/ikatson/rqbit/assets/221386/d9403763-d162-492b-a718-a857ef4dd1e6">
|
|
||||||
|
|
||||||
## Code organization
|
## Code organization
|
||||||
- crates/rqbit - main binary
|
- crates/rqbit - main binary
|
||||||
- crates/librqbit - main library
|
- crates/librqbit - main library
|
||||||
|
|
|
||||||
1
TODO.md
1
TODO.md
|
|
@ -20,6 +20,7 @@
|
||||||
someday:
|
someday:
|
||||||
- [x] cancellation from the client-side for the lib (i.e. stop the torrent manager)
|
- [x] cancellation from the client-side for the lib (i.e. stop the torrent manager)
|
||||||
|
|
||||||
|
- [ ] favicons for Web UI
|
||||||
|
|
||||||
refactor:
|
refactor:
|
||||||
- [x] where are peers stored
|
- [x] where are peers stored
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue