Skip to main content

Install IDB

IDB consists of two components that must each be installed separately. Install IDB Client and IDB Companion by following the steps below:

1.  Open the Terminal and run the following command:

brew tap facebook/fb

2.  Next run the following command to install IDB Companion:

brew install idb-companion

3.  Next IDB Client, run the following command:

pip3.6 install fb-idb

If users face issues installing the IDB, please refer to the following instructions during installation:

  1. If getting error: externally-managed-environment while using pip3

A. Getting Pyenv Update homebrew and install pyenv:

brew update
brew install pyenv

B. Set up your shell environment for Pyenv If using zsh as a terminal profile

  echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
  echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
  echo 'eval "$(pyenv init -)"' >> ~/.zshrc

If using bash as a terminal profile

  1. First, add the commands to ~/.bashrc by running the following in your terminal:
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
  1. Then, if you have ~/.profile, ~/.bash_profile or ~/.bash_login, add the commands there as well. If you have none of these, create a ~/.profile and add the commands there.
  • to add to ~/.profile
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.profile
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.profile
echo 'eval "$(pyenv init -)"' >> ~/.profile
  • to add to ~/.bash_profile:
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(pyenv init -)"' >> ~/.bash_profile

C. Restart your shell

exec "$SHELL"

D. Install Python versions

pyenv install 3.9
pyenv global 3.9
  1. Ensure the values of Command Line Tool is not empty:
  • Launch the XCode and navigate to Preferences under the XCode drop-down menu.
  • Then, navigate to Locations and ensure Command Line Tool has a value.
  1. If normal brew commands are not working in M1 mac, use the following commands:
arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

arch -x86_64 /usr/local/bin/brew tap Facebook/fb
arch -x86_64 /usr/local/bin/brew install idb-companion
arch -x86_64 /usr/local/bin/brew install libusbmuxd