fusion-sync

What is Fusion ?

Fusion is a command-line tool designed to streamline the process of keeping your computer and Android device in sync. It offers a user-friendly interface and efficient functionality to make file transfers and synchronization a breeze.

Requirements

• Python: Ensure you have the latest Python installed on your system, you can download it from python.org .
• Android Debug Bridge (ADB): fusion uses ADB under the hood to communicate with your device. You can find the latest ADB releases and download instructions on the Google Developer website .

Connecting your device

You have various options to connect your device and all of them are written on the Google Developer website :

• USB: Connect your device to your computer using a USB cable after enabling USB debugging on your device.
• WiFi: Connect your device to your computer using the same WiFi network.
• Hotspot: the wifi connection is not supported on Android 10 and lower or with a hotspot connection so you have to use a USB connection at first then use the app. Read along the Google Developer website for more information.

Installation

Use pip (Python Package Index) to install fusion:

pip install fusion-sync

The reason that the package is named fusion-sync is because fusion was unavailable so, nothing to worry.

Usage

Pull files from your device to your computer :

fusion pull <source> <destination>

Push files from your computer to your device :

fusion push <source> <destination>

Synchronize files between your computer and device :

fusion sync <source> <destination>

Flags

• --dryrun,--dry: Perform a dry run without actually transferring files.
• --content,-c: Transfer content of the directory without the directory itself.
• --skip,-p: Skip files that exist on both sides.
• --sync,-s: Synchronize files, overwriting existing ones.
• --force,-f: Force transfer, ignoring conflicts.
• --reverse,-r: Reverse the direction of the synchronization.
• --delete,-d: Delete files that don't exist on the other side.

P.S: You can only use one of sync, force or skip flags at a time as they are mutually exclusive.

P.S 2: reverse and delete flags are only for sync command.

Examples

To pull all documents from your device to a folder named "Documents" on your computer :

fusion pull /sdcard/Documents ./Docuemnts

Sync two directories and delete files that don't exist on your phone anymore :

fusion sync --delete /sdcard/Documents ./Documents

To push all documents from your computer to your device and change its name to MyDocs :

fusion push --content ./Documents /sdcard/MyDocs

Path Completion

Fusion uses argcomplete to provide path completion when pressing <Tab>. According to argcomplete documentation you need to register the Fusion executable binary to enable this feature. To do so, add the following line to your shell startup file:

eval "$(register-python-argcomplete fusion)"