RepoMirrors
/
simple-mtpfs
mirror of https://github.com/phatina/simple-mtpfs
1
0
Fork 0
Code Issues Releases Wiki Activity

Updated Home (markdown)

phatina 2013-01-11 06:50:18 -08:00
parent f70c68dd9a
commit e971c0ec2c
2 changed files with 67 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Home.md

@ -1 +0,0 @@
Welcome to the simple-mtpfs wiki!

67
Simple-MTPFS.md Normal file

@ -0,0 +1,67 @@
# About
SIMPLE-MTPFS (Simple Media Transfer Protocol FileSystem) is a file system for
Linux (and other operating systems with a FUSE implementation, such as Mac OS X
or FreeBSD) capable of operating on files on MTP devices attached via
USB to local machine. On the local computer where the SIMPLE-MTPFS is
mounted, the implementation makes use of the FUSE (Filesystem in Userspace)
kernel module. The practical effect of this is that the end user can seamlessly
interact with MTP device files.
# Installing
Simple-mtpfs depends on fuse (version >2.8) and libmtp. It also requires the C++
compiler to support c++11 standard.
To install the driver, follow these steps:
```bash
$ mkdir build && build
$ ../configure
$ make
$ make install (as root)
```
If you got the sources from git repository, first you have to run:
```sh
$ ./autogen.sh
```
# Usage
This section covers most common use cases of SIMPLE-MTPFS.
## Device listing
To print a list of devices, that are connected, run following:
```bash
$ simple-mtpfs --list-devices
Device 0 (VID=0fce and PID=014f) is a SonyEricsson LT15i (Xperia arc S). # libmtp debug output, ignore
Device 1 (VID=04e8 and PID=685c) is a Samsung Galaxy models (MTP+ADB). # libmtp debug output, ignore
1: SonyEricssonLT15i (Xperia arc S)
2: SamsungGalaxy models (MTP+ADB)
```
## Mounting
To mount MTP-based device to your local filesystem, simply run:
```bash
$ simple-mtpfs <mount_pount>
```
In case, you have more than one mtp-based device connected, you can specify, which device to mount.
```bash
$ simple-mtpfs --device <device_number> <mount_point> # to mount Galaxy Nexus
```
## Unmounting
To unmount your mtp-based device, execute this:
```bash
$ fusermount -u <mount_point>
```
## Move-operation
Due to MTP protocol logic, there can not be a full move-operation executed. By default, you can not move any file/folder in the mtp-based device storage. You can enable software emulation of this operation by passing a mount parameter ``-o enable-move``. Move emulation means, that the content is first copied to temporary location, removed on the device and then copied back (moved, renamed). Following example shows, how to mount with move-operation enabled.
```bash
$ simple-mtpfs <mount_point> -o enable-move
```
## Temporary directory
Again, due to MTP protocol logic, true read/write operations can be performed on files, that are temporarily copied on a local filesystem. By default, all the temporary files are stored in /tmp/simple-mtpfs-XXXXXX, where XXXXXX is a random string for each mount different. You can specify your desired temporary directory for SIMPLE-MTPFS by running:
```bash
$ simple-mtpfs <mount_point> -o tmp-dir=<path>
```