btfs(1) Mount .torrrent files or magnet links as a local filesystem


btfs [OPTIONS]... metadata mountpoint


ftbfs uses fuse (filesystem in user space) to expose a bittorrent source as a normal directory on your filesystem. It's possible to use the files in the mounted path as ordinary files and standard utilities such as cp, cat and ls will work as expected.

You will also be able to play videos using your video player and seek through a file without having to download the entire contents of the torrent.


Usage: btfs [OPTIONS...] metadata mountpoint

BTFS Options

-v, --version

Show version information.

-h, --help

Displays usage for the tool.

-b, --browse-only

Download metadata only.

-k, --keep

Keep files after unmount.

FUSE Options

-d, -o debug

Enable debug output (implies -f).


Foreground operation.


Disable multi-threaded operation.

-o allow_other

Allow access to other users.

-o allow_root

Allow access to root.

-o auto_unmount

Auto unmount on process termination.

-o nonempty

Allow mounts over non-empty file/dir.

-o default_permissions

Enable permission checking by kernel.

-o fsname=NAME

Set filesystem name.

-o suptype=NAME

Set filesystem type.

-o large_read

Issue large read requests.

-o max_read=N

Set maximum size of read requests.

-o hard_remove

Immediate removal (don't hide files).

-o use_ino

Let filesystem set inode numbers.

-o readdir_ino

Try to fill in d_ino in readdir.

-o direct_io

Use direct I/O.

-o kernel_cache

Cache files in kernel.

-o [no]auto_cache

Enable caching based on modification times (off).

-o umask=M

Set file permissions (octal).

-o uid=N

Set file owner.

-o gid=N

Set file group.

-o entry_timeout=T

Cache timeout for names (1.0s).

-o negative_timeout=T

Cache timeout for deleted names (0.0s).

-o attr_timeout=T

Cache timeout for attributes (1.0s).

-o ac_attr_timeout=T

Auto cache timeout for attributes (attr_timeout)

-o noforget

Never forget cached inodes.

-o remember=T

Remember cached inodes fot T seconds (0s).

-o nopath

Don't supply path if not necessary.

-o intr

Allow requests to be interrupted.

-o intr_signal=NUM

Signal to send on interript (10).

-o modules=M1[:M2...]

Names of modules to push onto filesystem stack.

Module Options


-o from_code=CHARSET

Original encoding of file names (default: UTF-8).

-o to_code=CHARSET

New encoding of the file names (default: UTF-8).


-o subdir=DIR

Prepend this directory to all paths (madatory).

-o [no]rellinks

Transform absolute symlinks to relative.


Mount Debian ISO torrent link on ~/torrent

btfs ~/torrent

Mount Big Buck Bunny demo video magnet link on ~/torrent

btfs '<magnetlink>' ~/torrent


Please file issues on the GitHub bug tracker:


This manual page was written by Jonathan Carter <[email protected]> ftbs was written by Johan Gunnarsson <[email protected]>