/imobilecfbm

A lightweight utility to download, repack and install carrier bundles files for iOS based devices.

Primary LanguageShellGNU General Public License v2.0GPL-2.0

iMobile Carrier-Bundles Manager

  • A lightweight utility to download, repack and install carrier bundles files for iOS based devices.

How to get started?

Required dependancy: libplist plget libimobiledevice

Windows users:

  1. Install MSYS2
  2. Get the latest precompiled libimobiledevice from here and then extract the binaries into: C:\msys64\usr\bin
  3. Get the latest precompiled plget from here and then extract the binaries into: C:\msys64\usr\bin Important note: Don't replace any file If already exist !
  4. Install required dependancy: pacman -S git
  5. Clone this repo

Linux users:

  1. Install required dependancy:
sudo apt install git \
libplist-utils \
libimobiledevice-utils
  1. Follow the instructions here plget for compiling plget utility.
  2. After you have compiled plget you either have to set the variable plget via export plget=/home/location/plget or you can avoid always exporting the plget variable by simply copying the plget binary into: /usr/bin.
  3. Clone this repo

macOS users:

  1. Install brew
  2. Install required dependancy:
brew install libimobiledevice libplist
  1. Follow the instructions here plget for compiling plget utility.
  2. After you have compiled plget make sure to always set the variable plget via export plget=/home/location/plget
  3. Clone this repo

Cloning repo:

git clone https://github.com/mast3rz3ro/imobilecfbm

How to run?

$ cd imobilecfbm
$ chmod +x cfbm.sh
$ ./cfbm.sh

# If you have installed the required dependancy then you should be able to see the parameters options
# otherwise it's will warn you that you are missing one of the dependancy.

Usage examples:

- Examples:

  # Update local database and check latest carrier bundles available for download:
     cfbm -u -d
  # Idenify the carrier bundle from local storage and repack it:
     cfbm -i 'file.ipcc' 'folder_contains_ipcc_files'
  # Search and Install a carrier bundle matches the connected device bundle version:
     cfbm -s
  # Search and Install a valid carrier bundle with 'default.bundle' payload name:
     cfbm -s -p 1

Where to get support?

  • Please open a new ticket here and describe your issue as much as possible.

References:

  • ipcc-downloader another bundles downloader by @mrlnc this repo contains some good info.
  • jailbreak10.3.3 a great repo by @WRFan contains too much info about carrier bundles.
  • anchumosaku a great tutorial by @liathfeth about extracting and repacking the carrier bundle.
  • CarrierBundle More info about carrier bundles by TheAppleWiki
  • samsam123 Online website for fetching carrier Bundles.

Credits

  • plget a lightweight PLIST parser
  • libplist used for force converting PLIST file into xml.
  • libimobiledevice Used for installing carrier-bundles and more.
  • L1ghtmann for providing a precompiled libimobiledevice binaries for windows.
  • MSYS2 an alternative to Cygwin but better.
  • brew a package manager same like apt/pacman but for macOS.