SulinOS/go-mtpfs

INTRODUCTION

Go-mtpfs is a simple FUSE filesystem for mounting Android devices as a MTP device.

It will expose all storage areas of a device in the mount, and only reads file metadata as needed, making it mount quickly. It uses Android extensions to read/write partial data, so manipulating large files requires no extra space in /tmp.

It has been tested on various flagship devices (Galaxy Nexus, Xoom, Nexus 7). As of Jan. 2013, it uses a pure Go implementation of MTP, which is based on libusb.

COMPILATION

Install the Go compiler suite; e.g. on Ubuntu:

sudo apt-get install golang-go

Install libmtp header files

sudo apt-get install libusb1-devel

Then check out go-mtpfs, and run

go build ./

This will leave a binary go-mtpfs

You may need some tweaking to get libusb to compile. See the comment near the top of usb/usb.go, ie.

# edit to suit libusb installation:
vi /tmp/go/src/github.com/hanwen/go-mtpfs/usb/usb.go
go install github.com/hanwen/go-mtpfs

32-bit and 64-bit linux x86 binaries are at

http://hanwen.home.xs4all.nl/public/software/go-mtpfs/

USAGE

mkdir xoom
go-mtpfs xoom &
cp -a ~/Music/Some-Album xoom/Music/
fusermount -u xoom

After a file is closed (eg. if "cp" completes), it is safe to unplug the device; the filesystem then will continue to function, but generates I/O errors when it reads from or writes to the device.

CAVEATS

It does not implement rename between directories, because the Android stack does not implement it.
It does not implement Event handling, ie. it will not notice changes that the phone makes to the media database while connected.

FEEDBACK

You can send your feedback through the issue tracker at https://github.com/hanwen/go-mtpfs

DISCLAIMER

This is not an official Google product.

SulinOS / go-mtpfs