ibackuptool

4.0.0 • Public • Published

iPhone backup tools

Build Status npm license

Are you storing unencrypted iPhone backups on your personal computer? With very little effort, we can dump all the saved messages from the backup, as well as notes, photo locations, and other data.

Check out my recently updated post about my work on backups here: Reverse Engineering the iOS Backup

This tool is also still fairly experimental, so use at your own risk! Even though the tool opens the backup files as read-only, you should still make a copy of your backups before using this if they are important.

Currently works on macOS, not tested on windows but should work on windows by setting the attribute --dir to the backups directory location.

Documentation

This readme is intended to be an overview of features. Please read the wiki for more up-to-date and in-depth examples, and examples of how to make and use reports.

iOS Support

iOS Support depends on the individual reporting types and which files are specifically present inside of the backup. When a report type is not supported, an error message is outputted to the terminal. Some reports, will output an error message if files that are required are not present in the backup.

Reports List

the full report list is available on the wiki

Installing (as a module)

npm i ibackuptool --save

You can then import the module to run reports and get javascript objects as results:

const bt = require('ibackuptool')
 
// Call the backups.list report.
bt.run('backups.list')
  .then(backups => {
    // Gives you a list of backups.
    console.log(backups)
  }

Installing (as a global command line tool)

# Install directly from NPM 
npm i -g ibackuptool
 
# If you prefer, you can do this manually: 
# Clone this repo, then run: 
# Install Globally on your system. 
npm i -g 
 
# Or, If you really want: 
# Clone this repo, then run:  
npm install
run `node tools/index.js` # use this instead of ibackuptool 

CLI Quickstart

# List all the backups on the system 
ibackuptool -l 
 
# I'm using "0c1bc52c50016933679b0980ccff3680e5831162" as a placeholder. 
# The list of backups contains the different UDIDs in the first column. 
UDID="0c1bc52c50016933679b0980ccff3680e5831162"
 
# Run ibackuptool --help to get a list of reports that are available 
ibackuptool -b $UDID --report '$TYPE'

Multiple-Reporting

You can also provide a comma separated list of reports to generate. Additionally, there is a special all report type which will run all available reports. This is best paired with the -o option for saving to disk and the -f option for selecting a format such as CSV, or JSON.

# Run all phone reports and wifi report. 
ibackuptool -b $UDID --report 'phone.*,system.wifi'
 
# Report all possible 
ibackuptool -b $UDID --report all

Reporting formats

iBackupTool now supports multiple kinds of data export, which can be selected using the -f flag.

  • table - Selected data columns in an ascii table
  • json - Selected data columns for display (same data as table)
  • csv - CSV file containing selected columns (same data as table)

Additionally, there are more comprehensive export functions that will export ALL the data collected, and keep original formatting and columns:

  • raw-csv - Full-data CSV export from each of the tables.
  • raw, raw-json - Full-data JSON export from each of the tables. This output can be quite large.

Joined Reports

Additionally, for the json and raw-json types, there's a --join-reports flag which will merge all of the data into a single JSON file, where the top level object has a key for each report type that is selected.

# Generate both wifi and calls reports, joined as JSON 
ibackuptool -b $UDID -r systme.wifi,phone.calls -f json --join-reports

Output to disk

the -o <path> (--output <path>option specifies a folder to export reports to. If the directory does not exist, it will be created. For joined JSON reports, a single json file is exported instead of multiple files in a directory.

# Export wifi, calls, voicemail as CSV files to disk in a folder named "exported/" 
ibackuptool -b $UDID --report system.wifi,phone.calls,phone.voicemail -f csv -o exported

Running Tests

first, install tap

next, run npm test.

Important!

You should make a backup of the backups you look at using this tool, even though they are opened as read-only, you should still do that do you don't accidentally do something to lose data.

Contributing

See Contributing.md

TODO

See Roadmap

Legal

Copyright © 2017-2018 Richard Infante.

Available under the MIT License.

DISCLAIMER: This tool enables the extraction of personal information from iPhone backups located on a computer drive. The tool is for testing purposes and should ONLY be used on iPhone backups where the owner's consent has been given. Do not use this tool for illegal purposes, ever.

The project contributors and Richard Infante will not be held responsible in the event any criminal charges be brought against any individuals misusing this tool and/or the information contained within, to break the law.

Keywords

none

install

npm i ibackuptool

Downloadsweekly downloads

14

version

4.0.0

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability