Candle

GRBL controller application with G-Code visualizer written in Qt.

Supported functions:

Controlling GRBL-based cnc-machine via console commands, buttons on form, numpad.
Monitoring cnc-machine state.
Loading, editing, saving and sending of G-code files to cnc-machine.
Visualizing G-code files.

System requirements for running "Candle":

Windows/Linux (Ubuntu)/macOS/Raspberry Pi OS (Trixie)
CPU with SSE2 instruction set support
Graphics card with OpenGL 2.0 support
120 MB free storage space

Downloads

Latest release versions:

Releases

Nightly build versions:

Nightly

Previous versions:

For GRBL v1.1 firmware

Windows: candle_1.1.7.zip
Linux: candle_1.1.7.tar.gz

For GRBL v0.9 and below

Windows: candle_1.0.11.zip
Linux: candle_1.0.11.tar.gz

Build instructions (Windows)

Install cmake
Install vcpkg

git clone https://github.com/microsoft/vcpkg.git
vcpkg\bootstrap-vcpkg.bat

Set environment variable

CMAKE_TOOLCHAIN_FILE={PATH_TO_VCPKG}/scripts/buildsystems/vcpkg.cmake

Get Candle sources

git clone https://github.com/Denvi/Candle.git
cd Candle

Install packages

vcpkg install

Build and install

mkdir build; cd build
cmake .. -DCMAKE_INSTALL_PREFIX="$(pwd)/Candle"
cmake --build . --config=Release
cmake --install .

Executable can be found in build/Candle directory.

Build instructions (Ubuntu, Raspberry Pi OS Trixie, Fedora 43)

Install packages

For Ubuntu, Raspberry Pi OS Trixie users:

sudo apt update
sudo apt install cmake build-essential qtbase5-dev libqt5serialport5-dev qtscript5-dev qttools5-dev libqt5websockets5-dev qtmultimedia5-dev

For Fedora users:

sudo dnf update
sudo dnf group install development-tools
sudo dnf install cmake qt5-qtbase-devel qt5-qtserialport-devel qt5-qtscript-devel qt5-qttools-static qt5-qttools-devel qt5-qtwebsockets-devel qt5-qtmultimedia-devel

Get Candle sources

git clone https://github.com/Denvi/Candle.git
cd Candle

Build and install

mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX="~/programs/Candle"
cmake --build . --config=Release
cmake --install .

Executable can be found in ~/programs/Candle directory.

Before creating new issue

Candle works with CNC controlled by GRBL firmware, many problems can be solved by using proper version of GRBL, using proper configuration.

Please read GRBL wiki:

GRBL v0.9-: https://github.com/grbl/grbl/wiki
GRBL v1.1: https://github.com/gnea/grbl/wiki