A real-time, cross-platform test execution visualization for Robot Framework powered by DearPyGui.
Nothing has such power to broaden the mind as the ability to investigate systematically and truly all that comes under thy observation. - Marcus Aurelius
- Live Execution Tree: Watch your Suites, Tests, and Keywords expand and collapse in real-time.
- Error Feed: A split-pane chronological feed of all
WARN,ERROR, andFAILlogs. Click any error to instantly expand the tree and highlight the exact keyword that caused it. - Tooltips: Hover over any keyword to see its execution time, status, and input arguments.
- Execution Control: Pause and resume the active Robot Framework test run directly from the GUI.
- Search and Filtering: Instantly search large execution trees by keyword name, argument, or log message.
- Process Isolated: Runs in a separate
multiprocessingprocess, dodging the Python GIL and ensuring your test timings are not affected by GUI rendering overhead.
- Python 3.10+
- Robot Framework >= 7.0 (Requires the V3 Listener API)
- Dear PyGui >= 2.2
Install the package directly from PyPI:
uv add robotframework-live-traceor using pip:
pip install robotframework-live-trace
You do not need to modify your Robot Framework test files. Simply pass the listener to the robot command:
robot --listener RobotLiveTrace my_tests/
The Dear PyGui dashboard will open immediately, and the test execution will begin. When the test suite finishes, the window will remain open so you can inspect the final call stack. Close the window to exit robotframework.
The top control bar provides several ways to manage large test executions:
- Pause: Freezes the Robot Framework execution thread. Uncheck to resume.
- Auto-Scroll: Automatically scrolls the tree and error feed to the bottom as new keywords and logs arrive.
- Auto-Collapse Passed: When a test or suite finishes with a
PASSstatus, it will automatically collapse its tree node to keep the UI clean. Failed nodes will remain expanded. - Expand All / Collapse All: Instantly open or close all currently rendered tree nodes.
- Filter (Name/Args/Logs): Type to instantly hide non-matching keywords. The tree will automatically expand parents to reveal deeply nested matches.
Contributions, issues, and feature requests are welcome. See CONTRIBUTING.md
Distributed under the MIT License. See LICENSE for more information.
- Noto Sans Font: This package bundles the "Noto Sans" font. The font is licensed under the SIL Open Font License, Version 1.1. The full license text can be found in src/RobotLiveTrace/fonts/OFL.txt.