Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/unixzii/ibackupextractor
A simple tool for extracting files from iOS backup archive.
https://github.com/unixzii/ibackupextractor
apple backup cli ios itunes rust tools
Last synced: 15 days ago
JSON representation
A simple tool for extracting files from iOS backup archive.
- Host: GitHub
- URL: https://github.com/unixzii/ibackupextractor
- Owner: unixzii
- License: mit
- Created: 2023-09-21T12:27:34.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-17T06:08:10.000Z (about 2 months ago)
- Last Synced: 2024-09-17T08:42:50.178Z (about 2 months ago)
- Topics: apple, backup, cli, ios, itunes, rust, tools
- Language: Rust
- Homepage:
- Size: 598 KB
- Stars: 144
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# iBackupExtractor
A simple tool for extracting files from iOS backup archive.
iOS backup files are not stored with their original directory layouts. Retrieving a particular file from the app sandbox can be difficult. This tool can extract all the files from a backup archive, and then you can view the sandbox filesystem as it was originally stored in your iPhone or iPad.
To save disk usage and speed up the extraction process, the extracted files are symbolic links to the original files in the backup archive.
## Install
### Download From GitHub Releases
For Mac users, you can download the pre-built binaries directly from [releases](https://github.com/unixzii/ibackupextractor/releases) page.
### Build Locally
To build this locally, a nightly toolchain is required. You can install it using `rustup`:
```
rustup toolchain install nightly
```
Then, you can build the executable:
```
cargo +nightly build --release
```
## Usage
Locate the backup archive you want to extract. Generally, you can find it under `/Users/cyandev/Library/Application Support/MobileSync/Backup`. **The archive is a directory that contains `Manifest.db` file.**
### List Domains
Backup files are grouped by domains, and you need to specify a domain name when extracting. To list all the domains available, run the command below:
```
ibackupextractor -l /path/to/your_backup_archive
```
### Extract a Specified Domain
To extract files, you need to specify a domain name and a destination path (an empty directory is recommended):
```
ibackupextractor -o /path/to/dest_dir /path/to/your_backup_archive SomeDomain
```
The extraction process can take minutes to finish, depends on the number of files.
In addition to the default symbolic-link mode, you can also change to copy mode by specifying `-c` flag. In copy mode, all files are copied to the destination path, and then you can delete the original backup archive freely if you want.
## FAQ
### How to create a proper backup archive?
This tool can only handle the backup archives that are unencrypted. To backup without encryption, uncheck the following option before starting:
### Will this tool modify the original backup archive?
No, the tool will not write to any file in the backup archive.
## License
MIT