User Manual - A-DONALD/iBackup-Extractor GitHub Wiki

This user manual will guide you through the usage of each command and their different arguments for the IBackup Extractor CLI.

1 - Search

The search command is used to search for backups in the specified path.

Usage:

python run.py search -p <path> [-l]

Arguments:

  • -p or --path: Path to search for backups. (required)
  • -l: Include full path in the listing output. (optional)

Example:

python run.py search -p "C:\backup samples"

Output:

---------------------------------------------
ID |    FolderName
---------------------------------------------
0 : 00008020-0011548E34D1542E
---------------------------------------------
1 : 6e81410f-6424-4ec2-829e-1402769a741e
---------------------------------------------
2 : b91c9a31d2c6e51a41300733b3d9285a608565ab
---------------------------------------------

2 - Info

The info command is used to get information (metadata) from local iOS backups.

Usage:

python run.py info -p <path>

Arguments:

  • -p or --path: Path to search for backups. (required)

Example:

python run.py info -p "C:\backup samples\00008020-0011548E34D1542E"

Output:

IsEncrypted :  False
SystemDomainsVersion :  24.0
WasPasscodeSet :  True
Version :  11.0
Starting date :  2017-09-14 13:06:35
Device Name :  John Appleseed's iPhone
Display Name :  John Appleseed's iPhone
Installed Applications: picaboo, chat, tinder, viber, hike, line, ReaddleDocsIPad, WhatsApp, xin,
Last Backup Date :  2018-09-20 13:43:48
Product Version :  13.4.1
iTunes Version :  12.6.2.20
Product Name :  iPhone 11
Product Type :  iPhone12,1
Serial Number :  FK1VNXXXJCL8
Build Version :
GUID :
ICCID :
Target Identifier :
Unique Identifier :  00000000-0000000000000000
IMEI :  359204071111111
Phone Number :
IsFullBackup :  False
Version :  3.2
BackupState :  new
SnapshotState :  finished
UUID :
Ending date :  2017-09-14 13:43:44

3 - List

The list command is used to list files within an iOS backup.

Usage:

python run.py list -p <path> [-c <category>] [-f <format>]

Arguments:

  • -p or --path: Path to the backup. (required)
  • -c: Category of the wanted file. (optional)
  • -f or --format: Format of list. Print by set of "f". Default value is 5. (optional)

Available categories at the end.

Example:

python run.py list -p "C:\backup samples\00008020-0011548E34D1542E" -c photos -f 10

Output:

There are 10 files (photos) in the backup
0 IMG_0005.JPG
------------------------------------
1 IMG_0007.JPG
------------------------------------
2 IMG_0004.JPG
------------------------------------
3 IMG_0002.JPG
------------------------------------
4 IMG_0008.JPG
------------------------------------
5 IMG_0001.JPG
------------------------------------
6 IMG_0009.JPG
------------------------------------
7 IMG_0003.JPG
------------------------------------
8 IMG_0010.PNG
------------------------------------
9 IMG_0011.PNG
------------------------------------

4 - Export

The export command is used to export data from an iOS backup to a destination folder.

Usage:

python run.py export -p <path> -d <dest-path> [-c <category>]

Arguments:

  • -p or --path: Path to the backup. (required)
  • -d or --dest-path: Path to the destination folder. (required)
  • -c or --category: Category of the files to export. (optional)

Available categories at the end.

Example:

python run.py export -p "C:\backup samples\00008020-0011548E34D1542E" -d "C:\destination" -c photos

Output:

Extracting photos...
Done
Exporting photos...
Done. Exported to D:\Test

5 - Available Categories

  • camera
  • photos
  • videos
  • contacts
  • sms
  • whatsapp
  • calendar
  • web_history
  • notes
  • call
  • all

Please note that not providing a category for the 'list' and 'export' commands will result in an error. Make sure to specify a category from the available list.

⚠️ **GitHub.com Fallback** ⚠️