Linux Android Backup

Linux Android Backup is a tiny shell script & Flutter app that makes securely backing up Android devices easy, without vendor lock-ins or using closed-source software that could put your data at risk. It's based on ADB but doesn't use the deprecated adb backup command. Despite its name, this project works on Windows, macOS and Linux (see issue #2).

Status: Works, but not all bugs have been fleshed out yet. If you spot a bug, please create an issue on GitHub.

Data backed up

• Apps (.apk files of installed apps)
• Internal storage (pictures, downloads, videos, Signal backups if enabled, etc)
• Contacts (exported in vCard format)

These 3 things are the majority of what anyone would want to keep safe, but we all have different expectations and requirements, so suggestions are welcome.

Features

• Automatically restores backed up data.
• Works on the 3 major operating systems, and supports any Android device.
• Backs up data not normally accessible through ADB using a native companion app.
• Tiny - the script is 5KB in size, and the companion app is around 15 megabytes.
• Doesn't use proprietary formats: your data is safe even if this script ever gets lost. Simply open archives created by this script using 7-Zip.
• Encryption is forced - you can't disable it.
• All data is compressed using 7-Zip with maximum compression settings.

Installation

Linux

1. Install p7zip, adb, curl and bc (if you're on Debian or Ubuntu, run this command: sudo apt update; sudo apt install p7zip-full adb curl bc).
2. Clone or download this repository.
3. Enable developer options and USB debugging on your device and run backup.sh in a terminal.

macOS

1. Install p7zip, adb and curl using Homebrew:

# Tip: Run these commands in the built-in Terminal app (or iTerm if you have that installed).
# Install Homebrew if you haven't yet
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# If you already have Homebrew installed, just run these 3 commands:
brew install --cask android-platform-tools
brew install p7zip
brew install curl

2. Follow the steps 2 and 3 from the install guide for Linux.

Windows

1. Install the Windows Subsystem for Linux (WSL), a compatibility layer allowing you to run Linux applications (such as this one) on Windows. You only need to follow the Install step.
2. Open an app called "Ubuntu" or "Debian". It should be in your start menu.
3. Navigate to your desktop by running cd Desktop. (optional)
4. Follow all steps from the install guide for Linux.

Usage

Just run backup.sh and the script will walk you through the process. This section covers advanced usage of this program.

Automation/Unattended Backups

Please keep in mind that this project has minimal support for automation and very little support will be provided. In order to export contacts, you still need to have physical access to the device you're backing up as an "unattended mode" for the companion app hasn't been implemented yet.

There are 4 environment variables that control what the script does without user input:

1. unattended_mode - Instead of waiting for a key press, sleeps for 10 seconds. Can be any value.
2. selected_action - What the script should do when run. Possible values are Backup and Restore (case sensitive).
3. archive_path - Path to the backup that should be restored.
4. archive_password - Backup password.

Building companion app

Note: You don't need to do this, as the precompiled companion app is automatically downloaded at runtime from GitHub Releases.

1. Install Flutter and Android Studio.
2. Run flutter doctor and flutter doctor --android-licenses.
3. Run cd companion_app/ and flutter build apk.

TODO

Sorted by importance. PRs are appreciated.

• Create a desktop GUI for newcomers (using Flutter maybe?)
• Improve mobile app by properly handling errors and making it more appealing
• Migrate the companion app to the Storage Access Framework API for forward compatibility (waiting for Flutter packages providing this functionality to become stable).

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.