Installation

The latest compiled version of the tool for Linux, macOS and Windows (x86-64 in each case) can be obtained from the Releases page of the project. This version should already be executable under macOS without further installations (first start via right-click).

Under Linux, a suitable Usbmux deamon must be provided:

sudo apt-get install usbmuxd

sudo pacman -S usbmuxd

yum install usbmuxd

apk add usbmuxd

Windows requires either iTunes or Apple-Devices. After the first start Usbmux is available under Windows.
It is strongly recommended to deactivate the Limitation of the maximum path length.

Execution via Python

Obtaining the project as a Python application via Github is recommended in order to benefit early from improvements and bug fixes.
For example, UFADE can also be executed on ARM or 32-bit systems. At least Python 3.11 is required.

Obtaining UFADE and the "ufade-developer" submodule:

git clone https://github.com/prosch88/UFADE --recurse-submodules
cd UFADE
pip install -r requirements.txt

If the submodule does not exist, the developer options will not be available in the program.

Installing the dependencies:

sudo apt-get install python3-tk libasound2-dev usbmuxd libusb

sudo apt-get install build-essential python3-tk usbmuxd libusb libffi-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libasound2-dev

sudo pacman -S tk usbmuxd libusb

sudo yum install tkinter usbmuxd

apk add python3-tkinter usbmuxd libusb libusb-devel

brew install python@3.11 python-tk@3.11 libusb

After installation, UFADE can be called via Python:

python ufade.py

Pro tip: To start UFADE directly from the target directory, an alias for UFADE can be created in the ".bashrc" or ".zshrc" file (depending on the shell used), for example:

echo "alias ufade='python ~/path_to/UFADE/ufade.py'" >> ~/.bashrc

echo "alias ufade='python ~/path_to/UFADE/ufade.py'" >> ~/.zshrc

(The path must be adapted accordingly.)