rsync is a file synchronization tool for local (including FUSE) file systems or SSH connections. This can be used even with Android devices if rooted or using an app like SSHelper.
adbfs is a FUSE file system that uses adb to communicate to the device. Requires a rooted device, though.
adbfs-rootless is a fork of adbfs that requires no root on the device. Does not play very well with rsync.
go-mtpfs is a FUSE file system to connect to Android devices via MTP. Due to MTP's restrictions, only a certain set of file extensions is supported. To store unsupported files, just add .txt! Requires no USB debugging mode.

Setup

Android Side

First you need to enable USB debugging mode. This allows authorized computers (on Android before 4.4.3 all computers) to perform possibly dangerous operations on your device. If you do not accept this risk, do not proceed and try using go-mtpfs instead!

On your Android device:

Go to the Settings app.
If there is no "Developer Options" menu:
- Select "About".
- Tap "Build Number" seven times.
- Go back.
Go to "Developer Options".
Enable "USB Debugging".

PC Side

Install the Android SDK (the stand-alone Android SDK "for an existing IDE" is sufficient). Alternatively, some Linux distributions come with a package named like "android-tools-adb" that contains the required tool.
Make sure "adb" is in your PATH. If you use a package from your Linux distribution, this should already be the case; if you used the SDK, you probably will have to add an entry to PATH in your ~/.profile file, log out and log back in.
git clone https://github.com/google/adb-sync
cd adb-sync
Copy or symlink the adb-sync script somewhere in your PATH. For example: cp adb-sync /usr/local/bin/

Usage

To get a full help, type:

adb-sync --help

To synchronize your music files from ~/Music to your device, type one of:

adb-sync ~/Music /sdcard
adb-sync ~/Music/ /sdcard/Music

To synchronize your music files from ~/Music to your device, deleting files you removed from your PC, type one of:

adb-sync --delete ~/Music /sdcard
adb-sync --delete ~/Music/ /sdcard/Music

To copy all downloads from your device to your PC, type:

adb-sync --reverse /sdcard/Download/ ~/Downloads

TODO

Patches for the following features would be very welcome:

Supporting wildcards on the SRC side. This has to take place before appending the last path component of SRC to DST; for example, this should work: adb-sync /sdcard/* ~/mnt. The best way to implement this is probably to expand the wildcards first, then run multiple AdbFileSyncer instances; this could even allow for somewhat supporting two-way mode with this (however, two-way mode should then be blocked if SRC ends with a slash!).

Contributing

Patches to this project are very welcome.

Before sending a patch or pull request, we ask you to fill out one of the Contributor License Agreements:

Disclaimer

This is not an official Google product.

README.md

adb-sync

Related Projects