7401ead553
K/V backups are normally only attempted when charging and having an (un-metered) internet connection. However, if the system could not do a backup for more than a day, it ignores these requirements and still attempts a backup run. If a backup storage is used that is only accessible on the internet, but there is no internet connection, the backup attempt will fail. Therefore, we check if our storage requires the internet and if so, we treat it similar to a removable storage, by rejecting backup attempts and suppressing error notifications.
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# Seedvault
|
|
[](https://travis-ci.com/stevesoltys/seedvault)
|
|
|
|
A backup application for the [Android Open Source Project](https://source.android.com/).
|
|
|
|
## 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 11
|
|
|
|
For older versions of Android, check out [the branches](https://github.com/stevesoltys/seedvault/branches).
|
|
|
|
## Getting Started
|
|
- Check out [the wiki](https://github.com/stevesoltys/seedvault/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_DOCUMENTS` to retrieve the available storage roots.
|
|
* `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.
|
|
|
|
## Contributing
|
|
Bug reports and pull requests are welcome on GitHub at https://github.com/stevesoltys/seedvault.
|
|
|
|
This project aims to adhere to the [official Kotlin coding style](https://developer.android.com/kotlin/style-guide).
|
|
|
|
## Third-party tools
|
|
|
|
The [Seedvault backup parser](https://github.com/tlambertz/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](https://opensource.org/licenses/Apache-2.0).
|