android-file-transfer-linux

Android File Transfer for Linux

View the Project on GitHub whoozle/android-file-transfer-linux

Android File Transfer For Linux (FreeBSD and Mac OS X!)

License Version Build Status

Android File Transfer for Linux — reliable MTP client with minimalistic UI similar to Android File Transfer for Mac.

It just works™.

Do I need it?

If you’re happy with gmtp/gvfs/mtpfs or any other mtp software, you might not need this software (but give it a try!).

If you’re suffering from crashes, missing tags, album covers, usb freezes and corrupted files, this software is right for you.

Features

FAQ

Please take a look at FAQ if you have issues with your operating system. It’s not that big, but those are the questions asked very often.

Support me

If you want to help me with development, click on the link below and follow the instructions. I’m developing AFTL in my spare time and try to fix everything as fast as possible, sometimes adding features in realtime (more than 100 tickes closed by now). Any amount would help relieving pain of using MTP. :D

https://www.paypal.me/whoozle

Building instructions

Gentoo

AFT for Linux is now included in Gentoo, you don’t have to build anything, just run

  sudo emerge -av sys-fs/android-file-transfer-linux

If you need fuse mount helper to mount MTP filesystem, you have to enable fuse use flag, e.g. adding the following in /etc/portage/package.use (which can either be a directory or a file)

  sys-fs/android-file-transfer-linux fuse

You can use sys-fs/android-file-transfer-linux-9999 ebuild if you want the latest git-version by adding the following entry into /etc/portage/package.accept_keywords (which can either be a directory or a file)

  =sys-fs/android-file-transfer-linux-9999 **

Prerequisites

Building with ninja

mkdir build
cd build
cmake -G Ninja ..
ninja

./qt/android-file-transfer

Building with make

mkdir build
cd build
cmake ..
make

./qt/android-file-transfer

Installing binary package on OS X / macOS

There is a binary package that can be installed via Homebrew:

brew install homebrew/cask/whoozle-android-file-transfer
brew install homebrew/cask-versions/whoozle-android-file-transfer-nightly

Building app package on OS X / macOS

You’ll need Qt installed to build the GUI app. Here are the build instructions with qt5 from homebrew (brew install qt5):

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=~/Applications -DCMAKE_PREFIX_PATH=/usr/local/opt/qt5
make
make install

open ~/Applications/android-file-transfer.app

Installation

sudo ninja install or sudo make install will install program into cmake prefix/bin directory (usually /usr/local/bin)

How to use

FUSE interface

mkdir ~/my-device
./aft-mtp-mount ~/my-device

Remember, if you want album art to be displayed, it must be named ‘albumart.xxx’ and placed first in the destination folder. Then copy other files. Also, note that fuse could be 7-8 times slower than ui/cli file transfer.

Qt user interface

  1. Start application, choose destination folder and click any button on toolbar.

  2. The options available there are: Upload Album, Upload Directory and Upload Files. The latter two are self-explanatory. Upload album tries searching source directory for album cover and sets best available cover.

  3. You could drop any files or folders right into application window, the transfer will start automatically.

Known problems

The actual list of all known problems and bugs available here

Contacts

Please do not hesitate to contact me if you have any further questions, my email address is vladimir.menshakov@gmail.com.

Special thanks

License

Android File Transfer for Linux is released under GNU LGPLv2.1 License.

Copyright © 2015-2018 Vladimir Menshakov