Cross-platform UDP log viewer for ESP32 and other embedded systems, built with Python and PyQt5.

Debugging embedded devices over UDP is painful. This tool makes it simple and visual. Not only viewing data, visualizing data as well.

Complete English documentation:

• docs/DOCUMENTATION_en.md
• docs/USER_GUIDE_en.md
• docs/RELEASE_0.16.3.md

Complete German documentation:

• docs/DOKUMENTATION_de.md

If you want to play around with an ESP32 & logging, please visit this demo repository https://github.com/mrRobot62/esp-udp-logging.git

• Latest stable release 0.16.3 (https://github.com/mrRobot62/udp-viewer/releases/tag/0.16.3)

• Release candidate 0.17.0 (https://github.com/mrRobot62/udp-viewer/releases/tag/0.17.0-RC1)

please use setup.exe to install this viewer

after installation this application is not signed and can't be started directly. You have to set this command: xattr -dr com.apple.quarantine /Applications/UDPLogViewer.app

Screenshot assets are stored under assets/screenshots.

Timebased visualizing

Measuring time

Measuring HIGH/LOW phase

Measuring signal period

The current codebase includes:

• real-time UDP log reception
• filter, exclude, and highlight rules
• live session logging
• main-window RESET support to start a fresh log phase inside the same app session
• runtime project contexts for grouping logs and screenshots per test session
• project descriptions stored as README_<projectname>.md inside the project folder
• replay of saved log files
• built-in simulation for text, temperature, and logic traffic
• CSV-based data visualization
• logic-channel visualization
• edge and period measurement directly inside the logic graph
• runtime Legend toggle in plot and logic graph windows
• keyboard-driven screenshot/save shortcuts and explicit TAB navigation in the main and graph windows
• macOS and Windows packaging scripts

python -m venv venv
source venv/bin/activate
pip install -e .[dev]
udp-log-viewer

./scripts/bootstrap_macos_linux.sh

⭐ If you like this project, consider giving it a star!