Cut with confidence.
Waste less.
Interactive dual-view G-Code editor and analyzer for CNC machines under Linux/KDE
- Dual-view interface: Side-by-side G-Code editor and interactive 3D canvas visualization
- Bidirectional sync: Click a line in the editor to highlight the corresponding path on the canvas, and vice versa
- Advanced multi-selection workflows: Ctrl-click and Ctrl-drag to add or remove multiple semantic line ranges directly in the editor
- Multi-dialect support: GRBL 1.1 / 1.1H / 1.1j, LinuxCNC, and Marlin with auto-detection and per-dialect command validation
- Syntax highlighting: Color-coded G/M commands, axis words, arc parameters, feed rate, and comments
- Contextual hover tooltips: Hover any token in the editor to see its value and any analysis issues for that line
- Comment browser: Instant navigation to named operations/sections exported by CAM software
- Workpiece size analysis: Automatic bounding box calculation and workpiece dimension display
- Coordinate origin display: Visual indicator for the work coordinate origin
- Warnings and hints: Dialect compatibility errors, missing origin detection, feed rate checks
- Optimization hints: Detects redundant rapids, repeated tool changes, and other inefficiencies
- View cube: Clickable orientation cube to snap to standard orthographic views
| Component | Technology |
|---|---|
| Language | Python 3.10+ |
| GUI | PyQt6 |
| Numerics | numpy |
| Testing | pytest |
Official downloadable builds are available on the GitHub Releases page:
https://github.com/dasarne/gcode-lisa/releases
Linux, Windows, and macOS packages are attached directly to each release.
Development and nightly CI artifacts are additionally available here:
https://github.com/dasarne/gcode-lisa/actions/workflows/build.yml
git clone https://github.com/dasarne/gcode-lisa.git gcode-lisa
cd gcode-lisa
# Create and activate a virtual environment (required on Arch Linux and
# any distribution that enforces PEP 668 / externally-managed-environment)
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m src.mainRegister launcher + file associations for *.gcode and *.nc:
chmod +x scripts/install_linux.sh scripts/uninstall_linux.sh
./scripts/install_linux.shRemove registration:
./scripts/uninstall_linux.shArch Linux note: Arch enforces the "externally managed environment" policy (PEP 668), which prevents system-wide
pip install. Always activate the.venvfirst.
The project is organized into focused modules:
src/
├── gcode/ # G-Code parsing, tokenization, GRBL command definitions
├── geometry/ # Coordinate transforms, bounding box, tool-path building
├── analyzer/ # Version compatibility warnings and optimization hints
└── ui/ # PyQt6 dual-view main window, editor panel, canvas panel
See ARCHITECTURE.md for the full design document.
See DEVELOPMENT.md for environment setup, testing, and code style guidelines.
| Shortcut | Action |
|---|---|
Ctrl+N |
New window |
Ctrl+O |
Open file |
Ctrl+S |
Save file |
Ctrl+Z |
Undo |
Ctrl+Y |
Redo |
Ctrl+F |
Find |
Ctrl+H |
Find & Replace |
Ctrl+I |
Open Messages dialog |
Ctrl+Q |
Quit |
Ctrl+Click |
Add/remove semantic line selections |
Ctrl+Drag |
Paint multi-line semantic selections |
Note: This project uses an AI-assisted development workflow where GitHub Copilot coding agent implements features described in structured issues, guided by skills and architecture documents.
- Fork the repository
- Create a feature branch (
git checkout -b feature/my-feature) - Make your changes following the code style guidelines in DEVELOPMENT.md
- Run tests:
pytest tests/ - Submit a pull request using the PR template
GCode Lisa is maintained as an independent project. Reliable, practical CNC software in the open-source ecosystem depends heavily on private engagement: time for bug fixes, user support, compatibility updates, and long-term care.
If you want to support ongoing development, you can sponsor the project here:
