MTPfs

This page contains changes which are not marked for translation.

Resources

MTPfs is a FUSE-based filesystem providing access to MTP devices. Typically these devices are Android phones or similar mobile devices.

Installation

Kernel

See the MTP meta article or the FUSE article for instructions on enabling FUSE support in the Linux kernel.

USE flags

USE flags for sys-fs/mtpfs A FUSE filesystem providing access to MTP devices

`debug`	Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces
`mad`	Enable handling of MP3's metadata

Data provided by the Gentoo Package Database · Last update: 2021-09-30 22:20 More information about USE flags

sys-fs/mtpfs depends on media-libs/libmtp. It turned out^[1] that at least version 1.1.8^[2] is needed to make it work.^[3].

Emerge

Install sys-fs/mtpfs:

root #emerge --ask sys-fs/mtpfs

Configuration

Android devices

Android devices will need to be put into MTP mode. The way this is done changes slightly based on the version of Android running. On more modern versions, slide down the top of the screen once to show notifications. There should be a notification from the Android System indicating something to the effect of "USB debugging connected." Below this notification is a second notification. Tap the second notification, then change the setting from "Charge only" to "USB for file transfer."

Files

Modify /etc/fuse.conf:

FILE /etc/fuse.conf

user_allow_other

User privileges

Appropriate user(s) need to be in the plugdev group:

root #gpasswd -a <USER_NAME> plugdev

Usage

Mount:

user $mkdir ~/AndroidDevice

user $mtpfs ~/AndroidDevice

Unable to open ~/.mtpz-data for reading, MTPZ disabled.
Device 0 (VID=0bb4 and PID=0c93) is a HTC EVO 4G LTE/One V (ID1).
Android device detected, assigning default bug flags

Note
Be patient, as this can take several minutes. Upon successful mount, mtpfs will background itself.

Unmount:

user $fusermount -u ~/AndroidDevice

References

↑ http://forums.gentoo.org/viewtopic-p-7633366.html#7633366
↑ bug #527086

↑ libmtp will scan the usb bus and send messages to the log for all attached usb devices

Dec 29 11:58:42 localhost kernel: usb 1-1.2: new full-speed USB device number 8 using ehci-pci
Dec 29 11:58:42 localhost mtp-probe: checking bus 1, device 8: "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-1/1-1.2"
Dec 29 11:58:42 localhost mtp-probe: bus: 1, device: 8 was not an MTP device
Dec 29 11:59:51 localhost kernel: usb 1-5.1: new low-speed USB device number 10 using ehci-pci
Dec 29 11:59:51 localhost kernel: input: Logitech Trackball as /devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.1/1-5.1:1.0/0003:046D:C404.0007/input/input25
Dec 29 11:59:51 localhost kernel: hid-generic 0003:046D:C404.0007: input: USB HID v1.10 Mouse [Logitech Trackball] on usb-0000:00:1d.7-5.1/input0
Dec 29 11:59:51 localhost mtp-probe: checking bus 1, device 10: "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.1"
Dec 29 11:59:51 localhost mtp-probe: bus: 1, device: 10 was not an MTP device
Dec 29 11:59:51 localhost kernel: input: Logitech Logitech Illuminated Keyboard as /devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.4/1-5.4:1.0/0003:046D:C318.0008/input/input26
Dec 29 11:59:51 localhost kernel: hid-generic 0003:046D:C318.0008: input: USB HID v1.11 Keyboard [Logitech Logitech Illuminated Keyboard] on usb-0000:00:1d.7-5.4/input0
Dec 29 11:59:51 localhost kernel: input: Logitech Logitech Illuminated Keyboard as /devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.4/1-5.4:1.1/0003:046D:C318.0009/input/input27
Dec 29 11:59:51 localhost kernel: hid-generic 0003:046D:C318.0009: input: USB HID v1.11 Device [Logitech Logitech Illuminated Keyboard] on usb-0000:00:1d.7-5.4/input1
Dec 29 11:59:51 localhost mtp-probe: checking bus 1, device 11: "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.4"
Dec 29 11:59:51 localhost mtp-probe: bus: 1, device: 11 was not an MTP device

[1] ttp://forums.gentoo.org/viewtopic-p-7633366.html#7633366

[2] ug #527086

[3] tp will scan the usb bus and send messages to the log for all attached usb devices
Dec 29 11:58:42 localhost kernel: usb 1-1.2: new full-speed USB device number 8 using ehci-pci Dec 29 11:58:42 localhost mtp-probe: checking bus 1, device 8: "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-1/1-1.2" Dec 29 11:58:42 localhost mtp-probe: bus: 1, device: 8 was not an MTP device Dec 29 11:59:51 localhost kernel: usb 1-5.1: new low-speed USB device number 10 using ehci-pci Dec 29 11:59:51 localhost kernel: input: Logitech Trackball as /devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.1/1-5.1:1.0/0003:046D:C404.0007/input/input25 Dec 29 11:59:51 localhost kernel: hid-generic 0003:046D:C404.0007: input: USB HID v1.10 Mouse [Logitech Trackball] on usb-0000:00:1d.7-5.1/input0 Dec 29 11:59:51 localhost mtp-probe: checking bus 1, device 10: "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.1" Dec 29 11:59:51 localhost mtp-probe: bus: 1, device: 10 was not an MTP device Dec 29 11:59:51 localhost kernel: input: Logitech Logitech Illuminated Keyboard as /devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.4/1-5.4:1.0/0003:046D:C318.0008/input/input26 Dec 29 11:59:51 localhost kernel: hid-generic 0003:046D:C318.0008: input: USB HID v1.11 Keyboard [Logitech Logitech Illuminated Keyboard] on usb-0000:00:1d.7-5.4/input0 Dec 29 11:59:51 localhost kernel: input: Logitech Logitech Illuminated Keyboard as /devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.4/1-5.4:1.1/0003:046D:C318.0009/input/input27 Dec 29 11:59:51 localhost kernel: hid-generic 0003:046D:C318.0009: input: USB HID v1.11 Device [Logitech Logitech Illuminated Keyboard] on usb-0000:00:1d.7-5.4/input1 Dec 29 11:59:51 localhost mtp-probe: checking bus 1, device 11: "/sys/devices/pci0000:00/0000:00:1d.7/usb1/1-5/1-5.4" Dec 29 11:59:51 localhost mtp-probe: bus: 1, device: 11 was not an MTP device

[1]

[2]

[3]