It just works™.
If you’re happy with
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 however, this software is right for you.
If your distribution does not provide an
android-file-transfer-linux package, you can still install it on your system.
There’s quite a few packages available:
brew cask install whoozle-android-file-transferor
brew cask install whoozle-android-file-transfer-nightly
If you want to help me with development, click on the link below and follow the instructions. I’m working on this project in my spare time and I try to fix everything as fast as possible, sometimes adding features in realtime (more than 100 tickets closed by now). Any amount would help relieving the pain of using MTP. :D
Please take a look at the FAQ if you have issues with your operating system. It’s not that big, but those are the questions asked very often.
sudo apt-get install android-file-transfer
Android File Transfer 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 a FUSE mount helper to mount MTP filesystems, you have to enable the FUSE use flag, e.g. adding the following in
/etc/portage/package.use (which can either be a directory or a file):
You can use the
sys-fs/android-file-transfer-linux-9999 ebuild if you want the latest Git version by adding the following entry to `/etc/portage/package.accept_keywords (which can either be a directory or a file):
sudo pacman -S android-file-transfer
For Ubuntu and other Debian-based distros, use the following command:
sudo apt-get install build-essential cmake qt5-default ninja-build libfuse-dev libreadline-dev qttools5-dev
dnf install make automake gcc gcc-c++ kernel-devel cmake fuse fuse-devel qt-devel readline-devel libqt5-linguist-devel
libqt5-devfor the UI,
libfuse-devfor the FUSE interface,
makefor building the project.
mkdir build cd build cmake -G Ninja .. ninja ./qt/android-file-transfer
mkdir build cd build cmake .. make ./qt/android-file-transfer
There is a binary package that can be installed via Homebrew:
brewif you don’t have it already installed.
brew install homebrew/cask/whoozle-android-file-transfer
brew install homebrew/cask-versions/whoozle-android-file-transfer-nightly
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
sudo ninja install or
sudo make install will install the program into the cmake prefix/bin directory (usually
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.
Upload Directory, and
Upload Files. The latter two are self-explanatory.
Upload Albumtries searching the source directory for album covers and sets the best available cover.
Up-to-date list of all known problems and bugs are available here.
Please do not hesitate to contact me if you have any further questions. My email address is email@example.com.
Android File Transfer for Linux is released under the GNU LGPLv2.1 License.
Copyright © 2015-2022 Vladimir Menshakov