Installation

Installation

Ready-to-run builds

Every release ships applications that need nothing else installed — Python, Qt, the protocol decoders and all firmware images are included. Get them from the releases page; SHA256SUMS.txt lists the checksums.

System	File	Note
Windows	…-Windows.zip	Unpack, start PiPiLogicAnalyzer.exe
macOS	…-macOS.dmg	Apple Silicon and Intel
Linux	…-Linux.AppImage	chmod +x, then start
Linux	…-Linux.tar.gz	Unpack, start PiPiLogicAnalyzer

The builds are not code-signed:

• Windows: SmartScreen reports an unknown publisher → More info → Run anyway.
• macOS: right-click the app → Open on the first start, or xattr -dr com.apple.quarantine /Applications/PiPiLogicAnalyzer.app.

From source

Requirements: Python ≥ 3.10, PySide6-Essentials, NumPy, pyserial.

git clone https://github.com/deckerjulian/PiPiLogicAnalyzer.git
cd PiPiLogicAnalyzer
python -m venv .venv
source .venv/bin/activate          # Windows: .venv\Scripts\activate
pip install -e .
pipilogicanalyzer

On Linux, Qt needs a few system libraries:

sudo apt-get install -y libegl1 libgl1 libxkbcommon0 libfontconfig1 libdbus-1-3

Serial port permissions (Linux)

The analyzer appears as /dev/ttyACM*. Add your user to the dialout group once and log in again:

sudo usermod -aG dialout "$USER"

Command line

pipilogicanalyzer capture.lac                 # open a capture on start-up
pipilogicanalyzer --decoders /path/to/decoders   # extra decoder directory (repeatable)
pipilogicanalyzer --debug-driver               # log the device communication

The log driver_debug.log and all settings live in the settings directory: ~/.config/PiPiLogicAnalyzer (Linux), ~/Library/Application Support/PiPiLogicAnalyzer (macOS) or %APPDATA%\PiPiLogicAnalyzer (Windows).