CNC Control · Setup & User Guide

Control your machine
from your phone.

CNC Control turns a phone or tablet into a wireless jog pendant and macro pad for your CNC, laser, or router. To get started you set up one bridge between the app and your machine - either the Windows receiver or an ESP32 dongle.

PLATFORM · Android app BRIDGE · Windows or ESP32 LINK · Wi-Fi (PC) / BT or Wi-Fi (ESP32)
01

Choose your bridge

The app needs something on the other end to receive its commands. Pick whichever suits your setup - you only need one.

02

Windows Receiver

The quickest route. Download the receiver, run it, and let the app find it on your network.

1

Download the receiver

Grab the build that matches your Windows version.

CncReceiver.zip github.com/DnG-Crafts/CNC-Control · /releases/WIN Vista / 7 / 8 / 10 / 11 CncReceiver.zip github.com/DnG-Crafts/CNC-Control · /releases/WIN-XP Windows XP
2

Unzip and run it

Extract the archive and launch the app. It tucks itself into the notification area, down near the clock - no main window.

3

Optional: start with Windows

Right-click the tray icon and tick “Start with Windows” so the receiver is always ready after a reboot.

4

Discover it from the app

With the receiver running, open CNC Control and find it under Wi-Fi.

Same network The PC and your phone/tablet must be on the same Wi-Fi network for discovery to work.
Windows receiver notification-area menu showing the listening IP address and the Start with Windows option
The receiver lives in the tray - it shows its IP and listening port here.
03

ESP32 Dongle

For the hardware route you need an ESP32-S2 or ESP32-S3 board or dongle. It emulates a real USB keyboard to the target machine, then talks to your phone over Bluetooth or Wi-Fi.

Step 1 · Flash the firmware - pick a method

Option A · Manual

Download & flash

Grab the firmware binary and flash it with your own tool.

github.com/DnG-Crafts · /releases/ESP32 →
Option B · Browser

Web flasher

Flash straight from a Chrome-based browser over USB - no install.

d-n-g.github.io/flasher.html →
Option C · In-app

Flash from the app

Plug the ESP32 into your phone/tablet (USB-OTG) and flash from CNC Control itself.

Menu → Flash ESP32 Firmware
CNC Control web-based firmware flasher with target chip and baud rate selection
Option B - the browser flasher.
Flash ESP32 Firmware screen inside the CNC Control app
Option C - flashing inside the app.
2

Plug it into the machine

Once the firmware is on the ESP32, unplug it from the flashing source and connect it to your target machine.

3

Connect from the app

Open CNC Control and connect to the dongle over Bluetooth or Wi-Fi.

Bootloader didn't respond? If flashing fails with that message, hold the BOOT button on the ESP32 while you plug it in, then try again.
Choosing a chip The flasher offers Auto-detectESP32-S2 and ESP32-S3. Leave it on auto-detect unless flashing fails, then select your exact board.
04

Connect & the app menu

However you bridged in, the app menu is mission control - connection, machine profiles, layout and firmware all live here.

1

Open the menu

Tap the menu icon (top-left). Every setting lives in here.

2

Pick your connection type

Choose how to connect, then tap the connection row to link up. The Windows receiver is Wi-Fi only; an ESP32 dongle can use Bluetooth or Wi-Fi. Configure lets you set the IP and port manually.

3

Jump to setup tools

From here you reach Edit Layout, Key Bindings, and Flash ESP32 Firmware - covered next.

CNC Control app menu showing machine profile, connection type, layout and firmware options
The menu - profile, connection, layout and firmware in one place.
05

Profiles, layout & key bindings

Build a control surface for each machine: create profiles, drag buttons into place, and map each one to the keyboard shortcut your software expects.

Machine Profiles screen with multiple profiles and a New Profile button
Keep a separate profile per machine - router, laser, and so on.
1

Create machine profiles

Add a profile per machine and switch between them. The active profile drives the buttons you see. Tap + New Profile to add one, or select an existing profile to edit or remove it.

2

Edit the main layout

Enter edit mode to drag buttons to reposition them on the grid, resize them, and tap the pencil to edit. Use + Add for new buttons and Done when finished.

Layout edit mode showing draggable buttons on a grid
Drag to reposition, tap the pencil to edit a button.
Edit Buttons list showing each button with its key binding
Every button and the shortcut it sends, in one list.
3

Edit key bindings & buttons

Open the button list to add or remove buttons and see each one's key binding at a glance - e.g. Alt+F for Frame, Alt+S for Start.

4

Tune a single button

Tap a button to set its label, colour and width, and to define the exact key binding - including modifiers like Ctrl, Shift, Alt, GUI and Num.

Edit Button dialog with label, colour, width and key binding fields
Per-button editor - set the key combo and modifiers.
That's the whole loop Pick a binding that matches a shortcut your CNC/laser software already responds to, save the button, hit Done, and the new control is live on your pendant.