# johang/btfs

A bittorrent filesystem based on FUSE.

Repository: https://github.com/johang/btfs
Canonical: https://ross.abutalabs.com/products/btfs
Language: C++
License: GPL-3.0
License Family: copyleft
Topics: fuse, libtorrent, filesystem, bittorrent, osxfuse, btfs, ubuntu, linux, debian, macos, brew
Last push: 2026-08-25T18:12:06+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 4056, "days_push": 8, "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 3950, forks 146 (observed 2026-08-28T04:08:30.403257+00:00)

## What it is
BTFS is a FUSE-based filesystem that mounts .torrent files or magnet links as read-only directories. File contents are downloaded on demand as they are read, so standard tools and media players work without modification.

## Use cases
- stream a video from a torrent with vlc without downloading it fully
- mount a magnet link as a directory and browse its files
- extract a single file from a large torrent with cp
- list torrent contents with ls before deciding to download
- preview files inside a torrent on-demand

## When to choose
- you want on-demand access to torrent contents without downloading everything
- you want to use normal Unix tools and media players on torrent data
- you need a lightweight command-line torrent mounting tool on Linux or macOS

## When to avoid
- you need a full-featured torrent client with seeding and queue management
- you are on Windows or another platform without FUSE support
- you need write access to mounted torrent data

## Facets
- artifact type: cli-tool
- maturity: active
- function: file-system, cli
- domain: files, developer-tools
- platform: cli
- tags: bittorrent, fuse, on-demand-download, streaming, magnet-links, command-line, linux, macos

## Member repositories
- johang/btfs (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:30.403257+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-29T18:24:32.498540+00:00, confidence not recorded.
  - readme: https://github.com/johang/btfs (fetched 2026-08-28T04:08:30.403257+00:00, sha 3d70c3793396)
- Data as of 2026-08-30T08:39:29.467469+00:00.