ADB_Puller

Script for pulling files from android smartphones using ADB drivers. It implements some additional features that adb lacks like:

• Skipping already pulled files
• A timeout feature to skip files that takes more than 60 seconds to pull as it usually means that the command is stuck
• A --dry-run option to see which files will be pulled and where they will be saved
• Pull items listed in a file
• Skip items listed in a file

Requirements

Works on both Windows and Linux.

• ADB drivers that you can download here
• Python 3.9+
• [Optional] tqdm for the progress bar

Usage

python ./adb_puller.py --source '/sdcard/DCIM' '/sdcard/Music/Recordings' --dest '~/abc'

The folders will be pulled from --source to --dest with the same name and folder structure they have in the smartphone.

You can add as many paths as you want after the -s or --source flag. The folders in the example will be saved respectively to ~/abc/DCIM and ~/abc/Recordings.

BEWARE

The name of the directory will be used to create a folder inside the destination. If you pull from two directories with the same name they will be merged, and if two files have the same name one will be overwritten!

$ python ./adb_puller.py -s '/sdcard/DCIM/Camera' '/sdcard/Camera' -d '/home/abc' --dry-run
/sdcard/DCIM/Camera/IMG_1.jpg     ->  /home/abc/Camera/IMG_1.jpg
/sdcard/Camera/IMG_1.jpg          ->  /home/abc/Camera/IMG_1.jpg
/sdcard/Camera/IMG_2.jpg          ->  /home/abc/Camera/IMG_2.jpg

Pull files from a list

python ./adb_puller.py -i 'files_to_pull.txt' -d 'home/abc' 

You can pull files from a list with the -i command.

BEWARE

When pulling files from a list the script cannot know which directory to use as root and to avoid messing up the directory structure and overwriting files it will create all intermediate folders.

$ python ./adb_puller.py -i 'files_to_pull.txt' --dest '/home/abc' --dry-run
/sdcard/DCIM/Screenshots/IMG_1.jpg          ->  /home/abc/sdcard/DCIM/Screenshots/IMG_1.jpg
/sdcard/Pictures/Screenshots/IMG_2.jpg      ->  /home/abc/sdcard/Pictures/Screenshots/IMG_2.jpg
/bin/test/IMG_2.jpg      ->  /home/abc/bin/test/IMG_2.jpg

Skip files

With --skip-from-file you can skip all items inside a file. Conveniently, adb_puller.py saves in ./done.txt every file it pulls, so you can, for example, pull some files in a folder and stop the process, then redo it in another folder and skip the files already pulled.

If you just want to skip some files passed as arguments you can use the --skip flag:
python ./adb_puller.py --source '/sdcard/DCIM' --dest 'home/abc' --skip-from-file 'to_skip.txt' --skip '/sdcard/DCIM/to_skip.jpg'

All files containing paths to pull or skip just need to have a path every line:

/sdcard/1.jpg
/sdcard/2.jpg
/sdcard/DCIM/1.jpg

Dry run

--dry-run will print the files that will be pulled and where they will be saved:

$ python ./adb_puller.py -s '/sdcard/DCIM/Screenshots' -d '/home/abc' --dry-run
Building file list of "/sdcard/DCIM/Screenshots"
/sdcard/DCIM/Screenshots/IMG_1.jpg      ->  /home/abc/Screenshots/IMG_1.jpg
/sdcard/DCIM/Screenshots/IMG_2.jpg      ->  /home/abc/Screenshots/IMG_2.jpg