Dusty Manual
Everything Dusty does, in the order you use it: draw or import, choose the operations and tools, check the preview, then save the G-code or drive the CNC directly.
Dusty prepares and runs the machining of your parts on a CNC milling machine (a computer-controlled router): you draw or import shapes, you describe how to machine them with operations (profile, pocket, drill…) and tools, you check the preview, then you save the G-code or drive the machine directly. This manual follows that path, from your first part to the fine settings of the controller.
Dusty runs on Mac (macOS 14 or later), on iPad (iPadOS 17 or later), in a web browser (Dusty Studio) and as a desktop app for Windows and Linux. Drawing, operations, toolpaths, simulation and G-code are computed by the same core everywhere; what differs from one platform to another is described in Dusty Studio and desktop app and On iPad; what each one needs: System requirements.
Finding help
F1 opens this manual at the topic of what you are doing (drawing tool, tool under the pointer, panel, selected operation, open window), even while typing; the ? buttons of panels and windows lead to their topic; Help › Dusty Manual (⌘?) opens it at the beginning. The search field at the top of the contents filters the topics and highlights the word you look for; the Collection choice just below keeps only the topics of one theme in the contents (see Collections). Help › Guides leads to the machining concepts, the Coming from laser software page, the workholding guide and the specifications. When a result is not right, Help › My Machining Is… starts from what you observe to suggest causes and settings to change (My Machining Is…).
Safety first.
A spinning bit cuts skin as easily as wood, throws chips and can tear out a badly held part. Wear safety glasses, keep your hands out of the work area while the spindle turns or the machine can move, never leave a job running unattended, and keep a stop within reach: STOP in Dusty (⌘. or the red button) and the machine’s emergency stop. See Safety.
All topics
-
What’s New
What the first public release brings compared with the test versions, each feature linked to the topic of the manual that explains it.
-
Collections
Read the manual by theme: getting started, understanding machining, coming from laser, holding the work, preparing a job, running the machine, series and solving a problem.
-
Safety
The rules that protect you at a desktop CNC — spindle, eyes, hands, workholding, STOP and emergency stop — and the safeguards Dusty adds on its own.
-
System requirements
The minimum and recommended setup for each platform, the controllers Dusty drives over USB or the network, and what Dusty Link needs to share a machine.
-
Specifications
What Dusty does today, the features announced with no promised date, and what is deliberately not planned for this 2.5D CAM software.
-
Getting Started
The welcome tour that sets up your machine, a guided look at the window, a first part step by step, the iPad app, beginner mode and advice for laser users.
-
Tutorials
Eight example projects for a 3018-type hobby CNC, each rebuilt step by step from a blank page to the G-code, then sent to the machine.
-
Concepts
The basic ideas of CNC machining explained once: toolpaths and G-code, router bits, tool side, cut direction, feeds and chip load, stepover, zeros and heights.
-
The project
Everything a .dusty file holds — drawing, stock, tools and operations — and how to set the stock, origin, Z zero and heights, with templates, pages and notes.
-
Drawing
Draw the shapes to machine: drawing tools, text and fonts, variable text and barcodes, single-line fonts, node editing, fillets and dogbones, measuring and display.
-
Editing and arranging
Select, align, combine, offset, warp, repeat and nest shapes, clean up imported paths, and trace images into shapes ready for machining.
- Selection and inspector
- Undo history
- Calculations in fields
- Arranging
- Shape operations
- Offset
- Optimize shapes
- Warp
- Resize slots
- Arrays
- Virtual arrays
- Copy along a path
- Nesting
- Cleaning up paths
- Tracing an image
- Center line and one-pass engraving
- Images and masks
- Image masks
- 3D models and depth maps
- Depth map settings
-
Paint colors
Each shape has a paint color that groups the shapes of one machining step: an operation can machine all the shapes of its color, even those added later.
-
Importing and exporting
Bring in drawings from SVG, DXF, PDF, AI, HPGL, LightBurn or MillMage, use web generators and the art library, then export the drawing or print it at scale 1.
-
Machining operations
Tell Dusty what to machine and how: profile, pocket, V-carving, chamfer, drilling, boring, surfacing, fluting and texturing, with tabs, entries and trochoidal paths.
- Creating an operation
- Common settings
- Profile
- Tabs
- Start point and direction
- Rest pocket
- V-carving
- Chamfer
- Dogbone slot
- Drill
- Bore
- Surfacing and face
- Fluting
- Texturing
- 3D relief roughing
- Entering the material
- Trochoidal path
- Machining order
- Operations library
- Open shapes: machining them as a profile
- Not available yet
-
Cutting tools
The router bits of a project and their dimensions, the tool library with its starter set, and the calculator that suggests feeds and speeds by material.
-
Preview
Compute the toolpaths and simulate the job with the active machine's kinematics: estimated time, top and 3D views, machined part, 3D check and pre-send check.
-
G-code
Save the G-code for your controller with flexible file names, open and replay a program, choose the flavor, arcs and post-processor options, and write custom blocks.
-
Workholding
How to hold the stock down on a desktop CNC: screws, clamps, tape, glue, jigs, brads, vacuum and vise, their limits, and what to check before starting.
-
The machine
Connect and drive a GRBL, grblHAL or FluidNC machine: catalog and settings, connection assistant, jog and homing, zeros and probing, jobs, tool changes and safety.
- Machines and catalog
- Adding a machine
- Machine settings
- Connection
- Connection assistant
- Other controllers: Duet, Smoothieware, Marlin, FluidNC over WebSocket
- Duet board (RepRapFirmware)
- Smoothieware
- Marlin
- FluidNC over WebSocket
- Virtual CNC
- The Machine panel
- Control mode
- Jogging and homing
- Work zero
- Go to
- Probing
- Center finder
- Tool length sensor
- Surface leveling
- Position check
- Dimension calibration
- Running a job
- Pause, stop and STOP
- Tool change
- Tool table and automatic tool changer
- Resuming an interrupted job
- Spindle, accessories and overrides
- Controller settings
- No-go zones
- Positions and macros
- SD card
- Console
- Incident cards
- Machining log
- Hour counter and maintenance
-
My Machining Is…
Start from what you see — burnt edges, rough finish, broken bit, wrong dimensions, steps, alarms — and get the likely causes, the checks to make and the settings to change.
-
Dusty Studio and desktop app
The desktop app for Windows and Linux, and Dusty Studio, the same Dusty in a browser window: their menus, the Machine tab, and what differs from the Apple app.
-
Dusty Link and Hub mode
Share a USB CNC on the workshop network from a Raspberry Pi, an old PC or the desktop app in Hub mode, and drive it from an iPad, another computer or a phone.
-
Assistant (MCP)
A conversational assistant such as Claude can prepare projects through MCP — shapes, tools, operations, checks, export — but never controls the machine.
-
Settings
All app settings by section — interface, project, machining, canvas, display, drawing, text, import, statistics, maintenance — with their default values.
-
Feedback, updates and statistics
Send feedback by email, rate Dusty, get updates from the App Store or the desktop app check, and see exactly what the anonymous statistics send.
-
Keyboard shortcuts
The full list of shortcuts — files, editing, arranging, preview, machine, canvas tools, jog keys — and how to change them in the shortcut editor.
-
Troubleshooting
Quick answers when the machine does not answer, is locked, refuses a job, stops on an error, cuts at the wrong depth or size, and how to report a problem.
This manual is also built into Dusty: press F1, or open the Help menu, to read the topic for what you are doing. A mistake, a missing answer? Tell us
Try it in Dusty, for free.
Free CNC milling software: design, toolpaths and machine control. Mac, iPad, iPhone, Windows and Linux.