jmtpfs - Man Page
FUSE based filesystem for accessing MTP devices
Examples (TL;DR)
- Mount an MTP device to a directory:
jmtpfs path/to/directory
- Set mount options:
jmtpfs -o allow_other,auto_unmount path/to/directory
- List available MTP devices:
jmtpfs --listDevices
- If multiple devices are present, mount a specific device:
jmtpfs -device=bus_id,device_id path/to/directory
- Unmount MTP device:
fusermount -u path/to/directory
Synopsis
jmtpfs [options] MOUNTPOINT
Description
jmtpfs is a FUSE and libmtp based filesystem for accessing MTP (Media Transfer Protocol) devices. It was specifically designed for exchaning files between Linux (and Mac OS X) systems and newer Android devices that support MTP but not USB Mass Storage.
The goal is to create a well-behaved filesystem, allowing tools like find(1) and rsync(1) to work as expected. MTP file types are set automatically based on file type detection using libmagic(3). Setting the file type is necessary for some Android applications, like Gallery, to be able to find and use the files uploaded to the device.
Usage
For regular use, simply specifying a MOUNTPOINT will have the first available MTP device mounted under it. Mounted devices should be unmounted using
fusermount -u MOUNTPOINT
(see fusermount(1) for more details).
Note: most (if not all) Android phones have to be unlocked when first accessed over MTP; if you get an input/output error on the mountpoint, unlock the phone and retry.
Options
jmtpfs accepts the following options:
- -h
Show summary of options.
- -V, ā--version
Show the program version.
- -l, ā--listDevices
List all available MTP devices.
- -device=<busnum>,<devnum>
Specify the device to mount. If unspecified, the first device found is used.
In addition to these options, all options supported by fuse(8) are available. See jmtpfs -h for more information.
See Also
fuse(8), fusermount(1)
Authors
jmtpfs was written by Jason Ferrara <jason.ferrara@jacquette.com>.
This manual page was written by Apollon Oikonomopoulos <apoikos@debian.org>, for the Debian project (but may be used by others).