Skip to main content

​
Installation

Impactor is available for macOS, Linux, and Windows. Choose your platform below to get started.

​
macOS

1

Install via Homebrew

The easiest way to install Impactor on macOS is using Homebrew:
brew install --cask impactor
This will install the latest version of Impactor and keep it up to date with brew upgrade.
2

Alternative: Download from GitHub

You can also download the latest release directly:
  1. Visit the GitHub releases page
  2. Download the .dmg file for macOS
  3. Open the downloaded file and drag Impactor to your Applications folder
3

Launch Impactor

Open Impactor from your Applications folder. If you see a security warning, go to System Preferences > Security & Privacy and click “Open Anyway”.
macOS works out of the box with no additional dependencies required.

​
Linux

1

Install via Flatpak (recommended)

Impactor is available on Flathub for easy installation:
flatpak install flathub dev.khcrysalis.PlumeImpactor
Then launch it with:
flatpak run dev.khcrysalis.PlumeImpactor
2

Alternative: Download from GitHub

You can also download the latest release:
  1. Visit the GitHub releases page
  2. Download the appropriate file for your distribution (.AppImage, .deb, or .rpm)
  3. Make it executable and run it
chmod +x Impactor-*.AppImage
./Impactor-*.AppImage
3

Verify usbmuxd is installed

Impactor requires usbmuxd to communicate with iOS devices. It’s included by default on most distributions:
sudo apt-get install usbmuxd
Known issues on Linux:
  • Due to some distributions’ udev rules, usbmuxd may stop running after no devices are connected. If Impactor doesn’t detect your device, plug your phone in first, then restart the app.
  • Some distributions (like Bazzite) may need you to run sudo update-crypto-policies for usbmuxd to detect devices.
  • Auto-refresh will not work the same as on macOS/Windows due to usbmuxd lacking WiFi connectivity. It will only work when a device is plugged in.

​
Windows

1

Install iTunes

Windows requires iTunes to be installed first:
  1. Download iTunes from Apple
  2. Install iTunes and restart your computer
Impactor needs iTunes to access the Apple device drivers for communicating with iOS devices.
2

Download Impactor

  1. Visit the GitHub releases page
  2. Download the .exe installer or .zip file for Windows
  3. Run the installer or extract the zip file
3

Launch Impactor

Run Impactor from your Start menu or the extracted folder. Windows Defender may show a warning for unsigned applications—click “More info” and “Run anyway” if you trust the source.

​
Building from source

If you want to build Impactor from source, you’ll need: 
cargo run --bin plumeimpactor

​
Platform-specific build dependencies

sudo apt-get install libclang-dev pkg-config libgtk-3-dev libpng-dev \
  libjpeg-dev libgl1-mesa-dev libglu1-mesa-dev libxkbcommon-dev \
  libexpat1-dev libtiff-dev

​
Next steps

Now that you have Impactor installed, head over to the quick start guide to sideload your first app.

Build docs developers (and LLMs) love

Get started for freeTalk to us