Skip to content

A simple tool for extracting files from iOS backup archive.

License

Notifications You must be signed in to change notification settings

unixzii/ibackupextractor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 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:

Disable Encryption

Will this tool modify the original backup archive?

No, the tool will not write to any file in the backup archive.

License

MIT