Gitiles
Code Review Sign In
LeafOS / LeafOS-Project / android_packages_apps_Seedvault / dd578286973f77640b3fdb0c296963ea5bb7d2c0
commitdd578286973f77640b3fdb0c296963ea5bb7d2c0[log] [tgz]
authorOliver Scott <olivercscott@gmail.com>Tue Jun 29 21:33:25 2021 -0400
committerChirayu Desai <952062+chirayudesai@users.noreply.github.com>Fri Apr 29 23:43:09 2022 +0530
treef8b4cbf95969bb64f89cc8e6bbe96ec083ba5198
parentfa93d5dfccf1cb8371ce15877393f4ea6392df04 [diff]
Allow secondary user backup to USB

By default, Android exposes USB devices only to the main user.
In order to query, read and write to it, the signature permission INTERACT_ACROSS_USERS_FULL (optional) is granted to create Seedvault's context as the system user.

Issue: calyxos#437
Issue: https://github.com/seedvault-app/seedvault/issues/77
Change-Id: I0b1b4c8c5aeeb226419ff94e15f631ebe1db66df
12 files changed
tree: f8b4cbf95969bb64f89cc8e6bbe96ec083ba5198
  1. .github/
  2. .idea/
  3. app/
  4. contactsbackup/
  5. gradle/
  6. libs/
  7. storage/
  8. .editorconfig
  9. .gitignore
  10. Android.bp
  11. build.gradle
  12. CHANGELOG.md
  13. gradle.properties
  14. gradlew
  15. gradlew.bat
  16. LICENSE
  17. logcat-verbose.sh
  18. permissions_com.stevesoltys.seedvault.xml
  19. README.md
  20. settings.gradle
  21. whitelist_com.stevesoltys.seedvault.xml
README.md

Seedvault

Build

A backup application for the Android Open Source Project.

If you are having an issue/question, please look at our FAQ.

Components

Features

  • Backup application data to a flash drive.
  • Restore application data from a flash drive.
  • User-friendly encryption using a mnemonic phrase (BIP39).
  • Automatic daily backups that run in the background.

Requirements

  • Android 12

For older versions of Android, check out the branches.

Getting Started

  • Check out the wiki for information on building the application with AOSP.

What makes this different?

This application is compiled with the operating system and does not require a rooted device for use. It uses the same internal APIs as adb backup which is deprecated and thus needs a replacement.

Permissions

  • android.permission.BACKUP to back up application data.
  • android.permission.ACCESS_NETWORK_STATE to check if there is internet access when network storage is used.
  • android.permission.MANAGE_USB to access the serial number of USB mass storage devices.
  • android.permission.WRITE_SECURE_SETTINGS to change system backup settings and enable call log backup.
  • android.permission.QUERY_ALL_PACKAGES to get information about all installed apps for backup.
  • android.permission.INSTALL_PACKAGES to re-install apps when restoring from backup.
  • android.permission.MANAGE_EXTERNAL_STORAGE to backup and restore files from device storage.
  • android.permission.ACCESS_MEDIA_LOCATION to backup original media files e.g. without stripped EXIF metadata.
  • android.permission.FOREGROUND_SERVICE to do periodic storage backups without interruption.
  • android.permission.MANAGE_DOCUMENTS to retrieve the available storage roots (optional) for better UX.
  • android.permission.USE_BIOMETRIC to authenticate saving a new recovery code
  • android.permission.INTERACT_ACROSS_USERS_FULL to use storage roots in other users (optional).

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/seedvault-app/seedvault.

This project aims to adhere to the official Kotlin coding style.

Third-party tools

⚠ WARNING: the Seedvault developers make no guarantees about external software projects. Please be aware that disclosing your secret recovery key to other software has security risks.

The Seedvault backup parser allows you to decrypt and inspect your backups. It can also re-encrypt them.

License

This application is available as open source under the terms of the Apache-2.0 License.