btfs(1)

btfs1

Mount torrent files or magnet links as a file system

Usage

btfs [options] metadata mountpoint

Overview

btfs allows one to mount any torrent file or a magnet link as a file system. The contents of the files will be downloaded on-demand as they are read by applications.

Options

-v --version

print version

-h --help

print help

-b --browse-only

download metadata only

-k --keep

keep files after unmount

-s --silent

do not create logs

--utp-only

do not use TCP

--data-directory=DIRECTORY

directory in which to put btfs download data. will by default use $XDG_DATA_HOME if defined else use $HOME/btfs, or /tmp/btfs if the latter is unavailable

--min-port=PORT

start of listen port range

--max-port=PORT

end of listen port range

--max-download-rate=RATE

maximum download rate (in kilobytes per second)

--max-upload-rate=RATE

maximum upload rate (in kilobytes per second)

Examples

mounting a torrent file:
btfs video.torrent ~/mnt

mounting a magnet link:
btfs 'magnet:?xt=urn:btih:...' ~/mnt

unmounting:
fusermount -u ~/mnt

Releases

6 releases since Debian 9 (Stretch); the text changed 2 times.

  1. 9–10
  2. 11–13
  3. Arch

--data-directory since Debian 11 (Bullseye); --silent since Arch Linux 2026-11-01; --utp-only since Debian 11 (Bullseye); -s since Arch Linux 2026-11-01.

Bugs

Please report any bugs to https://github.com/johang/btfs.

Authors

BTFS has been written by Johan Gunnarsson <[email protected]>

This man page was written by Donat Kh. <[email protected]>

From btfs 3.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.