Getting started

Quickstart OS X

• Install ruby
• gem install bundler
• brew install qt cmake usbmuxd libimobiledevice
• git clone --recursive [email protected]:dmayer/idb.git
• cd idb
• bundle install
• ruby gidb.rb

Detailed Install Guide

• Ruby (tested with 1.9 and 2.0)

  • With bundler (gem install bundler)

• qt libraries and cmake for compiling the qt ruby bindings.

  • OS X: brew install qt cmake
  • Ubuntu: apt-get install cmake libqt4-dev

• Some helpers used internally by gidb: git, rsync, libimobiledevice, plist-util

  • OS X: brew install libimobiledevice usbmuxd (rsync, git, plist-util should already be there.
  • Ubuntu: apt-get install git-core libimobiledevice-utils libplist-utils usbmuxd

• Clone the repo

  • Using --recursive to include the dumpdecrypted repo (https://github.com/stefanesser/dumpdecrypted).
  • git clone --recursive [email protected]:dmayer/idb.git

• Bundle install ruby dependencies: bundle install

  • This will take a while since qt bindings may need to be compiled.
  • If the Qt compilation fails with some linker errors, your ruby does no support shared libraries. If you use rvm (http://rvm.io/) you can simply pass --enable-shared when installing a ruby.

• Run ruby gidb.rb

Device Requirements

• Jailbroken iOS 6 or 7 (most things tested on 7, but 6 is safer for now).
• SSH server running (get it from Cydia)
• apt-get or aptitude (get it from Cydia)

Configuration

• Configure the device parameters in the File -> Preferences menu.
• Connect to the device using the Device -> USB Device menu.
• There will be a status dialog opening up which allows you to install some additional tools automatically. IF you don't do this, there will likely be crashes.