42mtp Module

42.1Overview

The mtp module provides measures to read/write data on a mobile platform like an Android device.

Below is an example that lists up files in the top directory of the device that is detected at first:

import(mtp)

devices = mtp.detect_devices()
device = devices[0]
println('Device: ', device.friendlyname)
storage = device.storages[0]
path.dir(storage.opendir('/')):stat {|stat|
    tm = stat.mtime
    if (stat.isdir) {
        printf('%04d/%02d/%02d %02d:%02d %12s  %s\n',
               tm.year, tm.month, tm.day, tm.hour, tm.min, '<dir>', stat.filename)
    } else {
        printf('%04d/%02d/%02d %02d:%02d %12d  %s\n',
               tm.year, tm.month, tm.day, tm.hour, tm.min, stat.size, stat.filename)
    }
}

42.2Module Function

42.3mtp.device Class

42.3.1Overview

The mtp.device class provides information such as device's friendly name and manufacturer name. It also provides a list of mtp.storage instances through which you can transfer and manipulate files on the remote device.

You can call mtp.detect_devices() to get a list of mtp.device instances that are associated to connected devices.

42.3.2Property

An mtp.device instance has the following properties:

42.4mtp.storage Class

42.4.1Overview

The class mtp.storage provices methods to transfer files from/to a device and to list and manipulate files on a device.

42.4.2Property

An mtp.storage instance has following properties:

42.4.3Method

The mtp.storage class has following methods:

42.5mtp.stat Class

42.5.1Overview

The mtp.stat class provides information about filename, timestamp and size of files on a portable device. An instance of mtp.stat is generated by calling path.dir() and path.walk() with a directory instance created by mtp.storage#opendir() for the argument and :stat attribute appended.

42.5.2Property

A mtp.stat instance has following properties:

42.6Thanks

This module uses libusb and libmtp library which is distributed in the following site:

• https://libusb.info/
• http://libmtp.sourceforge.net/