SSD-friendly FS crawler for the Aquatic BitTorrent tracker, based on librqbit API https://crates.io/crates/aquatic-crawler
Find a file
2025-08-08 18:51:42 +03:00
.github add cargo update 2025-08-02 12:26:07 +03:00
src use assertion for the logic implementation errors 2025-08-08 18:21:38 +03:00
.gitignore initial commit 2025-06-07 12:28:02 +03:00
Cargo.toml require secure chrono version 2025-08-08 04:44:30 +03:00
LICENSE Initial commit 2025-06-06 12:49:40 +03:00
README.md use tip label 2025-08-08 18:51:42 +03:00

aquatic-crawler

Build Dependencies crates.io

SSD-friendly FS crawler for the Aquatic BitTorrent tracker, based on the librqbit API

Note

  • requires PR#233 or the info-hash-api branch implementation
  • compatible with any other --infohash source in hash1hash2... binary format
  • use βtracker for the frontend
  • see the project Wiki for details

Conception

torrent client > aquatic_udp > infohash.bin < aquatic-crawler > * /preload/info-hash.torrent
torrent client               <-----------------------|          * /preload/info-hash/data
               <-------------------------------------|          * /preload/.info-hash/tmp

Install

Tip

You may want to install some system dependencies

  1. git clone https://github.com/YGGverse/aquatic-crawler.git && cd aquatic-crawler
  2. cargo build --release
  3. sudo install target/release/aquatic-crawler /usr/local/bin/aquatic-crawler

Usage

Tip

  • prepend RUST_LOG=debug to debug, append NO_COLOR=1 to disable fmt
  • use --preload-* arguments group to avoid preloading everything (by default)
  • as the crawler is running in a single thread, use --peer-read-write-timeout (in seconds) to skip long-lasting connections. Content preload will be restored in the next crawl cycle after resolving other torrents from active peers in the queue.
aquatic-crawler --infohash /path/to/info-hash-ipv4.bin\
                --infohash /path/to/info-hash-ipv6.bin\
                --infohash /path/to/another-source.bin\
                --tracker  udp://host1:port\
                --tracker  udp://host2:port\
                --preload  /path/to/directory

Options

aquatic-crawler --help