Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Mount MTP devices over FUSE
Go Python
branch: master

Be liberal with null packets in bulkRead

Return the last packet when a null read is expected. If more than 0 bytes
are received, check this data for CONTAINER_RESPONSE and don't fetch an
additional packet.

Fixes #75.
latest commit d108c3d1a0
@andreasf andreasf authored committed

README.md

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 run
mkdir /tmp/go
export GOPATH=/tmp/go
go get github.com/hanwen/go-mtpfs

/tmp/go/bin/go-mtpfs will then contain the program binary.

  • 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

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.

Something went wrong with that request. Please try again.