# atomashpolskiy/bt

BitTorrent library and client with DHT, magnet links, encryption and more

Repository: https://github.com/atomashpolskiy/bt
Canonical: https://ross.abutalabs.com/products/atomashpolskiy-bt
Homepage: https://atomashpolskiy.github.io/bt/
Language: Java
License: Apache-2.0
License Family: permissive
Topics: bittorrent, p2p, dht, torrent-client, torrent, magnet, magnet-link
Last push: 2026-02-21T22:44:33+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 68, release rhythm 35, longevity 100
- inputs: {"age_days": 3762, "days_push": 193, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2470, forks 386 (observed 2026-08-28T04:06:54.670345+00:00)

## What it is
Bt is a full-featured BitTorrent library and client written in Java 8, supporting DHT, magnet links, peer exchange, message stream encryption, private trackers, and the extended protocol. It is published on Maven Central and includes a CLI demo client alongside an embeddable, highly customizable core library.

## Use cases
- embed bittorrent downloading in a java application
- download torrents via magnet links without a .torrent file
- build a custom torrent client with dht and peer exchange
- create .torrent metainfo files programmatically
- download only selected files from a multi-file torrent
- add p2p file transfer to a jvm backend service

## When to choose
- you need a bittorrent implementation on the JVM with broad BEP coverage
- you want an embeddable, customizable torrent engine rather than a GUI client
- you need DHT, magnet links, MSE encryption, and UDP tracker support out of the box

## When to avoid
- you need a polished end-user GUI torrent client like qBittorrent
- your project is not on the JVM
- you need WebTorrent or browser-based peer support

## Facets
- artifact type: library
- maturity: active
- function: p2p, networking, cli, parser
- domain: files, developer-tools, cross-platform
- platform: jvm, cross-platform, cli
- tags: bittorrent, torrent-client, dht, magnet-links, peer-exchange, message-stream-encryption, java-8

## Member repositories
- atomashpolskiy/bt (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:54.670345+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:29:09.354336+00:00, confidence not recorded.
  - readme: https://github.com/atomashpolskiy/bt (fetched 2026-08-28T04:06:54.670345+00:00, sha 1c783997274f)
  - homepage: https://atomashpolskiy.github.io/bt/ (fetched 2026-08-29T10:10:32.980870+00:00, sha c6d9a96f4f42)
- Data as of 2026-08-30T08:39:29.467469+00:00.