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.
--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.