ccBitTorrent

A modern, high-performance BitTorrent client.

Installation

# Install UV (if not installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install ccBitTorrent
uv pip install ccbt

Quick Start

Basic Usage

# Launch Terminal Dashboard (Recommended)
bitonic

Enhanced CLI

# Download from torrent file
ccbt download movie.torrent

# Download from magnet link
ccbt magnet "magnet:?xt=urn:btih:..."

```bash
# Interactive mode
btbt interactive

# View dashboard
btbt dashboard

Configuration

it's quicker to use the presets 👇🏻

Presets

• example env: https://ccbittorrent.readthedocs.io/
• example toml: https://ccbittorrent.readthedocs.io/
• presets:

Manual

Create a ccbt.toml file in your working directory or ~/.config/ccbt/:

[network]
max_global_peers = 200
max_peers_per_torrent = 50
pipeline_depth = 16

[disk]
preallocate = "full"
write_batch_kib = 64
use_mmap = true
hash_workers = 4

[strategy]
piece_selection = "rarest_first"
endgame_duplicates = 2

Requirements

• Python 3.8 or higher
• UV package manager (recommended) or pip

License

This project is licensed under the GNU General Public License v2 (GPL-2.0).

Additionally, this project is subject to additional use restrictions under the ccBT RAIL-AMS License.

Important: Both licenses apply to this software. You must comply with all terms and restrictions in both licenses.

Contributing and translations

Contributor setup and hooks are described in the repository docs (for example docs/en/contributing.md). Translation maintenance uses GNU gettext (msgmerge, msgfmt), python -m ccbt.i18n.extract, and the scripts under ccbt/i18n/scripts/ (see ccbt/i18n/scripts/README.md in the source tree). Optional local steps; stricter checks run in CI workflows on the main repository.

Support

• Documentation: https://ccbittorrent.readthedocs.io/
• Issues: https://github.com/ccBittorrent/ccbt/issues
• Discussions: https://github.com/ccBittorrent/ccbt/discussions