Dusty Manual
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.
What's New
Version 1.0, the first public release of Dusty. Compared with the test versions (0.5), it brings:
- This built-in manual, in English and French, with search, the F1 key and the "?" buttons — see the introduction.
- 3D toolpath view in the preview, alone or next to the top view, with the same time slider and playback — see Top view and 3D view.
- Seven new operations: rest pocket, V-carving, chamfer, dogbone slot, bore, surfacing and face — see Machining operations.
- Custom G-code per machine: start, end, tool change, spindle and accessory blocks, with variables, optional values and mode macros — see Custom G-code.
- "My Machining Is…" assistant: from the symptom to the likely causes and the right settings — see My Machining Is….
- Safe workshop: no-go zones with a fly-over height, checked along the whole path ("cannot be checked" is never "OK"), hour counter and maintenance reminders, macro shortcuts.
- Machines: catalog of 67 commercial machines, grblHAL and FluidNC controllers, controller settings with automatic backups, resuming an interrupted job, saved positions, macros, SD card, XYZ probing, tool length sensor, a machining log that learns the real duration — see The machine.
- Machine extras: "Go to" along a safe path checked against the travel, keyboard jog, center finder, tool length sensor measured during the job, profile export and import, pre-start checklist, debug log — see Go to, Center finder and Tool length sensor.
- Connection assistant: ports, USB adapter driver, speeds, controller greeting and stability tried in one go, what is missing explained, then the machine's model suggested — see Connection assistant.
- Drawing commands: weld, cut with a shape, triangle and stars, selections (open shapes, shapes inside, smaller shapes, circles by diameter), path clean-up (close, join, duplicates), dock, move together, same size, two-point rotation, mirror across a line, lock, Duplicate with Operations — see Editing and arranging.
- Tabs and start point: Tabs tool and tab assistant with a preview on the canvas, Start Point tool and Reverse Direction, full context menu of the operations, chip load, cut direction diagram and pattern thumbnail in the operation editor — see Tabs and Start point and direction.
- Node editing: node bar, node mode keys, bending a segment by dragging it, joining end nodes by dragging one onto the other; Radius tool with fillets, notches, dogbones and T-bones, and dogbones added in one go to every inside corner at the tool radius — see Editing nodes and Radius, notches and dogbones.
- Editing sheets with a preview: offset, optimize shapes, Boolean assistant, grid and circular arrays, mirror across a line and image tracing, with the result drawn on the canvas before you confirm — see Offset, Arrays and Tracing an image.
- Drawing interface: several pages per project (each with its stock and operations), undo history, project notes shown on opening, rulers and guides, filled or wireframe shapes, transform toggles and shear handles, a status bar with the selection bounds and the tool tips, color palettes for Inkscape, Illustrator or CorelDRAW — see Pages, Undo history and Rulers, guides and display.
- Drawing export to SVG, PDF, DXF and DXF R12 — see Exporting the drawing.
- Dusty Studio and the desktop app (Windows, Linux): design, operations, preview, G-code and machine control over USB (and over the network in the desktop app), with the machine features of the Mac app (XYZ probing, controller settings, resume, positions and macros, framing and dry run, SD card, log) — see Dusty Studio and desktop app.
- Feedback and updates: send feedback, check for new versions in the desktop app, anonymous usage statistics that you can turn off — see Feedback, updates and statistics.
- Getting started: step-by-step assistant for a new project, beginner mode, language choice, shortcut editor, remembered layout, exported and backed-up settings, system clipboard, DXF and SVG import options, DXF export with native arcs — see Project assistant, Beginner mode and Settings.
- Drawing finishing touches: undo across page changes, corner radius handle, tabs dragged along their shape, a text's path selected on its own, simplified offset, open shapes of pockets reported, 1.5° and 45° rotation from the keyboard, “bigfont” SHX fonts, iPad keyboard on the canvas — see Pages, Drawing tools, Tabs and Text on a path.
- Example projects and tutorials: eight ready-to-machine projects for a 3018-type CNC, with their notes, and their step-by-step tutorials; welcome tour at first launch; system requirements — see Tutorials, Welcome tour and System requirements.
Collections
The manual can also be read by collections: reading paths that gather, in a useful order, the topics of one theme. Choose a collection at the top of the contents: only its topics stay there and the page goes to the first one; the search still covers the whole manual. Whole manual brings back the full contents.
- Getting started: Safety, System requirements, First-launch tour, Dusty's screen, First part step by step, Beginner mode, Example projects, Before sending an example to the machine.
- Understanding machining: Concepts, From drawing to G-code, Router bits, Tool side, Cut direction, Feed, speed and chip load, Stepover and depth per pass, Origin, zeros and coordinates, Heights and rapid moves.
- Coming from laser: Coming from laser software, Importing, Paint colors, Creating an operation, Tool side, Radius, notches and dogbones, Tabs, Workholding.
- Holding the work: Workholding, Choosing and checking, Screwing to the spoilboard, Clamps, Double-sided tape, Masking tape and cyanoacrylate glue, Jigs and indexing fixtures, Machinable brads, Vacuum table, Table-mounted vise, Through cuts, Travel heights, Running a job.
- Preparing a job: Project setup, Origin and Z zero, Creating an operation, Common settings, Project tools, Feeds and speeds calculator, Preview, 3D check, Pre-send check, Saving the G-code.
- Running the machine: Connection, Connection assistant, The Machine panel, Moving and homing, Work zero, Probing, Running a job, Pause, stop and STOP, Tool change, Resuming an interrupted job, No-go zones, Hour counter and maintenance, Dusty Link and Hub mode, Joining a shared machine.
- Series and production: Pages, Variable text, Barcodes and QR codes, Virtual arrays, Nesting, Operation library, Project templates, Jigs and indexing fixtures.
- Solving a problem: My Machining Is…, Preview troubleshooting, Incident cards, Console, Troubleshooting, Debug log, Support data.
Safety
A desktop CNC is still a machine tool. Dusty adds many safeguards, but none of them replaces your attention.
- Spindle: never touch the bit, even slowly; wait for a full stop before reaching in. Tie back long hair, roll up sleeves, remove jewelry and gloves near a spinning tool (a glove can be pulled in).
- Eyes, ears, lungs: safety glasses at all times; hearing protection for long jobs; dust extraction or a mask (MDF makes a lot of fine dust).
- Hands: out of the work area as soon as the machine is connected and can move (jog, framing, job).
- Stopping: STOP (⌘. on Mac, Ctrl+. in Studio on Windows and Linux, or the red button that is always visible while a machine is connected) resets the controller at once: motion interrupted, job abandoned, spindle and coolant off. It is a software stop: also keep the machine's emergency stop (or its power switch) within reach. See Pause, stop and STOP.
- Never unattended: stay near the machine for the whole job. Wood can heat and scorch, a bit can break, a part can come loose.
- Workholding: clamp the stock firmly (screws, clamps, double-sided tape), clamps outside the toolpaths, and a safe height above anything that sticks up. Fit and remove clamps, screws and parts with the spindle stopped, never with a hand near the bit. See Workholding and Travel heights.
- No-go zones: draw clamps and the vise, with their height: Dusty refuses paths that cross them, and blocks what it cannot check. See No-go zones.
- First run of a project: frame the job to check its position, do a dry run (the job played above the stock, spindle off), then start with the feed rate halved (feed override at 50%).
What Dusty does to protect you: explicit confirmation before any spindle start, job start or resume; a pre-send check that blocks dangerous programs; continuous jogging stops if the interface no longer responds; a controlled stop when the connection is lost or the window closes during a job; macros and console commands checked before they are sent.
System requirements
Dusty computes everything on the device (drawing, toolpaths, simulation, G-code): only the anonymous statistics and, in the desktop app, the update check go over the Internet, and both can be turned off. The table gives what the code requires (minimum) and what makes it comfortable to use (recommended).
| Platform | Minimum | Recommended |
|---|---|---|
| Mac | macOS 14 Sonoma; Intel or Apple silicon Mac (Metal rendering, available on every Mac that runs macOS 14) | Apple silicon Mac (M1 or later), 8 GB of memory, display of 1440 × 900 points or more |
| iPad | iPadOS 17 (every iPad that runs it); the app also installs on iPhone (iOS 17), whose screen is too small to draw comfortably | iPad with an A12 chip or later, keyboard and trackpad for precise drawing; network machine (the iPad has no serial port) |
| Windows | 64-bit Windows 10 (x86-64) with WebView2 (built into Windows 11, installed by Windows Update on Windows 10) and a WebGL2 graphics card | Windows 11, processor from 2015 or later, 8 GB of memory, 1920 × 1080 display |
| Linux | 64-bit distribution (x86-64) with WebKitGTK 4.1 (Ubuntu 22.04, Debian 12, Fedora 38 or later) and WebGL2 | Ubuntu 24.04 or equivalent, 8 GB of memory, graphics acceleration enabled |
| Browser (Dusty Studio) | Up-to-date browser with WebAssembly and WebGL2: Chrome, Edge, Firefox or Safari, on a computer | Up-to-date Chrome or Edge: WebGPU for drawing and the 3D view, WebSerial to drive the machine over USB |
- Display: the desktop app window is at least 900 × 600 pixels; the inspector needs about 320 points of width next to the canvas.
- Driven machine: GRBL 1.1, grblHAL or FluidNC controller, over USB (serial port) or the network (Telnet: Mac and iPad app, desktop app). A USB data cable; on Windows, the driver of the board's USB adapter (CH340, CP210x); on Linux, the right to open the port (
dialoutgroup). For other controllers, save the G-code and send it with their own software. Everything can be tried without a machine on the virtual CNC. - USB in the browser: WebSerial only exists in Chrome and Edge (and browsers derived from them) on a computer, for a page served over HTTPS. Firefox and Safari draw, compute and save the G-code, but do not drive the machine; no browser opens a network connection to it (see In the browser).
- Rendering: Metal on Mac and iPad; WebGPU, otherwise WebGL2, in Dusty Studio and the desktop app (WebGL2 on Linux, through WebKitGTK). Without graphics acceleration, software rendering works, slowly.
- Known measurements (M1 Mac): the 3D view draws 2 million segments in 13 to 15 ms per frame; the machined part of a 21,500-segment job on a 300 × 200 mm stock is computed in 5 to 84 ms depending on the detail, and each frame in 4 to 9 ms; a 500-character text is computed for V-carving in a little over one second. The simulation keeps at most 32 MB of snapshots.
- Tests: the desktop app was tried on Windows 10 Pro (2013 Core i7 processor, WebGL2) and on Ubuntu 25.04 (WebKitGTK 2.50); the smoothness of the simulation on iPad is not measured yet.
- Dusty Studio downloads the Dusty core (a few compressed megabytes) on first load, then works offline; its settings and its machine list stay in the browser.
- Dusty Link (machine shared on the local network): any Raspberry Pi (from the Pi 1 and Zero to the Pi 5) or ARM board under 32- or 64-bit Linux, or a 64-bit Linux PC, with systemd; or 64-bit Windows 10. A few megabytes of memory, the CNC over USB (or the network) and the workshop's local network; see Dusty Link and Hub mode.
Specifications
What Dusty does today, what is announced and what is not planned. Announced features are intentions, with no promised date: their order may change with your feedback (see Feedback, updates and statistics).
What Dusty does
| Area | Features |
|---|---|
| Platforms | Mac (macOS 14 or later), iPad (iPadOS 17 or later: touch, Apple Pencil, multiple windows and Stage Manager, see On iPad), web browser (Dusty Studio), desktop app for Windows and Linux; the same computing core everywhere; French and English. See System requirements. |
| Drawing | Shapes, nodes, text (computer fonts, single-line, SHX), text on a path, variable text and CSV merge, barcodes and QR codes, boolean operations, offset, fillets, notches and dogbones, arrays (grid, circular, virtual, along a path), nesting, pages, images, masks and tracing. |
| Files | .dusty projects and templates; import of SVG, DXF, PDF, AI, EPS, HPGL / PLT, images, LightBurn and MillMage projects; export to SVG, PDF, AI, DXF and DXF R12; printing; art, tool and operation libraries; user packages. |
| Operations (2.5D) | Profile (outside, inside, on the line, with tabs), pocket, rest pocket, V-carving, chamfer, dogbone slot, drilling and peck drilling, boring, surfacing, fluting, texturing; trochoidal toolpaths; plunge, ramp, spiral or helix entries; feeds and speeds calculator. |
| Preview and simulation | Top view and 3D view, simulated machined part with stock textures, 3D check (holder and shank collisions, rapids into the material, plunges too fast, air cutting), pre-send check, estimated duration then learned from the machining log. |
| G-code | 14 flavors (GRBL, grblHAL, FluidNC, GRBL-STM, Smoothieware, Marlin, Duet, LinuxCNC, Mach3 / Mach4, UCCNC, MASSO, Centroid, generic), arcs or segments, custom G-code, one file or one per tool, opening and replaying a program. See G-code flavors. |
| Machine | Direct control of GRBL 1.1, grblHAL and FluidNC over USB, and over the network (Telnet) on Mac, iPad and the desktop app; built-in virtual CNC; jog, zeros, XYZ probing, tool length sensor, center finder, surface leveling, position check, calibration, tool change and grblHAL tool table, job resume, controller settings with backups, positions and macros, SD card, machining log. |
| Network | Dusty Link: the CNC shared on the local network by a headless Raspberry Pi or PC, or by the desktop app in Hub mode; pairing, job queue, confirmation on the sending device, remote tool change and pause, Dusty Studio served; mobile pendant (jog, zero, probing, start, pause, stop and overrides from a phone, with nothing to install). Assistant (MCP) that prepares projects, never the machine. |
| Help | This manual (F1, ? buttons, collections, concepts, workholding guide), tour and example projects, My Machining Is… assistant, preview troubleshooting, debug log, support data. |
Announced features
| Feature | What it will bring |
|---|---|
| More controllers driven directly | Duet / RepRapFirmware over HTTP, Smoothieware, Marlin, FluidNC over WebSocket; tool changer tests on a real grblHAL board. |
| 3D relief | 3D models (STL, OBJ, 3MF…) as depth maps, relief roughing and finishing, inlays, rotary A axis in indexing. |
| Later | Camera and photo of the stock, automation, more controllers (Buildbotics, remote LinuxCNC), plotter, knife and plasma modules. |
Not planned
- Simultaneous 4- or 5-axis machining and lathes: Dusty stays a 2.5D CAM, soon with three-axis 3D relief and a rotary axis in indexing.
- Laser engraving and cutting in Dusty: a router and a laser need different settings; the GRBL laser mode (
$32=1) is even blocking for a router (see Connection). For laser work, use laser software; a LightBurn project opens in Dusty (see Coming from laser software). - Online account, subscription, cloud storage: Dusty is free, with no account; your projects and settings stay on your device. Only the anonymous statistics (which can be turned off) and, in the desktop app, the update check use the Internet.
- Automatic sending of reports: the support data never leaves on its own; you attach it to a message yourself.
- Driving 3D printers: Dusty prepares and drives subtractive machining only.
Getting Started
Welcome tour
At first launch, Dusty opens a short animated tour (full screen on iPad, on iPhone and in a narrow window): a welcome screen where the Dusty symbol draws itself, then four steps. It is the same in the Mac, iPad and iPhone app, in Dusty Studio and in the desktop app.
- From drawing to part: the four moves, always in the same order — draw, choose the operations, check the preview, machine on the machine.
- Your machine: the preset CNC 3018, a machine from the catalog (manufacturer then model, see Machines and catalog) or no machine yet (a placeholder machine; the virtual CNC lets you try everything). When a machine is already set up, the tour offers to keep it. When you continue, the chosen profile is saved and becomes the active machine: nothing is connected, nothing moves, the spindle stays off.
- Safety first: protection, clamping, dry run, supervision, STOP and the emergency stop.
- You're all set!: where to start — Open an Example Project (recommended, see Example projects), Project Assistant (see Project assistant), Blank Page, and Connection Assistant (see Connection assistant) when the machine can be driven and is not connected yet; below, the beginner mode and usage statistics, which you can change later in Settings.
Continue (Return) goes to the next step, Back goes back and keeps your choices; Skip (Escape) closes the tour at any time — without a machine, Dusty asks for one afterwards. The animations follow the system's “Reduce Motion” setting (and, in Dusty Studio, the one in Settings): each scene is then shown in its final state right away. The tour does not come back by itself: Help › Dusty Tour opens it again (More › Dusty Tour on iPad and iPhone; also on the Dusty Studio start screen). If you had seen the former four-screen tour of Dusty Studio, you see the new one once.
In Dusty Studio and the desktop app: the ← and → arrow keys go back and forward, Tab moves from one choice to the next without leaving the tour, F1 opens this topic; each scene is described to screen readers and the progress is written out (“Step 2 of 4”). On the first visit, the generic CNC 3018 added by default gives way to the machine you choose (keeping the CNC 3018 changes nothing). Beginner mode can then be changed in the View menu, usage statistics in the Help menu.
Dusty Studio and desktop app start screen: at launch, as long as no project is open (a project opened from the system is shown directly), and after File › Close Project (after confirmation if the project has changed). On the icon's paper color in light mode and its graphite in dark mode: the Dusty symbol and name, then New Project, Example Projects and Open… (with their shortcuts), your recent projects (desktop app; Chrome and Edge in the browser), the Dusty Tour, the Manual and the language choice. Dropping a project or a drawing on the window opens it too. It fits in a narrow window (Dusty Studio opened on a phone): the actions stack one under the other.
iPad and iPhone launch screen (iPadOS and iOS 18 and later): the Dusty symbol and name, New Project, Example Projects (a new project that offers the examples right away), then your projects below.
The Dusty window
Each project opens in its own window:
- Canvas in the middle: the work area has the size of the stock; the origin marker (teal ring, red X arrow, green Y arrow) shows the point where you will set zero on the machine.
- Drawing tools in the floating column on the left of the canvas; view controls (zoom out, zoom in, zoom to stock) at the bottom right.
- Paint colors below the canvas, then the status bar: pointer position measured from the project origin, zoom, number of shapes, and the number of shapes without an operation (they will not be machined).
- Toolbar: Import, Arrange, Shapes (operations on shapes and paths), New Operation, Toolpaths (shows the toolpaths on the canvas), Preview, G-code, Inspector. While a machine is connected, its state and the STOP button are added, whatever panel is shown.
- Inspector on the right, with five panels chosen by the icons at the top: Shapes (selection, text, colors), Project (stock, origin, heights), Operations, Tools, Machine. The ? button next to the panel title opens its topic.
- Menus (Mac): File, Edit, Drawing, Arrange, Operations, View, Machine, Window, Help. On Mac, the machine list, the console, the controller settings and this manual open in separate windows.
First part step by step
Example: cut an 80 × 50 mm rectangle out of a 6 mm plywood offcut with a 3.175 mm end mill. Try it first on the virtual CNC: everything works without a machine.
- Machine: at first launch, Dusty asks for a machine. Choose Add My CNC… (assistant, see Adding a machine) or Use a Dummy Machine to start without a machine.
- Project: File › New (⌘N). The New Project window opens: stock 120 × 80 × 6 mm, origin Bottom left corner, Z zero Top of stock, then OK. See Project setup.
- Drawing: Rectangle tool (R), drag on the canvas, then type the exact width and height in the Shapes panel. Or import an SVG (⌘I).
- Tool: Tools panel › Add Tool › From Library › a 3.175 mm end mill. Its feeds and speeds will go into the operation.
- Operation: select the rectangle, then Operations › New Operation › Profile. In the Operations panel: side Outside, final depth 6.2 mm (slightly more than the thickness, to cut through), depth per pass 1.5 mm, Tabs checked so that the part stays held. See Profile and Tabs.
- Preview: ⌥⌘P. Read the estimated time and the pre-send check; only the warnings about going into the spoilboard (0.2 mm below the stock) are expected here. See Preview.
- On the machine: clamp the stock, connect the machine (Machine panel), home it if it has limit switches, bring the tool above the front left corner of the stock and set X and Y zero, then Z zero on the top of the stock (with a sheet of paper or by probing).
- Machine it: Frame… to see the footprint, then Start Job…: the pre-send check appears, then Start Machining… asks for your agreement (the spindle will turn). Stay near the machine, hand near STOP. See Running a job.
Without a machine connected to Dusty, save the G-code (⇧⌘E) and send it with the software of your choice: see Saving the G-code.
To go further, the tutorials rebuild eight ready-to-machine example projects step by step.
On iPad
The iPad app is the same as on Mac, adapted to touch:
- Canvas gestures: one finger draws and selects, two fingers move the view, pinch to zoom; double-tap a text to edit it; a long press opens the context menu (clipboard, lock, drawing order, new operation), like right-clicking on Mac.
- More menu (…) in the toolbar, handy without a keyboard: cut, copy, paste, duplicate (with or without the operations), delete, select all, invert selection, Select; undo history, project notes, rulers, filled shapes; export the drawing; project setup; settings; manual; My Machining Is…; licenses. The Arrange and Shapes menus of the toolbar match those of the Mac.
- With a keyboard, the Mac menu shortcuts work; hold ⌘ to see them. The canvas also receives its keys as on Mac, as soon as the project opens and after typing in a field, with no need to touch it first: tool letters, arrows, Delete, Escape, Tab, Space, node mode keys and Selection tool keys (",", ".", Shift + letter). Most iPad keyboards have no F1 key: the ? buttons and the More menu open this manual.
- The machine list, the console, the controller settings and the manual open as sheets.
- Apple Pencil: the Pencil draws precisely (a finger has wider hit areas). Double-tapping the Pencil (2nd generation) or squeezing it (Pencil Pro) switches from the drawing tool to the Selection tool, then back to the tool you left, depending on the iPad setting (Settings › Apple Pencil: “Switch to previous tool” or “Eraser”). With Only Draw with Apple Pencil (same setting), a finger moves the view instead of drawing. A Pencil hovering over the screen (compatible iPads) shows the crosshair, like a trackpad.
- Trackpad and mouse: buttons highlight under the pointer; the crosshair and snapping follow the hover.
- Multiple windows: open two projects side by side (Split View), or as many windows as you like with Stage Manager; each window can be resized. In a narrow window (or on iPhone), the inspector opens as a half-height sheet: the canvas stays visible and usable above it; drag the handle to enlarge it.
- Machine: the iPad has no serial port. Connect a network machine (GRBL over Wi-Fi or Ethernet, grblHAL, FluidNC), go through Dusty Link (a USB CNC on a Raspberry Pi or a computer in Hub mode; found with Bonjour), or try everything on the virtual CNC. On the first connection, the iPad asks for local network access: allow it (otherwise, Settings › Privacy › Local Network).
- While machining, the iPad screen stays on (job of the connected machine, or of a machine shared by Dusty Link). Keep Dusty in the foreground during a job sent by the iPad: iOS suspends a background app after about thirty seconds, and a suspended app no longer sends the G-code. If Dusty goes to the background, it pauses the job with retract (Z raised, spindle stopped) after 20 seconds and tells you when it comes back; resume it in the Machine panel. A job started through Dusty Link goes on without the iPad.
Beginner mode
Beginner mode simplifies Dusty while you find your way around. Turn it on in Settings › Interface, or in the Dusty menu (Mac) › Beginner Mode; in Dusty Studio, View › Beginner Mode. A “Beginner Mode” note appears under the project name in the title bar (Mac) and in the status bar (iPad, Studio).
In beginner mode:
- every new project opens on the step-by-step assistant;
- the Trim, Tabs and Start Point tools leave the tool column (and their keys do nothing);
- the Shapes menu of the toolbar gives way to the boolean assistant, which shows the result before you confirm;
- the operation editor hides the fine settings (clearing strategy, entry into the material, retracts, cut direction, coolant, dust collection…): they keep their value, by default the safest one.
Nothing is lost: when you turn beginner mode off, everything comes back as it was. The interface then differs from the screenshots in this manual.
Coming from laser software
Do you know laser cutting or engraving software? Many gestures carry over to Dusty: drawing, sorting shapes by color, framing the job, starting it, keeping the stop within reach. But a bit is not a beam: it has a diameter, it removes material as chips and it pushes the part around. What changes:
| With a laser | With a router and Dusty |
|---|---|
| The beam has almost no width: the cut follows the line. | The bit has a diameter (often 3 to 6 mm): its center runs beside the line, outside or inside the shape, or on the line (see Tool side). |
| Inside corners are sharp. | An inside corner keeps the bit radius; for a square part to fit in, add dogbones (see Radius, notches and dogbones). |
| Power and speed set the depth. | Depth is a dimension: final depth, depth per pass; the feed and the spindle speed set the cut (see Feed, speed and chip load). A thickness is cut in several passes. |
| A layer carries cut settings. | A paint color carries shapes; an operation (profile, pocket, drill, V-carve…) says how to machine them and with which tool (see Creating an operation). |
| Fill (scanning). | Pocket to clear an area to a depth, V-carving for crisp lines and letters, texturing for decoration. |
| The part stays put by its weight. | The bit pulls and pushes: the stock must be held down (see Workholding) and cut-out parts keep tabs until the end (see Through cuts). |
| Focus on the surface. | X, Y and Z work zero: the tool tip touches the top of the stock (or the spoilboard); the Z zero sets every depth (see Origin, zeros and coordinates). |
| A single "tool". | Several bits in one project, with a tool change between operations (see Tool change). |
| Smoke: extraction. | Chips and dust: dust collection, glasses, hearing protection (see Safety). |
What carries over: framing before starting and the dry run (see Running a job), the job preview, STOP always visible. A LightBurn project (.lbrn2, .lbrn) opens in Dusty: shapes, texts, images and layers arrive in the paint colors, the laser settings are left out (see Importing); you then choose the operations and the tools. A GRBL controller set up for a laser ($32=1) must go back to router mode before machining (see Connection).
First habits: measure the stock thickness and enter it in the project, hold the stock down, take the Z zero on the top, start with a 3 mm flat end mill, 1 mm passes in plywood, and do a dry run before the first cut. The Coming from laser collection (see Collections) gathers the topics to read next.
Tutorials
Eight example projects come with Dusty, from the simplest to the most complete. Each one is set for a 3018-type hobby CNC (300 × 180 × 45 mm travel), with careful depths and feeds, and passes the pre-send check without any blocking finding. The following tutorials rebuild each project from a blank page to the G-code, then send it to the machine; you can also open the finished example and follow along.
Example projects
File › Open Example… (Mac, iPad with a keyboard), More › Example Projects… (iPad), File › Open Example (Dusty Studio, desktop app), Help › Example Projects…, or the Example Projects… button of the new project window and of the project assistant. The ? of an example opens its tutorial.
The example opens as a new untitled project: in place of the open project if it is blank, otherwise in a new window on Mac (Dusty Studio first asks whether to discard the changes of the open project; on iPad, where an app does not create documents by itself, first create a new project, still empty). Save asks where to write it: the example shipped with Dusty is never modified. Its notes are shown: what the example shows, the material, the tools and the workholding. In the manual opened from the app (Mac, Dusty Studio, desktop app), the Open the example links of the tutorials do the same.
| Example | What it shows | Material | Tools | Time |
|---|---|---|---|---|
| Key rings | outside profile, holes, tabs | 6 mm plywood | 3.175 mm end mill | 6 min |
| Engraved sign | V-carved text, profile on the line | 12 mm hardwood or MDF | 60° V-bit | 5 min |
| Ruler | single-line font, open lines | 6 mm wood | 20° V-bit | 3 min |
| Drill bit holder | peck drilling, tool change | 20 mm hardwood | 5 and 3 mm drills | 3 min |
| Coaster | SVG import, pocket, tabs | 6 mm plywood | 3.175 mm end mill | 7 min |
| Catch-all tray | pocket, rest pocket, tool change | 18 mm MDF | 6 and 3.175 mm end mills | 14 min |
| Cutting board | ball nose groove, thick cut-out with tabs | 15 mm hardwood | 6 mm ball nose, 6 mm end mill | 20 min |
| Finger-joint box | notches, dogbones, cut-out with tabs | 6 mm plywood | 3.175 mm end mill | 17 min |
The times are those Dusty estimates for a 3018; the machining log then corrects them from your real jobs.
Before sending an example to the machine
Common to all tutorials. Try everything on the virtual CNC first.
- Machine: choose yours in the machine list (Machine tab in Dusty Studio). If its travel is smaller than a 3018's, shrink the stock and move the shapes closer together.
- Tools: check in the Tools panel that the project's tools are the ones you have: diameter, angle, number of flutes. The feeds come from the starter library, meant for a spindle of about 10,000 rpm: see the feeds and speeds calculator.
- Stock: measure its real thickness and enter it in the project setup; a through cut goes 0.3 mm into the spoilboard.
- Preview (⌥⌘P): the time, the simulated machined part and the pre-send check. Only the "the tool cuts into the spoilboard" warning is expected, for cut-outs.
- Workholding: as the example's notes say, always clear of the toolpaths; the safe height (10 mm) must clear the clamps (see Travel heights).
- Zeros: home the machine if it has limit switches, X and Y zero at the front left corner of the stock (the origin of the examples), Z zero on the top of the stock, with a sheet of paper or by probing.
- Frame…, then Dry Run…: the job is played above the stock, spindle off (see Running a job).
- Start Job…: read the pre-send check again, accept the spindle start and lower the feed override to 50 % for the first try. Safety glasses, dust extraction, and a hand near STOP (see Safety).
- Tool change (two-tool examples): the machine stops, spindle off; fit the requested tool, set only the Z zero again, then Resume… (see Tool change).
Without a machine connected to Dusty, save the G-code (⇧⌘E) and send it with the software of your choice: see Saving the G-code.
Key rings cut out with tabs
Open the example — three key rings cut out of 6 mm plywood: a rounded rectangle, a disc and a hexagon, each with a 6 mm hole for the ring.
- Project: File › New, stock 160 × 70 × 6 mm, origin Bottom left corner, Z zero Top of stock (see Project setup).
- Shapes: Rectangle tool (R), then in the Shapes panel width 50 mm, height 28 mm, corner radius 8 mm; Ellipse tool (E) with Shift for a 36 mm circle; Polygon tool (P) with 6 sides for a hexagon of 18 mm radius. In each part, a 6 mm circle at least 5 mm from the edge: these are the holes. Leave at least 10 mm between two parts (see Drawing tools).
- Tool: Tools panel › Add Tool › From Library › the 3.175 mm 2-flute end mill.
- Operation: select all (⌘A), then Operations › New Operation › Profile: side Outside, final depth 6.3 mm, depth per pass 1 mm, feed 600 mm/min. Dusty reads each inner circle as a hole: it is cut inside, before the outline of its part (see Profile).
- Tabs: check Tabs, length 6 mm (more than the bit's diameter), height 1.5 mm. Dusty spreads them on the outer outlines, not on the holes; the Tabs tool (B) moves them (see Tabs).
- Preview: about 6 minutes; the machined part shows the bridges that hold the parts.
- On the machine: see Before sending an example to the machine. Clamp the stock at its four corners, or with double-sided tape over its whole surface. After machining, cut the tabs with a utility knife and sand.
V-carved sign
Open the example — the text "DUSTY" V-carved in a 160 × 60 mm sign, with a border engraved on the line, all with a single V-bit.
- Project: stock 160 × 60 × 12 mm, origin bottom left corner, Z zero top of stock.
- Text: Text tool (T), click the canvas and type your text; Tuffy font (or another outline font), 30 mm, centered on the sign (see Text). Wide strokes give a deeper carving.
- Border: a 150 × 50 mm rectangle with 6 mm rounded corners, 5 mm from the edges, on another paint color (see Paint colors).
- Tool: from the library, the 60° V-bit of 12.7 mm. Enter the exact angle and diameter of yours: the depth depends on them.
- V-carving of the text: maximum depth 3 mm (beyond that, the bottom is cleared flat), 1 mm passes, 600 mm/min (see V-carving).
- Profile of the border: side On the line, depth 1.5 mm, with the same bit: no tool change.
- Preview: about 5 minutes. In the top view, the machined part shows the V bottoms and the sharp corners of the letters.
- On the machine: see Before sending an example to the machine. The sign is not cut out: clamps on the edges, clear of the border. The Z zero must be right: 0.1 mm more or less changes the width of the strokes; prefer probing.
Single-line engraved ruler
Open the example — a 100 mm ruler engraved in a 130 × 35 × 6 mm strip: graduations every 5 mm, digits and name in the Dusty Monotrait font.
- Project: stock 130 × 35 × 6 mm.
- Graduations: with the Path tool (L), vertical lines of 10 mm (centimeters) and 6 mm (half centimeters), 5 mm apart from 15 mm off the left edge; an array repeats them exactly.
- Digits: Text tool, Dusty Monotrait font, 4 mm, one digit under each long line: each letter is a single stroke, with no outline (see Single-line fonts).
- Tool: the 20° V-bit of 3.175 mm from the library.
- Operation: select all, Profile side On the line: the center of the tool follows the open lines as well as the letters; 0.4 mm deep in one pass, 300 mm/min.
- Preview: less than 3 minutes.
- On the machine: see Before sending an example to the machine. A flat stock and a precise Z zero: a 0.4 mm engraving forgives nothing. The tip of a 20° bit is fragile: keep the suggested feed.
Drill bit holder (drilling)
Open the example — a 160 × 60 × 20 mm hardwood block drilled with seven 5 mm holes and seven 3 mm holes, to store drill bits.
- Project: stock 160 × 60 × 20 mm.
- Holes: 5 mm circles (back row) and 3 mm circles (front row), 20 mm apart; only their center matters for drilling. Put each row on its own paint color.
- Tools: the 5 mm and 3 mm drills of the library (tools no. 1 and no. 2).
- Drill each row with its drill: type Peck, depth 12 mm (10 mm for the small holes), a peck every 3 mm (2 mm): the drill retracts to clear the chips (see Drill).
- Preview: about 3 minutes; the holes follow the shortest path.
- On the machine: see Before sending an example to the machine. Clamps on the sides of the block; the holes do not go through. Set the Z zero with the 5 mm drill; at the tool change, fit the 3 mm drill and set only the Z zero again.
Coaster imported from an SVG
Open the example — a drawing made in a vector drawing program (a 90 mm disc, mountains and a sun), imported as is, then machined in 6 mm plywood.
- Project: stock 100 × 100 × 6 mm.
- Import: File › Import… (⌘I) and choose the SVG. The file's sizes in millimeters are kept and the stroke colors become paint colors (see Importing); Arrange › Place on Stock › center (⌃⌘C) puts the drawing in the middle of the stock.
- Tool: the 3.175 mm 2-flute end mill.
- Pocket of the motif: 1.5 mm deep, 0.8 mm passes. The shapes of a pocket must be closed (see Pocket and Cleaning up paths).
- Profile of the disc: Outside, 6.3 mm, with 6 mm tabs.
- Preview: about 7 minutes.
- On the machine: see Before sending an example to the machine. Screws in the corners of the stock, clear of the disc. For your own drawing, delete the motif, import your SVG and assign its shapes to the "Motif" operation.
Rest machining and tool change
Open the example — a 6 mm deep star-shaped catch-all tray in a 120 mm square of MDF: a large bit clears most of it quickly, a small one finishes the points.
- Project: stock 120 × 120 × 18 mm.
- Star: Drawing › Preset Shapes › Star, 5 sides, inner radius 50 %, radius 50 mm, in the middle of the stock (see Drawing tools).
- Tools: the 6 mm (tool no. 1) and 3.175 mm (tool no. 2) end mills.
- Pocket of the star with the 6 mm end mill: 6 mm deep, 1 mm passes, 700 mm/min.
- Rest pocket on the same star, with the 3.175 mm end mill, placed after the pocket: clearing tool diameter 6 mm (see Rest pocket).
- Preview: about 14 minutes. With the by operation colors of the machined part, the second operation only touches the points.
- On the machine: see Before sending an example to the machine. Clamps at the four corners, clear of the star. Z zero with the 6 mm end mill; at the tool change, Dusty stops the machine and the spindle: fit the 3.175 mm end mill, set only the Z zero again, then Resume… (see Tool change).
Cutting board and juice groove
Open the example — a 230 × 150 mm board with rounded corners and a juice groove, in 15 mm hardwood.
- Project: stock 240 × 160 × 15 mm, almost the whole travel of a 3018.
- Groove: a 210 × 130 mm rectangle with 15 mm rounded corners, centered.
- Outline: a 230 × 150 mm rectangle with 20 mm rounded corners, centered, on another color.
- Tools: the 6 mm ball nose bit (tool no. 1) and the 6 mm 2-flute end mill (tool no. 2).
- Profile on the line of the groove, with the ball nose bit: 3 mm deep, 1 mm passes, 700 mm/min. The rounded bottom is easy to clean.
- Outside profile of the outline, with the end mill: 15.3 mm, 1 mm passes, 700 mm/min, tabs 10 mm long and 2 mm high. The groove comes first, while the board is still held everywhere (see Machining order).
- Preview: about 20 minutes.
- On the machine: see Before sending an example to the machine. Screws in the corners of the stock, clear of the cut (2 mm margin), or double-sided tape; frame the job to check the travel. A tool change separates the groove from the cut-out. Cut the tabs, sand, then apply a food-safe oil.
Finger-joint box and dogbones
Open the example — the four sides of an 80 × 60 × 40 mm box joined by notches, and its bottom, in 6 mm plywood.
- Project: stock 230 × 120 × 6 mm. Measure your plywood: the notches must match its real thickness (often 5.8 mm for "6 mm" plywood).
- Sides: with the Path tool (L) and the grid, draw each side as a closed path. Their edges are split into five 8 mm bands: the front and back (80 × 40 mm) have fingers on bands 1, 3 and 5 and 6 mm notches on bands 2 and 4; the sides (60 × 40 mm), the opposite. The bottom (68 × 48 mm) is glued inside.
- Tool: the 3.175 mm 2-flute end mill.
- Outside profile of all the parts: 6.3 mm, 1 mm passes, 6 mm tabs.
- Dogbones: select the parts, then Drawing › Dogbones on Inside Corners: a round relief of the bit's radius (1.59 mm) is cut into each inside corner of the notches, so that the square fingers fit in (see Radius, notches and dogbones). Create the profile first: it tells Dusty which side is material.
- Preview: about 17 minutes; in the top view, the dogbones show at the bottom of each notch.
- On the machine: see Before sending an example to the machine. Screws at the corners and in the middle of the long sides of the stock, clear of the parts. Try fitting two sides together before gluing.
Concepts
The basic ideas of machining, explained once and for all: the other topics refer to them. They apply to any CNC router; the setting names are Dusty's.
From drawing to G-code
Dusty goes through four steps:
- The drawing: shapes, sorted by paint color. They say where to machine, not how.
- The operations: each one applies to shapes and says how to machine them: type (profile, pocket, drill…), tool, depths, passes, feeds. A shape can receive several operations (a pocket, then a profile).
- The toolpaths: the path of the tool tip, computed by Dusty for each operation, in machining order. The preview shows them and simulates the part.
- The G-code: the toolpaths translated into the controller's dialect (the flavor):
G0for a rapid move,G1for a straight cut,G2andG3for arcs,M3andM5for the spindle. Dusty saves it to a file or sends it to the machine.
Changing a shape or a setting recomputes the toolpaths: the drawing stays the reference, the G-code is only its result.
Router bits
- Flat end mill: profiles, pockets, slots. Its flutes lift the chips (up-cut: good evacuation, but it raises the top fibers) or push them down (down-cut: clean top, to avoid at the bottom of a deep slot); a compression bit does both, for plywood.
- Ball nose: rounded bottoms and relief finishing.
- V-bit: crisp lines and letters; the line width depends on the depth (V-carving, chamfer).
- Drill bit: a hole at the drill's diameter, by plunging only (drilling).
The cutting diameter places the toolpath: it must be exact in the project tools. A long bit deflects more: prefer the shortest one that reaches the depth you need.
Tool side
- On the line: the center of the bit follows the line; the slot spreads one radius on each side (engraved lines, slots).
- Outside: the part keeps the exact size of the drawing; the choice for cutting a part out.
- Inside: the hole keeps the size of the drawing; its inside corners keep the bit radius.
The profile offers all three; a pocket always stays inside its shape.
Cut direction
The spindle turns clockwise seen from above. Depending on which side the material is, the bit moves:
- climb: each tooth enters the chip thick and leaves it thin; better surface finish, less heat. On a machine with backlash, the bit can be pulled forward;
- conventional: each tooth enters thin and rubs a little before cutting; more forgiving of the backlash of light machines, edges sometimes less clean.
Dusty sets the direction in the operation's common settings and derives the direction of each contour from it (see Start point and direction).
Feed, speed and chip load
The feed (mm/min) is the speed at which the bit goes through the material; the spindle speed (rpm), the speed at which it turns. With the number of flutes, they give the chip load: the thickness of the chip each flute removes.
chip load (mm) = feed ÷ (spindle speed × number of flutes)
1,000 mm/min ÷ (10,000 rpm × 2 flutes) = 0.05 mm- Chip too thin: the flute rubs instead of cutting, heats up, burns the wood and dulls. That is often what happens when you lower the feed "to be safe" without lowering the spindle speed.
- Chip too thick: the bit strains, the machine flexes or loses steps, the bit can break.
- Bit makers give a range per material and diameter; the feeds and speeds calculator starts from it, and the operation editor shows the chip load of your settings.
- The plunge feed (straight down) is slower: most bits cut poorly with their tip. A ramp or helix entry spares the tool (see Entering the material).
Stepover and depth per pass
- Depth per pass: how far the bit goes down each time. On a desktop CNC, start from half the diameter in softwood and plywood (1.5 mm for a 3 mm bit), less in hardwood, aluminum or with a long bit; the last pass can be shorter.
- Stepover: the distance between two side-by-side passes in a pocket or a surfacing, as a percentage of the diameter. 40 to 50% is a good start; above 100%, strips of material would remain. A finish needs a finer stepover.
- More, shallower passes spare a light machine without necessarily making the job much longer.
Origin, zeros and coordinates
- Machine coordinates: the tool position within the machine travel, from its machine zero, found by homing on the limit switches when the machine has them.
- Work zero: the point chosen on the stock (a corner, the center) and the reference height (the top of the stock or the spoilboard). Dusty's G-code is written in this frame; the controller keeps the offset between the two (
G54). - The project origin says which point of the drawing matches the work zero: the tool tip must be exactly there when you set the zero (see Origin and Z zero and Work zero).
- The Z zero sets every depth: 1 mm too high, each pass cuts 1 mm less; too low, the bit enters the material in a rapid move. Take it with a probe plate when possible (see Probing).
Heights and rapid moves
- Between two cuts, the bit travels in rapid (
G0), at the machine's top speed: it must be high enough not to hit anything. - The safe height, above the top of the stock, must clear the highest clamp, screw or clamping head. From one shape to the next, the fast retract only lifts a few millimeters: turn it off if something sticks out above the stock between shapes (see Travel heights).
- The pre-send check refuses a rapid below the stock surface, but it does not know your clamps: framing checks that (see Workholding).
The project
A project brings together the drawing, the stock settings, the tools and the operations. It is saved in a single .dusty file.
Project setup
File › Project Setup… (⌥⌘,) gathers every setting on one page, with a stock diagram: top view with the origin and the axes (X to the right, Y toward the back of the machine), side view with the Z zero. The settings are applied together with OK, as a single action that ⌘Z undoes; Cancel discards them.
| Setting | Purpose |
|---|---|
| Stock: width (X), depth (Y), thickness (Z) | Size of the material; the canvas work area takes this size. 300 × 200 × 18 mm by default. |
| XY origin | Corner of the stock (bottom left, bottom right, top left, top right) or center, where you will set X and Y zero. |
| Z zero | Top of stock, or bottom of stock (the spoilboard). |
| On the Machine | The steps to carry the origin and the Z zero over to the machine. |
| Heights | Safe height, fast retract between shapes, pocket lift: see Travel heights. |
| Cut order | Repeated parts machined operation by operation or part by part: see Cut order of repeats. |
| Units | Millimeters or inches, for display and input; Dusty always computes in millimeters. |
| Machine | The active machine, whose G-code flavor and travel are used for export and for the pre-send check. |
For a new project, the same page opens under the title New Project, with your recent projects on Mac (on iPad, the system file browser plays that role). Settings › Project › "Set up each new project" turns it off.
The Project panel of the inspector repeats the stock, origin, heights and units: each change applies at once (and is undone with ⌘Z). Problems (zero size, inconsistent height) are shown below the settings.
Project assistant
The step-by-step assistant prepares a new project in a few questions, each explained: machine (the workshop's one, or Choose or Add a Machine…), units, stock (with its diagram), origin and Z zero, travel heights, first operation (profile, pocket, drilling, V-carving, or none), its tool (taken from the library, among the suitable ones), then a summary. Finish applies the settings as one undoable action, adds the tool and the operation; the operation automatically machines the shapes of the active paint color: all that is left is to draw. The suggested values are fine to try things out.
It opens when you create a project if Settings › Project › “New project setup” is Step-by-Step Assistant (and always in beginner mode), or through File › Project Assistant…. Advanced Setup switches to the full page; on that page, Step-by-Step Assistant goes back to the assistant. The last choice is kept for the next projects.
From the first step, Open a MillMage or LightBurn Project… fills the project from another program: the assistant closes without applying anything, then the project is imported (see MillMage projects).
Origin and Z zero
The origin is the point of the stock where you will place the tool before setting X and Y zero on the machine; it is marked with a cross on the canvas, and every position shown (inspector, status bar) is measured from it. The bottom of the canvas is the front of the machine: "bottom left corner" is the front left corner of the stock.
The Z zero sets the reference of the depths:
- Top of stock (the most common): the tool tip just touches the top of the part. A 3 mm depth goes 3 mm below the surface, whatever the real thickness.
- Bottom of stock (spoilboard): the tip just touches the spoilboard next to the part. Useful when the stock thickness varies: a through cut always stops at the same level. The thickness you enter must then be exact.
An inaccurate Z zero cuts into the spoilboard or leaves the part attached: set it carefully, preferably by probing.
Travel heights
| Height | Default | Purpose |
|---|---|---|
| Safe height | 10 mm | Height of rapid moves above the stock surface. It must clear anything that sticks up: clamps, screws, hold-downs. |
| Fast retract between shapes | on, 2 mm | From one shape to the next within an operation, the tool only rises to this height above the stock, which saves time. Off, it rises to the safe height: turn it off if a screw or a clamp sticks up from the stock between the shapes. |
| Pocket lift | 0.5 mm | Inside a pocket, the tool moves from one point to another just above the floor already machined, instead of rising. |
The pre-send check refuses a safe height that is not above the stock.
Cut order of repeats
When a sheet holds several similar parts (an array, copies along a path, the clones of a virtual array, nested parts), the project setup chooses the cut order:
- Operation by operation (the default): each operation machines all its shapes before the next one, in the order of the operation list — for instance all the holes, then all the outlines. Within an operation, the shapes are taken nearest the tool first, and inner outlines before the one around them.
- Part by part: the operations that follow one another with the same tool finish one part before moving on to the next — the holes then the outline of the first part, then those of the second… A part is a closed shape that lies in no other, with everything it contains; a shape outside any closed shape is a part of its own. Parts are taken nearest the tool first. A part that has been cut out is finished: if the job stops, the parts already made are complete.
A tool change is never repeated: operations with different tools are still machined one after the other, each on all its parts. Surfacing and facing, which work a whole area, are not split into parts. Part by part, the preview and the export by sequence show one section per part and per operation ("Profile — part 2 of 6"). This order is a Dusty proposal: MillMage machines operation by operation.
.dusty files
File › New (⌘N), Open (⌘O), Save (⌘S), Duplicate (⇧⌘S on Mac): these are the system's document commands, with the offer to save when you close a modified window. The .dusty file holds the drawing, the project settings, a copy of the tools in use (the project will machine the same way on another computer) and the operations; it reopens exactly as it was.
A project can also be saved as a template (.dustytemplate, see Project templates). Tool libraries are separate files (.dustytools, see Tool library). Machines, the machining log and settings backups are kept in Dusty's folder (Application Support on Mac).
The file also keeps the pages and the project notes; a file saved by an older version of Dusty still opens.
Project templates
A template is a project you reuse as a starting point: a stock and its settings, tools, operations, a frame, a text to change… File › Save as Template… writes a copy of the project as .dustytemplate; the open project keeps its file.
File › New from Template… opens a template as a new untitled project: everything is there (pages, settings, tools, operations, notes), but Save asks where to write the project, so the template is never overwritten by mistake. On Mac, the template takes the place of a new project that is still empty, otherwise it opens in a new window; on iPad, it opens in an empty project (create a new project first; these commands are also in the More menu). A .dustytemplate file dropped on the canvas opens the same way.
File › Recent Templates offers the last ten templates saved or opened; Clear List empties it (the files stay) and a template that can no longer be found leaves it. In Dusty Studio and the desktop app, the page keeps a copy of these ten templates: a browser cannot reopen a file by itself.
Pages
A project can have several pages, one per sheet of material for example. Each page has its own drawing, stock, origin, heights and operations; the project's tools are shared by all pages. The pages are at the top of the inspector's Project panel (View › Pages…); in Dusty Studio, in the Pages tab.
- Each page shows a thumbnail of its drawing, its name, its stock and its numbers of shapes and operations. Clicking it opens the page: the canvas, the Project panel and the operations are then its own.
- + adds a blank page after the open page, with the same settings; Duplicate Page copies it with its drawing, settings and operations; − deletes the open page (the last page stays); Page Setup… opens the setup of the open page.
- A page's context menu (right-click, long press on iPad) opens it, renames it (an empty name restores "Page n"), duplicates it, opens its setup, moves it up or down the list, or deletes it. In Dusty Studio, a double-click also renames it.
Adding, duplicating, deleting, moving or renaming a page can be undone (⌘Z). Undo goes across page changes: opening another page clears nothing and is not an action; undoing (or redoing) an action made on another page reopens that page. The preview and the G-code cover the open page. Nesting on multiple pages creates the pages it needs, with the operations of the parts they receive.
Project notes
File › Project Notes… (⌥⇧⌘N): free text saved with the project and shared by all pages — material, clamping, settings to reuse, instructions for next time. Show the notes when the project opens displays them as soon as the file opens. OK saves them (an action that ⌘Z undoes), Cancel leaves them unchanged. The notes of a LightBurn or MillMage project imported into an empty project become the project's notes.
Drawing
Dusty draws vectors: each shape is an outline (closed or open) that operations follow or clear. Every dimension is in project units and measured from the origin.
Drawing tools
The tools are in the column on the left of the canvas and in the Drawing menu; a letter chooses them when the canvas has the keyboard.
| Tool | Key | Use |
|---|---|---|
| Selection | V | Click, drag a box, move, resize with the handles, rotate by grabbing just outside a corner. |
| Rectangle | R | Drag; Shift: square; ⌥: from the center. The corner radius is set in the Shapes panel (negative: notches, see Radius, notches and dogbones) or with the mouse: a rectangle selected on its own shows a round dot near each of its corners; drag one inward to round all four corners, outward to go back to sharp corners (one undoable action, Escape restores the rectangle). |
| Ellipse | E | Drag; Shift: circle; ⌥: from the center. |
| Polygon | P | Drag: the polygon or star fills the box you draw (its circumscribed circle becomes an ellipse of that width and height); Shift: regular, with equal sides; ⌥: from the center. The number of sides and the star are set in the Shapes panel or, for the sides, with the mouse: a polygon selected on its own shows a purple dot in its first sector; drag it to the right to add sides (or points), to the left to remove some (one undoable action, Escape restores the polygon). |
| Path | L | Click: corner node; click and drag: curved node; Shift: angle in 15° steps; click the first node: closed path; Return or Escape: open path finished; ⌫: removes the last node; S: smooth mode (Smooth Mode button at the top of the canvas). |
| Text | T | Click, then type: see Text. |
| Edit Nodes | N | Node bar at the top of the canvas: see Editing nodes. |
| Measure | M | Drag between two points: distance, offsets and angle. |
| Trim | X | Click part of an outline to remove it: see Measure and trim. |
| Tabs | B | Click an outline to place a tab there, click a tab to remove it: see Tabs. |
| Start Point | D | Click the outline of a shape to place the start of its machining there; Shift-click reverses its direction: see Start point and direction. |
Preset Shapes (Drawing menu and Shapes menu of the toolbar): Triangle, Star and Double Star choose the Polygon tool set up for that shape. In the Shapes panel, a selected polygon has three settings: Sides, Inner radius (as a % of the radius: 0 gives a polygon, 5 to 95% a star) and Secondary points (double star: length of every other point, as a % of the radius; 0 gives a simple star). They also apply to the next polygons.
The double star (MillMage's "Dual Radius Star") has two alternating sets of points, each of Sides points (twice as many points in all): the Inner radius sets the depth of the valleys (MillMage's "Ratio"), the Secondary points the length of the points of the second set ("Ratio2"). Drawn with Shift, each of its two sets has equal sides. It stays editable (sides, valleys, secondary points, purple dot) and is kept as is in the .dusty file. Polygons and stars of an imported MillMage project arrive as paths, with their exact shape; the rounding of the points (MillMage's "Bulge") does not exist in Dusty: their points arrive straight (the import says so).
After a shape, Dusty returns to the Selection tool (adjustable in Settings › Drawing). During a gesture, dimensions are shown near the pointer. Snapping to nodes, midpoints, intersections and shape centers is on by default (snapping to the grid is optional); hold Ctrl to suspend it during a gesture.
Smooth mode of the Path tool (S key, or the Smooth Mode button at the top of the canvas, the only way with a finger): each click places a smooth node whose curve follows the neighboring nodes, with no handle to drag; the same key goes back to corner nodes.
A path started at the end of an open path extends it; finished at the end of another, it joins it. Pockets and most operations require closed shapes: close your paths by clicking the first node, or afterwards with Edit › Close Path (see Cleaning up paths).
Text
Text tool (T): click on the canvas, type, then Return (or click elsewhere). Double-clicking a text with the Selection tool edits it again (or opens the Edit Text window if the settings ask for it). The Shapes panel sets the selected text (and the next ones):
- Content, Font, Cap height; a font missing on the device is replaced, and Dusty says so;
- Bold, Italic, Upper case, Letter spacing, Line spacing;
- Alignment (left, center, right: the anchor point is the start, the middle or the end of the text) and Vertical anchor (baseline, at the top of the capitals, in the middle of the block, at the bottom on the last line);
- Welded letters: a single outline for touching letters, to machine them in one piece;
- Arc radius: 0 for straight text, a positive value for text on an arc, negative for an inverted arc;
- Distort letters (bent text or text on a path): see below;
- Right to left (Arabic, Hebrew), when the settings offer right-to-left writing.
Font choice: your favorites come first (the star next to the list adds or removes the chosen font), then the recent fonts, the single-line fonts and all the others; fonts hidden in the Font Manager are no longer listed. The Aa button next to the list (or a right-click on the list) opens the Font Manager. With the Text tool, or a selected text, the text bar at the top of the canvas offers the font, the height, the anchors, bold and italic.
Bending text: a single selected text has a handle above its frame. Drag it up for a bulging text, down for an inverted arc; double-clicking the handle makes it straight again. The radius shows in Arc radius.
Distort letters (panel checkbox, Distort button of the text bar), for bent text or text on a path:
- checked (default): the letters follow the curve; above a bulging arc, they widen at the top and narrow at the bottom, like text printed on a curved ribbon;
- unchecked: each letter keeps its exact shape; it is only moved and rotated, the middle of its foot sitting on the curve. Handy to engrave crisp letters along the edge of a round part, or to keep the shape of a single-line font. Welded letters stay welded.
The choice also applies to the next texts, like the other text settings; it changes nothing on straight text.
Edit Text… (Drawing menu, right-click on the text, or the panel button) opens a window with the content on several lines and all the settings; Apply (⌘↩, Ctrl+Enter in Studio) applies them as a single undoable action.
In Dusty Studio and the desktop app, the Drawing panel sets the selected text the same way. The list offers the built-in font (Tuffy), the built-in single-line font, the ones you add with Add a Font… (a TTF, OTF or SHX file, kept by the browser or the desktop app for the next sessions) and the System Fonts, those installed on the computer: the desktop app (Windows, Linux) reads them itself; in Chrome and Edge, System Fonts… first asks for the browser's permission; elsewhere, they do not appear. A system font is read when you choose it, or when a project whose text uses it is opened; it is never copied or embedded.
A text stays editable; it is machined as its outlines. To engrave letters, V-carving gives crisp strokes; for raised or recessed letters, use a pocket.
Text on a path
Select a text and a shape (path, circle, rectangle, or a group), then Drawing › Apply Path to Text (or right-click): the text sits on the outline and follows it. The shape becomes the text's path: it is no longer machined and shows as a dashed line when the text is selected. The text keeps all its settings:
- Alignment: the text starts at the beginning of the path (left), its middle (center) or its end (right); Offset along the path moves it away;
- Vertical anchor: sitting on the path (baseline, bottom), centered on it (middle) or hanging below it (top);
- Distort letters: unchecked, each letter keeps its shape and sits on the path, turning with it (see Text).
To change the path, Edit Path (text panel) switches to the Nodes tool: move its nodes, the text follows. The text reads from left to right on a mostly horizontal path and runs along the outside of a closed outline; to put it on the other side of the path, choose the “Top” vertical anchor. The Detach Path menu makes the text straight again, settings kept, and:
- Detach Path: the path becomes a shape again, on the text's layer;
- Detach Path to the Tool Layer: it goes to tool layer T1, visible but never machined;
- Straighten Text: the path disappears.
The path can be selected on its own, without detaching the text: with the text selected, click its dashed path (Selection tool). The path turns into a solid line and the frame surrounds it. Dragging moves the path, and the text that follows it; the handles enlarge, rotate or shear it, the letters keeping their size and settling along the path (one undoable action); Delete removes the path (the text becomes straight again); Escape or a click on the letters goes back to the text.
Font Manager
The Aa button next to the font choice (or a right-click on the list) opens the Font Manager: all the fonts of the device, each with its name and a sentence written in that font.
- Search: type part of the name (“times”, “mono”…); case and accents do not matter.
- Preview size: the slider enlarges or shrinks the sample sentences (kept for next time).
- Categories, on the left: All, Favorites, Recent, Active (not hidden), Hidden, then Single-Line (SHX) (built-in single-line font and SHX fonts) and Outline (TrueType).
- Star: the font becomes a favorite and moves to the top of the font choice; a second click removes it from the favorites.
- Green circle: the font is active; a click hides it: it leaves the font choice (texts that use it keep it). To find a font that “disappeared”, open the Hidden category and click its empty circle.
- Choose gives the font to the selected text (or to the next texts); the check mark shows the text's font.
Favorites, recent fonts, hidden fonts and the preview size are app settings: they travel in the settings file. In Dusty Studio and the desktop app, the manager also lists the system fonts not loaded yet: their preview is drawn by the browser.
Variable text
A variable text keeps codes that Dusty replaces with values when it produces an output: toolpaths and preview, saved G-code, job sent to the machine, exported drawing (SVG, DXF, PDF). The drawing keeps the codes; use it to number plates, date parts or engrave a list of names. In the text settings (Shapes panel, or Drawing panel in Studio), Variable text chooses the mode:
- Normal: the text as typed;
- Date and time: day
d,dd, day nameddd(short) ordddd; monthM,MM,MMMorMMMM; yearyyoryyyy; ISO weekw(wwon two digits) andW(year/week, 2026/43); hoursH,HH(0 to 23) orh,hh(1 to 12 if the text containsAP,A,apora, replaced by AM/PM or am/pm); minutesm,mm; secondss,ss; millisecondszzz(zwithout trailing zeros); time zonet. Example:dd/MM/yyyy HH:mm→ 19/10/2026 16:05. Names follow the language of the interface; the time is the device's at the moment of the output; - Serial number: a run of
d(decimal),h(lowercase hexadecimal) orH(uppercase) is replaced by the counter; as many digits as letters (ddwith 1234 gives 34), padded with zeros if a0comes first (0dddd→ 01234). One number per text, of a single kind:ddd-dddorddhhoutput “bad serial format”, reported in the Variable Text window; - CSV merge:
%0,%1… are replaced by columns 0, 1… of the current row of the loaded CSV file (the first row of the file is row 0); a missing column gives an empty text.
Literals: in all three modes, a passage between apostrophes is copied as is, even if it contains code letters ('Lot' 0ddd → Lot 042, 'Made at' HH'h'mm → Made at 16h05); two apostrophes give one apostrophe (O''Neil). A code letter in an unprotected word is replaced: protect the words of the text.
Offset (text settings): added to the counter for this text only. With a counter at 1000, four labels with offsets 0, 1, 2 and 3 output 1000 to 1003; with Advance by 4, the next sheet outputs 1004 to 1007.
Maximum width (text settings): a wider text is reduced to this width (0: none); Squeeze width only keeps its height, unchecked the whole text is scaled down, proportionally (straight text). Useful when the length of a name or a number changes from one part to the next.
Variable Text window (Drawing › Variable Text…, also in the Shapes menu of the toolbar):
- Counter: Current value (serial number, or CSV row of the next output), Start and End (past the end, the counter goes back to the start, and the other way round), Advance by (the step); Back, Next, Reset (back to the start);
- Advance after each successful output: the counter moves one step after a job that ran to completion, a saved G-code or drawing, or baked texts. A job stopped, in alarm or whose link was lost does not use up a number; neither does the preview;
- CSV file: Load… reads a file separated by commas, semicolons (French spreadsheets) or tabs, quoted fields included; UTF-8 preferably — an “ANSI” file from Windows is read as Windows-1252, accented letters included, with a warning. The window shows the name of the file, its rows and columns, and the current row. Clear unloads it. Ignore empty variables: a line of the text whose fields are empty disappears;
- Values: the value of each variable text at the next output (those of the selection first) and the problems (bad serial format, merge without a file, missing row); Test shows the values on the canvas instead of the codes, as long as the box is checked;
- Bake Selection, Bake All: the variable texts become ordinary texts with their current value (what is shown is what will be machined); with auto-advance, the counter moves on in the same undoable action.
The counter and the CSV file are saved with the project; they are shared by all its pages. Variable barcodes and 2D codes follow the same rules.
Series machining, in two ways:
- one job per record: check Advance after each successful output, then run one job per part. At the end of each job that ran to completion, the counter moves on to the next record (the console notes it): change the stock, run again. An interrupted job is resumed or run again with the same number;
- all pages at once: in the window, choose the number of pages (200 at most; the first names are shown), then Create One Page per Record. The pages are added after the open page: copies of it (drawing, settings, operations) whose variable texts are baked to the value of their record, and named after it; the counter moves on to the next record, in a single undoable action. File › Save G-code… › All pages then writes the G-code of each page in a folder named after it; the template page, which keeps its codes, is skipped.
Arrays number their copies: Auto-increment variable text (Grid Array and Circular Array sheets) adds the step to the offset of each copy — a sheet of 24 numbered labels in one go.
Differences with MillMage: the counter does not advance on preview or when a job starts, but at the end of a job that ran to completion (a stopped job does not lose a number); “Test” is a checkbox rather than a button to hold down; squeezing is set on the text and empty lines for the whole project.
Barcodes and QR codes
Dusty creates barcodes (1D codes) and 2D codes (QR code, Data Matrix) ready to machine: the dark modules are cut out of the stock, then read as recesses (a darker bottom, or filled with resin or paint and then surfaced). Drawing › Create Barcode… (also in the Shapes menu of the toolbar) opens the Barcode window; the code is placed at the center of the view, on the active color: the operations of that color machine it. To change it, double-click it, or Drawing (or the context menu) › Edit Barcode…. Creating and editing are each a single undoable action; a code moves, rotates and scales like a shape, and is picked by clicking anywhere in its bounds. On the canvas, a code is always drawn filled.
Type: QR code, Data Matrix, Code 128, Code 39, Code 93, EAN-13, EAN-8, UPC-A, UPC-E, Codabar, ITF (interleaved 2 of 5, ITF-14 of shipping cartons), and the AprilTag and ArUco vision markers (the data is the marker number). A line under the choice recalls what the type accepts. A new code takes the type of the last one created.
Data:
- Raw content: the encoded text (web address, number, free text; several lines for a QR code);
- for a QR code, Wi-Fi (network name, password, WPA or WEP security, hidden network: a phone that reads the code joins the network) and Contact (name, phone, email, website: MECARD card) fill in the raw content;
- characters left for the chosen type (in red when there are too many): the capacity of a QR code depends on its error correction and on what is encoded (digits only, capitals, or bytes);
- Text evaluation: Normal, Date and time, Serial number or CSV merge, with the codes of variable text (
'SN-' 0dddd,%0…). Evaluated text shows what will be encoded at the next output; Offset is added to the project counter for this code (several codes on a sheet, different numbers). The counter, the CSV, auto-advance, numbered arrays and series machining are those of variable text; - Control characters:
\Ffirst (FNC1, GS1 Data Matrix),\G(GS separator),\n,\r,\t,\xHH(one byte in hexadecimal),\\(a backslash).
Settings depending on the type:
- Module size (2D code) or Narrow bar width (1D code, the other bars are 2 to 4 times as wide), and Bar height; the size of the code and its number of modules are shown under the title;
- Error correction of a QR code: L (7%), M (15%, the default), Q (25%) or H (30%) of the code can be missing or damaged without preventing reading. On wood, M or Q: a chip, a knot or a torn-out module are made up for. The higher the correction, the more modules the code has;
- Human-readable text under the code (1D codes): the data, check digit included, written under the bars and machined with them (the check digit of an EAN or UPC is computed if you do not give it);
- Square Data Matrix (checked by default); unchecked, a rectangular format when it is smaller;
- Add-on code gap: an EAN-13 or UPC-A followed by
+and 2 or 5 digits gets an add-on code, at this gap (in modules).
Validation: data the type does not accept (letters in an EAN, accents in a Code 39, wrong check digit, too much data) shows the message that says what is allowed, and the code is neither created nor changed. The value of a variable code that becomes invalid at output (a CSV line with letters for an EAN) is reported by the operation, and that code is not machined.
Machining, specific to CNC. A reader reads the center of each module: every dark module must be cut out at its center, and no light module may be touched. The tool diameter against the module size decides. The window tells it for each operation that would machine the code (those that target it, or those of the active color for a new code): tool, module of the code as machined (scaling included), smallest module this tool can machine, and a verdict.
- Pocket, Module rows (the Barcodes and QR setting of the pocket, the default): each run of dark modules in a row, or each bar of a 1D code, is cut by straight passes along its long side, the tool staying half its diameter away from every edge. A tool as wide as a module is enough: one pass in the middle of the row (an isolated module becomes a round hole the size of the module); finer, several passes at the stepover. Smallest module = tool diameter (width cut at the final depth for a ball mill). A finer code is not machined: the operation reports an error (“Code unreadable with this tool…”) rather than cutting into light modules. All depth passes of a run are made before moving to the next, nearest one, lifting to the retract height in between.
- Pocket, Pocket the areas: the ordinary pocket of the merged dark areas, corners rounded to the tool radius. An isolated module is cut only if the tool fits in it with some room: smallest module = diameter + 2 × stock to leave + 0.02 mm. Below that, isolated modules stay standing and the operation warns.
- V-carve: sharp corners, the depth follows the size of each area; the flat tip of the bit must fit in a module. Limit the depth for a flat bottom in large areas.
- A profile, a chamfer or a fluting follow the outline of the areas without cutting them out: the code will not be readable, the operation warns.
Example: a QR code of 25 × 25 modules of 1.2 mm (30 mm wide) cut 0.6 mm deep with a 1 mm end mill, in module rows; Dusty checks it on the part simulated by the preview and on what the virtual CNC runs, where the code reads. Tips: a shallow depth (0.3 to 1 mm); modules of at least 1 mm on a 3018; a light, dense wood, or painted MDF surfaced afterwards; the quiet zone around the code (4 modules for a 2D code, 10 at the ends of a 1D code) kept free of any other machining.
Differences with MillMage: the code is not drawn with the mouse but placed at the center of the view, at the size of its modules; Aztec, PDF417, MaxiCode and the other MillMage types are not offered; error correction is a choice among four levels rather than a slider; machining in module rows and readability according to the tool are specific to Dusty.
Single-line fonts
A single-line font draws each letter with one stroke: ideal for fast engraving with a drag point or a V-bit (V-carving operation or an outline follow), where an ordinary font gives two outlines per stroke. Dusty has one built in, Dusty Monotrait (Latin letters, French accents, digits and punctuation), always available.
AutoCAD SHX fonts are single-line fonts too. On Mac and iPad, Settings › Text › SHX fonts › Choose Folder…: the .shx files of the folder are read at launch and appear in the “Single-Line Fonts (SHX)” group of the font choice. In Studio and the desktop app, Settings › Text › Add SHX Fonts… (or Add a Font… in the font choice): the files are kept by the browser. SHX fonts are not supplied with Dusty: use the ones you have the rights to. The “shapes”, “unifont” and “bigfont” formats (Japanese, Chinese and Korean scripts, including the primitives of extended fonts) are read. The code page of a bigfont (Shift-JIS, GBK, Big5 or EUC-KR) is deduced from its name (extfont, gbcbig, chineset, whgtxt…), then from its lead bytes; each character is typed as its Unicode form.
Editing nodes
Select a shape, then the Edit Nodes tool (N): its nodes and handles appear, and the node bar shows at the top of the canvas.
- Drag a node to move it (Shift: horizontally, vertically or diagonally); drag a handle to change the curve. On a smooth node, both handles stay aligned; hold ⌥ to break that alignment.
- Click a node (Shift: add it to the others) or drag a box around several; the arrow keys move them; Delete removes them; Escape deselects them.
- Click a segment: its two nodes are chosen (Shift: added to the others), which designates the segment for the node bar. Drag a segment to bend it: a straight line becomes a curve through the pointer, a curve is reshaped.
- Join by dragging: drop the end node of an open path onto another end node (it snaps to it); on the other end of the same path, the path closes; on the end of another of its pieces, or of another open path, the two become one (the absorbed path goes to the edited shape, with its operations).
- Rectangles, ellipses and texts become paths at the first change to their nodes.
Node bar: its buttons act on the chosen nodes, or on the segment whose two nodes are chosen; those that do not apply are dimmed. Insert Node (in the middle of the chosen segment, otherwise of the segment after the chosen node), Delete Nodes, Delete Segment (a closed outline opens, an open path splits), Corner Node (independent handles), Smooth Node (aligned handles), Break Path at the chosen node, Close Path, Curve to Line, Line to Curve, Trim Segment (the part around the middle of the segment, up to the nearest crossings with this path or another; the whole segment if it crosses nothing), Extend to Next Path (from the chosen end of an open path), Align Selection to Segment (see below), Straighten Segment (its end node moves to make it horizontal, vertical or 45°), then the Radius tool and the "?" button.
Align Selection to Segment (A key, like MillMage's "Align Selected"): the whole selection rotates around its center to bring the segment under the pointer (otherwise the chosen segment; for a curve, its chord) to the nearest horizontal, vertical or 45° diagonal. Handy to straighten an imported, scanned or traced drawing that is skewed. The shapes keep their kind (a rectangle stays a rectangle); one undoable action. The A key does the same with the Selection tool: hover a segment of a selected shape, and all the selected shapes rotate with it.
Node mode keys (canvas active, Edit Nodes tool only): they act on the node or segment under the pointer, otherwise on the chosen nodes.
| Key | Action |
|---|---|
| D | On a node: delete it (with the other chosen nodes); on a segment: delete the segment |
| I | Insert a node at the point of the segment under the pointer |
| M | Insert a node in the middle of the segment under the pointer |
| C | Corner node |
| S | On a node: smooth node; on a straight segment: change it into a smooth curve |
| B | Break the path at the node |
| L | Change the segment into a straight line |
| A | Align the selection to the segment: it rotates to make it horizontal, vertical or 45° |
| T | Trim the segment up to the nearest crossings |
| E | Extend the nearest end up to the first path it meets |
With the Edit Nodes tool, these letters no longer choose a tool (E, L, T, M, B and D otherwise choose the Ellipse, Path, Text, Measure, Tabs and Start Point tools): Escape or V go back to the Selection tool. On iPad, the node bar replaces the keys.
Each gesture and each action is undone with ⌘Z.
Radius, notches and dogbones
The Radius tool is at the end of the node bar: a radius field (project unit), the Round or Notch Corners button, which applies it to the chosen corners (nodes between two straight segments; Return in the field does the same), and the Dogbone Style menu.
- Positive radius: fillet, an arc tangent to both segments (reduced if the segments are too short).
- Negative radius: a notch cut into the material. On an inside corner — where a round cutter always leaves a radius: the bottom of a slot, the corner of a mortise, of a hole or of a pocket —, it is a dogbone: a circle of the given radius through the corner, so that a part with sharp corners (tenon, box panel) fits all the way in. On an outside corner, it is an inverted fillet, a quarter circle centered on the corner.
- Zero radius on the two nodes on either side of a fillet or a notch (clicking one of its arcs is enough to choose them): the sharp corner comes back. With another radius, the fillet or the notch is redone at that radius.
Remove or change a radius (like MillMage's "Remove or Change a Radius"): click the arc of a fillet or a notch, then the Remove Fillet button (next to the dogbone style): the sharp corner comes back at the intersection of the two neighboring segments, and it stays chosen, ready for another radius. The button's tooltip gives the radius of the chosen fillet when it is a circular arc. This also works on the rounded corners of a rectangle (it becomes a path) and on imported arcs made of several curves; an arc imported as a series of short straight segments must first be rebuilt as an arc with Optimize shapes › Fit to arcs.
Dogbone styles, as for the dogbone slot: Diagonal Dogbone (the circle is centered on the bisector of the corner: the least material removed), Inline T-Bone (centered on the shorter of the two sides: the notch extends a slot lengthwise) or T-Bone on the Long Side (centered on the longer one: the notch stays hidden on the side).
Material side: a closed outline is solid, unless it is a hole, i.e. inside an odd number of other outlines (a mortise in a panel, even drawn separately), or unless an operation says so: a pocket, a rest pocket, a dogbone slot or an inside profile clear its inside, an outside profile keeps it solid. Shapes on the T1 and T2 tool layers do not count.
Dogbones on Inside Corners (Drawing menu, and Shapes menu of the toolbar): adds in one go a dogbone to every inside corner of the selected shapes, for example all the panels of a box and their mortises. The suggested radius is that of the tool of the operation that machines these shapes, otherwise of the tool chosen in the tool list (Studio: the first end mill of the project): a 3.175 mm end mill gives a 1.5875 mm dogbone, the cutter radius being the smallest that fits. Corners that are already rounded or notched do not change; a corner whose sides are too short for the radius stays sharp (Dusty says so). A single undoable action.
Negative corner radius of a rectangle (Shapes panel): each corner gets a notch, a dogbone if the rectangle is a hole or a pocket, an inverted fillet if it is solid; the rectangle becomes a path (it loses its rectangle Width and Height fields) and the notch is limited so that all four fit.
Without changing the drawing, the Dogbone slot operation also clears the corners of a rectangular slot.
Measure and trim
- Measure (M): drag from one point to another (the points snap to shapes); the distance, the X and Y offsets and the angle are shown during the gesture. Nothing is added to the drawing. The status bar also tells whether the shape under the pointer (or at the end of the measurement) is closed or open: a pocket, or an inside or outside profile, needs a closed shape.
- Trim (X): click part of an outline; it is removed between the two intersections around it (with the shape itself or another one). An outline without intersections is removed entirely. The remaining pieces join the open paths they touch (⌘-click: without joining them); the curves of the trimmed outline are rebuilt as closely as possible. Shift-click keeps a copy of the removed segment, placed on the active color, for example to engrave it rather than lose it; if the active color is that of the trimmed shape, the status bar says so (choose another color to tell them apart). The two toggles Keep a Copy and Join the Pieces, at the top of the canvas with the Trim tool, do the same without a keyboard (iPad); Shift and ⌘ then reverse their setting.
Tangent circles
Drawing › Tangent Circles (like MillMage's "Generate Tangent Circle"): select exactly three circles — ellipses of equal width and height (Shift while drawing them, or the same dimensions in the inspector) — then choose the command. All the circles that touch the three at once (up to eight) are drawn in light red; the one under the pointer turns bright red. A click creates that circle on the active color, selected, and ends the mode; Shift-click (or the Create Several toggle of the mode bar, with a finger) creates it and leaves the mode open to create others. Escape, Finish, a click elsewhere or another action end the mode. Each created circle is an undoable action; it is a true circle, which can be used in turn. If the command does not apply, Dusty says why (number of shapes, shape that is not a circle, no solution).
Navigating the canvas
- Zoom: ⌘+ and ⌘− (View menu), mouse wheel, trackpad pinch; zooming happens toward the pointer. ⌘0 shows the whole stock, ⌥⌘0 the selection.
- Move the view: two-finger scroll on the trackpad, or hold Space and drag, or drag with the middle mouse button.
- Toolpaths (⇧⌘T, Toolpaths button): the computed paths appear on the canvas, tinted from gold (surface) to purple (bottom), rapids dotted. Handy to check an operation without opening the preview.
- Wheel direction, grid, center cross and work area appearance are set in Settings.
Rulers, guides and display
- Rulers (View › Rulers, ⌘R): along the top and left of the canvas, graduated from the project origin, in the project's unit. Drag from a ruler onto the drawing to place a guide: horizontal from the top ruler, vertical from the left one. Shapes snap to guides. With the Selection tool, drag a guide to move it; dropped back on its ruler, it disappears. View › Clear Guides removes them all. Guides are saved with the page and never machined.
- Filled Shapes (View, ⌥⌘F): closed shapes are filled with their color, holes stay empty; otherwise the display is wireframe. Fast Outlines draws curves with less detail, for very busy drawings. This display style has no effect on machining.
- Transform toggles, at the left of the status bar: moving, rotating, scaling and shearing with the mouse. A toggle turned off prevents that gesture on the whole project, and its handles disappear; the inspector fields, the menus and the arrow keys still work. To freeze specific shapes, use Arrange › Lock instead. A window that opens has them all allowed, unless Settings › Interface › Remember the toggles is checked: it then takes their last state.
- Shear handles: with the Selection tool, two small diamonds near the top-right corner of the selection shear it. The one above, dragged up or down, tilts the horizontal sides; the one on the right, dragged left or right, tilts the vertical sides. The opposite edge stays in place (⌥: the center); Shift shears in steps of 15°. Arrange › Shear… shears by a typed angle.
- Status bar: pointer position, zoom, selection bounds ("Min (x, y) → Max (x, y)", from the project origin) or, while drawing a path, the dx and dy offsets and the length of the segment; then the tool tip of the current tool: what a click or a drag does, and the useful keys (the whole text in the help tag).
Editing and arranging
Selection and inspector
With the Selection tool: a click chooses a shape, Shift or ⌘ adds or removes, a dragged box chooses everything it touches; Tab moves to the next shape (Shift+Tab: previous); Escape deselects. The arrow keys move the selection by 1 mm (Shift: 10 mm, ⌥: 0.1 mm; adjustable). Delete removes it.
The Shapes panel of the inspector sets the selection precisely:
- Reference point: the point of the selection (corner, middle of an edge or center) whose X and Y are shown;
- X, Y (measured from the project origin), Width, Height, Keep proportions;
- Rotate by: an angle in degrees, applied when you confirm it;
- depending on the shape: Corner radius (rectangle), Sides, Inner radius and Secondary points (polygon and star, see Drawing tools), text settings;
- Locked: a locked shape can no longer be moved, resized or rotated;
- Paint colors: see Paint colors.
Editing: cut (⌘X), copy (⌘C), paste (⌘V), paste in place (⌥⌘V, at the same position), duplicate (⌘D), duplicate with operations (⇧⌘D: the copies join the operations of their originals), delete, select all (⌘A), invert selection (⇧⌘I). The shape clipboard belongs to Dusty. The Edit › Select submenu chooses:
- the open shapes of the drawing (those a pocket refuses);
- the shapes inside the selection (holes and details inside the selected closed shapes);
- the shapes smaller than the selection (for example all the small holes of an imported drawing: select the largest of them);
- circles by diameter…: drawn circles and imported circular outlines between a minimum and a maximum diameter, for example all the holes of one drilling.
Shapes inside, smaller shapes and circles are only looked for among visible, unlocked shapes.
Right-clicking the canvas (long press on iPad) offers the editing commands, lock, drawing order, New Operation on the selection and assignment to the selected operation; outside the shapes: select all, invert selection, select open shapes.
Undo (⌘Z) and Redo (⇧⌘Z) cover both the drawing and the operations, in the order you made the changes.
Undo history
Edit › Undo History… (⌥⌘Z) lists the starting state, the actions done (drawing, operations, settings, notes, pages), then, dimmed, those that can be redone. Choosing a step takes the project back to it right away: the canvas shows the result. OK keeps that state; Cancel restores the one from when the window opened. As with ⌘Z, going back before adding, duplicating or deleting a page discards the actions that followed it.
Calculations in fields
Every number field (inspector, drawing, tools, operations, machine, settings) accepts a calculation, confirmed with Return or by leaving the field:
- the four operations and parentheses:
100/3,2*(10+5),=12.7+3(a leading=is allowed); - units, converted into the field's unit:
1in,3/4",1 3/4",25.4mm,2cm,0.5m,1ft 6in; in a field in inches, a number without a unit is in inches and10mmstays in millimeters; - a percentage of the current value:
50%in Width gives half the width,150%one and a half times (in a field already in %,50%simply means 50).
The decimal comma is accepted in French (the point always is); in English, a comma followed by three digits separates thousands (1,000). An invalid entry (10+, abc, division by zero, a length unit in an angle or speed field) is refused: the field keeps its previous value and a message shows below it.
Arranging
The Arrange menu and the Arrange button of the toolbar offer:
- Group (⌘G), Ungroup (⇧⌘G) and Auto-Group: each selected closed shape is grouped with the shapes it contains (a part and its holes become one);
- Lock (⌘L) and Unlock (⌥⌘L);
- Align (at least two shapes; the reference is the last shape selected, Shift-clicked last): left edges (⌃⌘←), horizontal centers, right edges (⌃⌘→), top edges (⌃⌘↑), vertical centers, bottom edges (⌃⌘↓);
- Distribute (at least three shapes): centers or equal spacing, horizontally or vertically;
- Place on Stock: the four corners, the middles of the four sides, or the center (⌃⌘C);
- Dock left, right, up or down (⌃⇧⌘ and an arrow; also in the Shapes panel): each shape slides until the first shape in its way or the edge of the stock; a shape lying inside another one does not stop at its inner edge. Options, below the buttons of the Shapes panel (padding and inner objects are shared with nesting):
- Padding: gap left against the obstacle or the edge; a shape already closer does not move back (dock one way, then the other, to even out the gaps);
- Move as group: the whole selection stops at the first obstacle, its shapes keep their spacing (a group always moves as a whole);
- Lock inner objects: a shape lying inside another one moves with it, grouped or not; otherwise it slides on to the first obstacle;
- Move Together horizontally (⌃⇧⌘H) or vertically (⌃⇧⌘V): the shapes come edge to edge, without gaps, in their order; the first one does not move;
- Same Size: same width or same height as the last shape selected, around the center of each shape; with Keep Proportions, the other dimension follows in the same ratio;
- Rotate by 90° (⌥⌘← and ⌥⌘→), 45° (⌃⌥⌘← and ⌃⌥⌘→), 15° (⌥⇧⌘← and ⌥⇧⌘→) or 1.5° (⌃⌥⇧⌘← and ⌃⌥⇧⌘→), left or right; in Dusty Studio and the desktop app, Ctrl+← and Ctrl+→ (1.5°), Ctrl+Shift+← and Ctrl+Shift+→ (45°), "," and "." (90°); By Two Points: click the pivot, then a reference point of the selection, then its new place (the status bar guides the clicks, Escape cancels); Rotate and Scale by Two Points also enlarges or shrinks the selection to bring the reference point exactly to its new place; holding Shift on the third click switches from one to the other;
- Shear…: shears the selection around its center by a horizontal angle (the vertical sides lean) and a vertical angle (the horizontal sides lean); with the mouse, see the shear handles in Rulers, guides and display;
- Flip Horizontally (⇧⌘H), Flip Vertically (⇧⌘V), Mirror Across Line… (⇧⌘M): the open line selected last is the axis and stays in place; the sheet shows the reflection in pink, then adds a mirrored copy (the original stays; its operations are copied if you ask) or flips the shapes;
- Grid Array… and Circular Array…: see Arrays;
- Nest…: see Nesting;
- drawing order: Bring to Front (⇧⌘]), Bring Forward (⌘]), Send Backward (⌘[), Send to Back (⇧⌘[).
On the canvas, with the Selection tool and a selection: A aligns it to the hovered segment of one of its shapes (see Editing nodes); , and . rotate it 90° left and right; Shift+L, Shift+R, Shift+T and Shift+B align the left, right, top and bottom edges, Shift+C and Shift+E the centers (on one vertical line, on one horizontal line), Shift+P moves the selection to the center of the stock. Letters on their own still choose the tools.
Shape operations
The Drawing menu and the Shapes button of the toolbar combine and transform shapes:
- Union (⌥⌘U): a single shape that covers the others; a group counts as one shape;
- Subtract (⌥⌘S): removes the last shape selected from the others;
- Intersection (⌥⌘N): keeps the common part;
- Weld (⌥⌘A): merges all the selected closed shapes into one, each counting for itself, group members included (unlike the union, where overlapping parts of a group cancel out);
- Cut with Shape (⌥⌘X): the last shape selected, closed, cuts the others; each one is replaced by its inside part and its outside part, and the cutting shape disappears; an image becomes two masked copies (see Image masks);
- Boolean Assistant…: the five possible results on two closed shapes (A: the first selected, B: the second) as thumbnails — union, A minus B, B minus A, intersection, exclusion; the chosen result is drawn in pink on the canvas, Apply puts it in place of the two shapes;
- Offset… (⌥⌘O) and Optimize Shapes… (⌥⇧⌘O): see Offset and Optimize shapes;
- Convert to Path (⌥⌘C): a rectangle, ellipse, polygon or text becomes a path you can edit node by node;
- Break Apart (⌥⌘B): splits a shape made of several outlines into separate shapes;
- Rubber-Band Outline (like MillMage's "Create Rubber-Band Outline"): a new closed shape surrounds the selection as tightly as possible, like a rubber band stretched around it (convex hull); it goes on the active color, selected, and the original shapes stay. A quick basis for a cut line around a complex drawing or an image (its frame, rotated with it, or the visible part of a masked image), or for an offset;
- Tangent Circles, Warp (4 Corners), Deform (16 Points) and Resize Slots…: see Tangent circles, Warp and Resize slots.
Operations follow the shapes. A shape created in place of others (union, weld, cut, Boolean assistant, an offset replacing its shapes, break apart, joined paths, deleted duplicates) joins the operations its original shapes were assigned to, in the same undoable action; the shape removed by a subtraction and the cutting shape do not pass theirs on. A shape that is moved, rotated or resized keeps its operations.
Offset
Drawing › Offset… (⌥⌘O) creates an outline at a constant distance from the selected shapes: a border around a text, a cut line around an engraving, an inner frame. The sheet opens at the edge of the canvas, which stays visible: the result is drawn in pink at each change, before you confirm.
- Distance;
- Direction: outward, inward, or both sides (two outlines); an open path is surrounded by an outline at the chosen distance on both sides;
- Corners: round, sharp or bevel (only the corners pointing in the direction of the offset change);
- Replace the original shapes: the offset takes their place and joins their operations; otherwise it is added next to them;
- Outer outlines only: holes and outlines lying inside another outline of the result are left out;
- Group the result;
- Simplify the result: the outlines are rebuilt as smooth curves, with far fewer nodes (0.05 mm deviation at most);
- Select the result (checked by default): otherwise the selection stays on the original shapes.
Offset creates the result in a single undoable action; Cancel or Escape closes the sheet without changing anything.
Drawing › Repeat Last Offset (⌃⌥⌘O; also in the context menu) offsets the selection with the settings of the last offset made since Dusty was opened, without opening the sheet: handy to give several parts the same outline one after the other. The command stays dimmed until an offset has been made. In Dusty Studio it has no default shortcut: pick one in the shortcut editor. Difference from MillMage: there is no ⌘-click on an Offset button (Dusty has none); the menu and the shortcut replace it, on iPad too.
Optimize shapes
Drawing › Optimize Shapes… (⌥⇧⌘O) rebuilds the selected paths (or the whole drawing without a selection) with fewer nodes, never straying from the original by more than the tolerance; useful after a DXF import or a trace:
- Smooth shapes: smooth curves, wobbles and jagged edges softened;
- Fit to lines: runs of small, nearly aligned segments become true straight lines;
- Fit to arcs: circular arcs and straight lines, for smoother moves and for the Radius tool. The arcs reach the G-code as true arcs (
G2,G3): see Arcs in the G-code.
The optimized paths and their nodes are drawn in pink; the counters give the number of nodes before and after. Rectangles, ellipses, texts and images are left alone. Optimize applies it all in a single undoable action.
Warp
Drawing › Warp (4 Corners) (MillMage's "Warp Selection") stretches or squeezes the selection by dragging the four corners of its frame: perspective, stretched corners, text effects. Drawing › Deform (16 Points) ("Deform Selection") lays a 4 × 4 grid of handles over the selection: you reshape it freely, for example to make a text follow the shape of an object. The handles and the grid are pink; the shapes follow during the drag and become paths (straight lines bend with the warp).
- Each drag of a handle is an undoable action; a double-click on a handle puts it back in place.
- Shift during the drag: the left-right symmetric handle follows as a mirror; ⌥: the top-bottom symmetric one; both together: the three others. Without a keyboard (iPad), the Left-Right Symmetry and Top-Bottom Symmetry toggles of the mode bar do the same; the key then reverses the toggle.
- Finish (mode bar), Return, Escape, a change of tool or a click outside the handles end the warp. Images are not warped.
Resize slots
Drawing › Resize Slots… (MillMage's "Resize Slots") adapts the slots (halved joints, dados) and tabs (tenons, box fingers) of the selected shapes to another material thickness, or brings them back to size after scaling the whole drawing. It is a different tool from the machining tabs.
First measure the current length of a slot or a tab with the Measure tool, then set:
- Old Thickness: length of the slots or tabs to recognize; Tolerance: allowed deviation around it (variations in the drawing, kerf compensation already drawn); New Thickness: the length you want;
- Adjust Slot Depth: the bottom of the slots moves, the outer size of the assembly does not change;
- Adjust Slot Width: both sides of the slots move apart or closer symmetrically (dividers crossing in the middle of a part, like the compartments of a tray); Dusty also widens mortises (rectangular holes in the part, even drawn separately), which MillMage does not;
- Adjust Tab Height: the top of the tabs moves, the inner dimensions of the assembly do not change.
A slot is a recess of three straight sides (two parallel sides, a bottom perpendicular to them) that opens on an edge of the part; its depth is the length of its shorter side, its width that of its bottom. A tab sticks out of the part from a shoulder; its height is the length of its shorter side (a lone rectangle is not a tab). The result is drawn in pink at each change, with the moved nodes, and the sheet counts the slots and tabs found. Apply makes the change (one undoable action) and leaves the sheet open, OK makes it and closes the sheet, Cancel closes it without doing anything more (what was applied is undone with ⌘Z).
Conditions, as in MillMage: sharp corners and straight segments only (first remove fillets with the Radius tool); an extra node in the middle of a side, or a "curve" that is not straight, prevents the slot from being recognized: Optimize shapes › Fit to lines repairs them. Only paths are changed (convert rectangles and polygons first); members of groups are handled like the other shapes.
Arrays
Arrange › Grid Array… repeats the selection in columns and rows, the original at the top left:
- Columns and Rows;
- spacing between edges or center to center, or a set total width and height (the spacing follows);
- shifts: every other column moves down, every other row moves right (staggered), by a given value or by half a step; copies to the left or upward;
- mirrors of every other column or row, horizontally or vertically (parts nested head to tail);
- random orientation: each copy turns about its center by an angle drawn at random from the seed (a whole number); the same seed gives exactly the same layout again, on Mac, iPad, Studio and the desktop app (tile patterns, puzzle pieces, a "natural" look);
- virtual array: clones linked to the originals instead of copies (see Virtual arrays).
Arrange › Circular Array… spreads copies around a center (suggested below the selection; X and Y counted from the project origin, as in the inspector), from the start angle to the end angle (clockwise on screen; a 360° span: the whole circle), rotating the copies or keeping their orientation.
Both sheets draw the copies in pink (and the center of the circular array), and give the number of copies, the total size and the step. Group the result puts the original and the copies in a group; Copy assigned operations has the copies join the operations of their originals. Auto-increment variable text adds a step to the offset of the variable texts and codes of each copy, to number the parts of a sheet (Variable text). Create adds everything in a single undoable action.
To repeat a part along a curve or around a shape, see Copy along a path; for the order in which the copies are machined, Cut order of repeats.
Virtual arrays
With Virtual array checked, the Grid Array sheet creates clones instead of copies: a single instance of each shape stays in the drawing (the originals), the others are drawn dashed and faded and follow everything done to the originals — moving, rotating, resizing, nodes, text. Change one part and the whole sheet follows. Clones cannot be selected or edited one by one.
Clones are machined like their originals: each is one more shape for the operations its original is assigned to (by hand or by its color), with its tabs, start point and cut direction. They also go into the preview, the 3D view, the pre-send check, the G-code and the drawing export. The array and its settings are saved in the .dusty file.
Right-click (long press on iPad) an original — no need to select them all — or Arrange › Virtual Array:
- Edit Array… reopens the Grid Array sheet on the array's settings (seed included); its clones are hidden while the sheet is open, the pink preview replaces them. Apply changes the array; unchecking Virtual array turns it into independent copies, which take over the operations of the originals;
- Duplicate Array copies the originals in place, with a new array with the same cells (the new originals are selected: move them); as with Duplicate, the copies do not take over the operations;
- Flatten Array: the clones become independent copies, selected with the originals; they take over the operations of their originals, the machining does not change;
- Remove from Array: the selected objects leave the array and their clones disappear; the clones of the other originals stay exactly in place;
- Add to Array (select at least one original and one other object): the other objects take the array's cells, their clones appear; the clones already there do not move;
- Exit Array: the clones disappear, the originals stay.
Each action is a single undoable action. Variable text: a clone comes out with the same value as its original (as in MillMage, the variable text increment does not apply to virtual arrays); to number the parts, flatten the array or use an ordinary array with Auto-increment variable text. Difference from MillMage: only the grid array creates virtual arrays, as in MillMage; an array from a project opened without its settings (made by another version) is edited starting from a single row of its instances.
Copy along a path
Arrange › Copy Along Path… repeats objects along a line, a curve or around a shape: a decorative border, a frieze, the marks of a curved ruler, fixing holes along an edge.
- Select the objects to copy first (one or more shapes, a group, a text, a code — not an image), then the path last (Shift-click, or Shift and touch with a keyboard on iPad): a single path, neither a group nor an image. Without the Shift key (iPad without a keyboard, marquee selection), if the last selected object cannot serve as the path, Dusty takes the first one that can; Change Path, at the top of the sheet, moves on to the next object (the pink start shows which one is the path). The command is dimmed if no object can serve as the path.
- Placement: the original is the first instance; its position relative to the start of the path gives the position of each copy. Centered on the start, each copy is centered on the path; offset by 5 mm, each copy stays 5 mm from the path, on the same side. Start of an open path: its first point (see Start point and direction to change it); on a closed path, the copies start from the point nearest the original and go all the way round.
- Spread by the number of instances (original included): evenly, from the start to the end of an open path, all around a closed path; by the spacing between copies: as many instances as the path holds at that spacing (measured between their centers, along the path), the rest at the end of the path.
- Rotate copies along the path: each copy turns by the change of direction of the path since the start (its offset turns with it); otherwise they all keep the orientation of the original.
- Progressive size: the size changes evenly up to the last instance, in % of the original (over 100%: larger).
- Copy assigned operations and Auto-increment variable text: as for arrays.
The copies and the start (pink square) are drawn on the canvas; the summary gives the number of instances, the path length and the actual spacing. Create adds the copies in a single undoable action; the original and the copies are selected, the path stays (move it to a tool layer if it must not be machined).
Nesting
Arrange › Nest… (also below the Dock buttons of the Shapes panel) arranges the selected parts to save material, on one sheet or several. The sheet opens at the edge of the canvas; while it computes, the best layout found is drawn there in pink (the next pages to the right of the container).
- Mode: Quick (bounding boxes) arranges the rectangles around the parts (quarter turns allowed), in an instant; True shape follows the outline of the parts — a part fits into the hollow of another (an L, a letter) — and looks for better layouts during the optimization time.
- Container: the page stock, or the selected shape: the largest closed shape in the selection (by its area); in quick mode it must be an axis-aligned rectangle. Unselected shapes lying in the container are avoided.
- Spacing: between parts (at least the bit diameter if the parts are cut out: a profile runs between two parts) and from the container edge.
- Lock inner objects: a shape lying inside another one (a hole, an engraved detail) moves with it, grouped or not; otherwise it is nested on its own. Holes in the parts do not receive other parts.
- Lock rotation: no rotation (wood grain); otherwise quarter turns in quick mode and, in true shape, the allowed orientations (every 1°, 2°, 3°, 5°, 10°, 15°, 30° or 45°, quarter turns, half turns).
- Multiple pages: what does not fit goes onto new pages, created right after the open page with its settings, a copy of the container (when it is a shape of the drawing), their parts in place and the operations of those parts; without the option, what does not fit stays in place.
The summary gives the number of parts and the size of the container, and warns: degenerate shapes (zero length or area) and locked parts left in place (a locked part is avoided like an obstacle), parts too large for the container in all their allowed orientations. Nesting is refused without parts, without a container, or with a rotated container (or one that is not a rectangle) in quick mode.
Nest starts the computation; the parts placed, the pages, the material use (area of the placed parts over the container area times the number of pages) and the number of trials are shown. In true shape, Stop applies the best layout found, Next Page (multiple pages) freezes the current page and goes on with the remaining parts on the next ones; when the chosen time is up, the best layout is applied. Cancel changes nothing. The result is a single undoable action (⌘Z), created pages included; it is not applied if the drawing changed during the computation.
Parts start from the corner of the project origin and fill the short side of the container first, moving along the long side as little as possible: the offcut stays in one piece, at the end. The same selection with the same settings gives the same layout. True shape follows the parts on a fine grid (1/720 of the container's long side, 0.1 mm at best): the gaps you get are slightly larger than the spacing asked for, never smaller. In Dusty Studio and the desktop app, the computation runs in short slices so the page stays usable.
Cleaning up paths
Imported drawings (DXF above all) often arrive as separate segments, nearly closed paths or overlapping shapes. The Edit menu (and the Shapes button of the toolbar) puts them in order:
- Close Path: joins the two ends of each selected open path with a segment, whatever their distance; with the Edit Nodes tool, closes the path being edited;
- Close Paths with Tolerance…: closes the open paths of the selection (or of the whole drawing without a selection) whose ends are closer than the tolerance (0.5 mm suggested), with a segment, or by moving the ends together halfway; the window counts the open paths and those that will be closed;
- Join Paths (⌘J): joins into one path the selected open paths whose ends touch (within 0.1 mm);
- Delete Duplicates (⌥⇧⌘D): removes identical overlapping shapes (same color, same path), in the selection or in the whole drawing; the first copy stays;
- Reverse Direction: cutting direction of the selected shapes, see Start point and direction.
To find the paths left open: Edit › Select › Open Shapes; Open Shapes of Pockets keeps only those that a pocket (or another operation that needs closed shapes) would ignore.
Tracing an image
An imported image (PNG, JPEG…) serves as a model: select it, then Drawing › Trace Image… turns its dark areas into shapes. The sheet shows the image and the shapes found; the shapes to come are also drawn in pink on the canvas, in place. Dragging in the preview traces only part of the image (Whole Image goes back to all of it); Fade image dims it to see the shapes better, Show points shows their nodes.
- Upper threshold and lower threshold: range of brightness traced (from black up to the upper threshold, starting at the lower threshold);
- Trace transparency: for a cut-out image (PNG with a transparent background, image flattened on its mask), the outline of the parts that are at least half opaque; colors, inner details and the brightness thresholds are ignored (the thresholds leave the sheet). If the image has no transparent part, the sheet says so: only its frame would be traced;
- Sketch: strokes darker than their surroundings, for a drawing, handwriting or a document photographed under uneven lighting; the threshold becomes Sensitivity (higher: paler strokes kept). The surroundings span about a thirtieth of the image: of a large black area, only the edge is kept;
- Ignore areas smaller than: smaller specks and holes removed (image pixels);
- Node reduction and Smoothness: simpler paths, corners more or less rounded (center lines included);
- Center line: a line down the middle of each stroke of the drawing instead of its outline (see Center line);
- Group the result, Delete the image.
Trace creates the shapes, selected, on the active color (or the next one if it is in Image mode), in a single undoable action. A masked image is traced only in its visible part (see Image masks).
Center line and one-pass engraving
With Center line, each stroke of the drawing (line art, handwriting, quilt pattern…) gives a line down its middle instead of its outline: open for a stroke with two ends, closed for a loop (circle, frame). Strokes that cross or meet give connected lines. The small branches that would run to the corners of a stroke or to the bumps of its edge are removed, at the scale of each stroke: a thin stroke keeps its details next to a thick one. A stroke end stops half a width from the edge, where the center of a bit as wide as the stroke stops; in a corner, the line cuts the corner slightly (less than one image pixel). A round dot, with no length, gives nothing.
The sheet gives the stroke width (median) to choose the engraving:
- single-line engraving: Profile operation, On the line side, with a bit of that width;
- V engraving: Profile on the line with a V-bit, at the depth where the groove is as wide as the stroke, that is width ÷ (2 × tan(angle ÷ 2)): 0.87 times the width with a 60° bit, half of it with a 90° bit (the sheet gives both). On open lines, the V-carving operation does the same: Limit maximum depth to that value (a closed line would be carved out like a shape there: keep the profile for loops).
To engrave strokes of varying width to their exact shape, V-carving the outlines (without center line) remains the most accurate.
Differences from MillMage: the stroke width and the suggested depths are Dusty's own; the transparency boundary lies at half opacity.
Images and masks
An imported image (PNG, JPEG…) is not machined as it is: it serves as a model to trace (see Tracing an image). Select it to adjust and prepare it.
Image properties (Shapes panel › Image; Dusty Studio: inspector): pixels of the file, size placed on the drawing and resolution (DPI), original file, mask; then adjustments that change the image as shown and traced without touching its file:
- Gamma (1: neutral; lower darkens the midtones, higher lightens them), Contrast and Brightness (−100 to 100%);
- edge Enhancement (0 to 300%), Enhance radius (pixels), Noise threshold (smaller gray differences are not enhanced, against grain);
- Inverted display: the image as a negative, on screen only;
- Reset adjustments.
Each adjustment is an undoable action.
Image Options (Drawing › Image Options and the context menu; a single image, not grouped, as in MillMage):
- Reload Image: reads the original file again, retouched in another program; same place, same size, same adjustments, same mask. On Mac and iPad, access to the file is kept with the project; if the file was moved or deleted, Dusty asks for it. Dusty Studio and the desktop app read the file chosen at import again while the page stays open, when the browser allows it (Chrome, Edge); otherwise they ask for it again.
- Replace Image…: another file takes the image's place (center, rotation, adjustments and mask kept), at the same scale (millimeters per pixel);
- Replace Image to Fit…: the new image fits in the frame of the old one, proportions kept.
Image masks
A mask keeps only part of the image visible: to crop it, or to isolate a subject before tracing it. Commands: Drawing menu (or the toolbar's Shapes button) and the context menu; Dusty Studio: Drawing menu and the plan's context menu.
- Apply Mask to Image: select an image and one or more closed shapes (rectangle, path, text, group…). Only the inside of the shapes stays visible; nothing is deleted. The shapes stay in the drawing, moved to tool layer T1 (visible, never machined): they are the mask.
- Removing the center: a shape placed inside another makes a hole. To remove the center of an image and keep its outer part, surround the shape to remove with a larger shape (outside the image to keep its edges, or cutting into it to crop it as well), select both with the image and apply the mask.
- Edit Mask: the mask's shapes are edited like any shapes (move, resize, rotate, Nodes tool, booleans, text) and the visible part follows, in the same undoable action. Moving the image alone slides it under the mask; moved together, image and shapes stay matched (grouping them avoids separating them by accident). The Edit Mask command selects these shapes; a mask that has none (project from an earlier version) is first turned into a shape on layer T1. New shapes applied to a masked image are added to its mask.
- Remove Mask: the image is whole again and the mask's shapes get their color back. Deleting the mask's shapes also makes the image whole again.
- Flatten Mask: the hidden parts are removed for good. The image is cropped to the mask, transparent outside it, and the mask's shapes disappear; its bounds no longer cover what was hidden, which makes alignments more accurate.
- Crop Image: with an image and closed shapes, applies the mask and flattens it in a single step; with a masked image alone, flattens it. No mask is left to edit or remove.
- Cut with Shape (⌥⌘X) on an image: two copies of the image, one masked inside the cutting shape, the other outside, each with its own mask shape (a copy of the cutting shape) on a tool layer: T1 inside, T2 outside.
Each command is a single undoable action; the link between an image and its mask's shapes is saved with the project. An image duplicated, copied or repeated together with its mask's shapes keeps a mask linked to their copies.
From images to machining. Dusty does not machine pixels: an image assigned to an operation is ignored, and Dusty says so. A masked image goes to machining through tracing: only its visible part is traced, shapes straddling the edge of the mask are cut there; the shapes obtained then get their operations (profile, pocket, V-carve…). The mask's shapes, on a tool layer, are never machined, even when assigned to an operation.
Differences from MillMage: the mask's shapes move to tool layer T1 (MillMage leaves them on their color); the visible part follows a shape at the end of the gesture, not during it; an open mask shape (cut path) no longer masks anything; in Dusty Studio, Reload Image asks for the file again when the browser does not keep access to it.
Paint colors
Each shape has a paint color, chosen in the strip below the canvas. Colors group the shapes of one machining step: an operation can machine all the shapes of its color, including those you will add later.
- Click a color: the selection takes it; with nothing selected, it becomes the color of the next shapes. Colors in use are solid, the active color is circled.
- Shapes panel › Paint colors: each color in use, with its name (editable), its number of shapes and an eye to hide it. Clicking its swatch selects its shapes, Shift-clicking adds them to the selection; right-clicking offers to flash its shapes on the canvas (to find them), to add them to the selection, or to delete the color and its shapes. In Dusty Studio and the desktop app, Drawing panel › Colors: right-clicking a color flashes its shapes; the name is edited in place (Enter or leaving the field; Escape cancels), and ✕ deletes the color and its shapes, after confirmation if it has any. Both can be undone (Ctrl+Z); the last cutting color cannot be deleted.
- Each operation type gets a suggested color (profile, pocket, drill… each have their own): by painting your shapes with that color before creating the operation, you find them all at once.
- Palettes for drawing software: File › Export Color Palette saves the paint colors for GIMP, Inkscape and Krita (
.gpl), Adobe Illustrator and Affinity (.ase) or CorelDRAW (.xml). A drawing made with exactly these colors gets each shape back on its paint color when imported (otherwise each color is matched to the nearest one of the palette).
Importing and exporting
Importing
File › Import… (⌘I), the Import button, or a file dropped on the canvas:
| Format | What is imported |
|---|---|
| SVG, DXF, PDF, EPS | The vector shapes, at their size. |
| AI (Adobe Illustrator) | The shapes of a file saved as “PDF compatible” (Illustrator's default); layers hidden in Illustrator are left out unless the setting says otherwise (see below). |
| PLT, HPGL | The plotter paths, at the precision chosen in the settings: one pen, one color; lines, arcs, circles, rectangles, wedges, polygons and HP-GL/2 encoded polylines; a path that comes back to its start becomes a closed shape. The plotter's texts and scaling are not brought in (Dusty says so). |
LightBurn project (.lbrn2, .lbrn) | The shapes, groups, texts and images, in place, in the paint colors of the LightBurn layers (their names are kept on free colors, their laser settings ignored); the project notes in an empty project. |
MillMage project (.mage) | The shapes (with their tabs and start point), the layers, the tools and the operations; in an empty project, the project setup too: this opens it (see MillMage projects). |
G-code (.nc, .gcode) | The paths of the program, as shapes to rework (to send it as is: Opening and replaying G-code). |
| PNG, JPEG, TIFF, BMP, GIF, WebP | An image, as a template to trace over: images are not machined (see Images and masks). |
Imported shapes are selected; Settings › Import can also center them on the stock. If a file contains no usable shape, Dusty says so. Check the size after importing: some programs write their SVG files in other units.
To send a G-code file as is to the machine, use File › Open G-code… (⇧⌘O) instead: see Opening and replaying G-code.
After importing a LightBurn or MillMage project, Dusty shows a report: what was brought in, then what has no equivalent or deserves a check. After an HPGL or Illustrator file, it likewise says what was left out: plotter texts, ignored scaling, names of the hidden layers.
Settings › Import also sets:
- Group shapes from the same file: everything a file brings arrives as one group;
- DXF: follow the units declared by the file (otherwise, and for a file without units, the chosen unit: millimeters, centimeters or inches), ignore text (dimensions, notes), close paths whose ends touch within the chosen tolerance (the separate lines and arcs of an outline become one closed outline, usable by a pocket; 0: never);
- SVG: resolution of files without physical units, 96 DPI (Inkscape, the default) or 72 DPI (Illustrator). Change it if SVG files from a program arrive at the wrong scale; an SVG sized in mm or inches is not affected;
- HPGL / PLT: file precision, 1016 units per inch (the HP standard, 40 per mm, the default) or 1000 units per inch (some plotters and cutting software). Change it if a plot arrives slightly too small or too large (1.6%);
- Adobe Illustrator: Import hidden layers from AI files. Off (the default), layers hidden in Illustrator are not imported and their names are listed; on, everything is imported. The file itself is never changed.
Art library
An art library stores drawings to reuse from one project to the next: logos, motifs, jigs, labels… An entry (a motif) can gather shapes, texts, images and groups, with their colors; it never keeps operations (to keep machining settings, save a project or a template, or use the operation library).
Art Library panel of the inspector (grid icon; Art tab in Dusty Studio):
- Libraries: several can be loaded together, to sort by theme (holidays, animals…) or by use (tests, jigs, boxes); the choice at the top of the panel shows one of them. The ⋯ menu: New Library… (a
.dustyartfile in the app's Art folder), Load Library… (a.dustyartfile taken elsewhere, found again at the next launches), Add Basic Motifs, Rename Library… (the name is kept in the file), Export a Copy… (to share it) and Unload (removes it from the list; the file stays where it is). - Adding motifs: Import… adds files, one motif per file, named after it (SVG, DXF, PDF, AI, EPS, HPGL, images, LightBurn, MillMage and Dusty projects — for a project, the drawing of its open page), with your import settings; Add Selection stores the selected shapes, under the suggested name (“Motif 3”) or the one you give.
- Motifs: their thumbnails; a click chooses one, the context menu (right-click, long press) renames or deletes it.
- Add to Project: the button (or a double-click) adds the chosen motif at the center of the view; dragging a thumbnail onto the canvas drops it where you release it. The added motif is selected, in a single undoable action; its colors are kept.
Every change is saved at once in the library file. A library is shared like any file (e-mail, USB stick, iCloud Drive); a .dustyart file dropped on the canvas is copied into the Art folder and loaded. Loaded libraries also travel in a user bundle.
Basic motifs: eleven simple motifs of about 40 mm, drawn for Dusty and free to use in your projects (heart, star, arrow, leaf, crescent moon, house, drop, gear with a hole, flower, cloud, tag with a hole). Dusty downloads no library.
In Dusty Studio and the desktop app, the page keeps a copy of each library (a browser keeps no file): Load… copies a file there, Export a Copy… writes one, Unload removes the copy after confirmation; the commands are buttons under the library choice, and those of a motif appear when you choose it.
MillMage projects
A MillMage project (.mage) opens in Dusty with its shapes, operations, tools and project setup:
- Mac and iPad: in the presentation of a new project, Open a MillMage or LightBurn Project…; or File › Import… (⌘I) or a file dropped on the canvas. In an empty project, the MillMage project also brings its setup (stock, heights, origin, Z zero, units) and its notes; in a project in progress, its shapes, tools and operations are added and the project setup is kept. A single action, undone with ⌘Z.
- Dusty Studio and desktop app: File › Open… (or a file dropped on the page) replaces the open project; File › Import… adds it to the current project, as on Mac.
The MillMage file is never rewritten: Save creates a .dusty project.
| In MillMage | In Dusty |
|---|---|
| Project setup (stock, safe height, fast retraction, pocket lift, Z zero, units) | Project setup, in an empty project. The MillMage machine is not brought in: Dusty machines with its active machine. |
| Layers | Paint colors with the same number: their name and visibility. |
| Tools of the operations | Project tools, without duplicates (a tool used by several operations, or already in the project, is added once). |
| Profile (side: outside, inside, on the line), Pocket, Rest Pocket, V-Carving | Operations of the same type, with depths, passes, feeds (converted to mm/min), spindle speed, stepover, stock to leave, entry (plunge, ramp, spiral, helix), tabs, vacuum, coolant and color. |
| Other types (drilling, chamfer…) | Operation of the same type: only the common settings (depths, feeds) are brought in, to be checked. |
| Tabs placed on shapes, start point | Tabs placed by hand and start point of the shapes. |
The report points out what has no equivalent (unknown shape or operation type, setting not brought in) and doubtful values, without ever preventing the opening:
- an aberrant feed (above 30 m/min, 10 m/min when plunging, or far faster than its tool's) is replaced by the tool's;
- a depth beyond the stock is kept but pointed out (the tool would cut into the spoilboard), as is a depth that looks like a value in inches or tabs higher than the cut;
- an origin other than the bottom-left corner, whose match is not established, is set to the bottom-left corner: check it in the project setup before machining.
Exporting the drawing
File › Export › Whole Drawing… (⌘E) or Selection… (⌥⌘E):
- SVG and PDF at the size of the stock, in millimeters;
- Adobe Illustrator (AI) at the size of the stock: a “PDF compatible” file that Illustrator opens, with one layer per Dusty layer, under its name; a layer hidden in Dusty is hidden in the file too;
- DXF (AutoCAD 2000) and DXF R12 for older software (the color of each layer becomes the nearest AutoCAD color). By default, curves are cut into small segments; Settings › Import › DXF › On export › Native arcs writes circular arcs (circles, fillets, rounded corners, dogbones) as real arcs, which CAM software reads back exactly;
- Modern DXF (AutoCAD 2007,
AC1021): straight outlines as lightweight polylines, circles as circles, ellipses as native ellipses, curves as exact B-splines (no loss). Software that only reads R12 cannot open it: use DXF R12 then.
The window shows the number of shapes written (images are not exported) and the page size, then Export… opens the save window. For G-code, see Saving the G-code.
In Dusty Studio and the desktop app, the formats are in the File menu (Export Drawing as…) and in Export Selection.
Printing
File › Print in Black… (⌘P) or Print in Colors… (⇧⌘P); on an iPad without a keyboard, the More menu. In Dusty Studio and the desktop app: Ctrl+P and Ctrl+Alt+P (⌘P and ⌥⌘P on a Mac, where ⇧⌘P opens the job preview), to change in the shortcut editor.
- The page is the size of the stock, at scale 1: the shapes of the shown layers (variable texts and codes at their values, repeats included) and the images with their settings, under the lines.
- In black: black lines, images in grayscale. In colors: each shape in the color of its layer.
- The system's (or the browser's) print window chooses the printer and the paper; a page larger than the paper is scaled down to fit. It also offers to save as PDF.
- For a template to stick on the workpiece, keep the scale at 100% (“actual size”) and measure a dimension on the paper before using it.
Machining operations
An operation says how to machine shapes: its type (profile, pocket…), its tool, its depths, its feeds and its own settings. A shape can be used by several operations (a pocket, then a profile, for example), and an operation can machine many shapes.
Creating an operation
- Select the shapes to machine.
- New Operation (toolbar, Operations menu, Operations panel or right-click on the canvas), then the type. The operation receives the selection and the first project tool that suits its type.
- Set it in the Operations panel: the list at the top (in machining order), the editor of the selected operation below. Its shapes are highlighted on the canvas, in its color.
Editor header:
- Name (empty: the type name), Mode (the type, fixed at creation), Color;
- Output enabled: a disabled operation stays in the project but is neither computed nor sent (also the checkbox in the Output column of the list);
- Tool: the project tools whose shape suits the type, or Tool from Library (copied into the project). Choosing a tool copies its feeds and speeds into the operation;
- Machine all shapes of its color: the shapes of the operation's color are added automatically;
- Machined shapes and the buttons Assign selection (replaces its shapes), Add (⌘K), Remove (⇧⌘K), Select its shapes on the canvas.
At the bottom, the Problems section lists what prevents or hinders the computation: no tool, no shape, an open shape where closed shapes are needed, a depth beyond the stock… An operation to check shows an orange triangle in the list. The status bar counts the shapes used by no operation.
The columns of the list: Name (shapes and depth below), Mode, Tool, Vacuum (“On” when the operation turns the vacuum on) and Coolant (M7 mist, M8 flood, or a dash), Output. In Dusty Studio, vacuum and coolant are badges to the right of the name.
The Operations menu also offers Duplicate Operation, Delete Operation, Enable Only the Chosen Operation, Enable All Operations, Disable All Operations, the Tab Assistant… (see Tabs) and the Operations Library… (see Operations library).
Right-clicking an operation in the list (long press on iPad) gathers: enable or disable its output, enable only this operation (to preview or save a single operation), enable or disable all operations; assign, add or remove the selection, select its shapes; its tool, among the project tools that suit its type; move up, move down, duplicate, delete; the tab assistant. Each of these commands is undone with ⌘Z. Export This Operation… and Export the Operations Using the Same Tool… open the G-code saving for them only (see Saving the G-code). Save to Operations Library keeps it for other projects (see Operations library) and, for a pocket that ignores open shapes, Machine Open Shapes as a Profile hands them to a profile (see Open shapes: machining them as a profile).
Common settings
Parameters are grouped by theme. A grayed-out field has no effect with the current settings (for example the ramp angle when the entry is a plunge). Defaults are cautious starting points; feeds and speeds come from the tool.
| Group | Parameters |
|---|---|
| Depths | Start depth (0: the surface); Final depth, as a value or as a percentage of stock (100% = the whole thickness). |
| Feeds and speeds | Feed rate (cutting), Plunge rate, Ramp feed rate, Spindle speed: taken from the chosen tool. |
| Passes | Depth per pass (the last pass may be shorter); Stepover as a % of the diameter or as a length (pockets, surfacing); Cut direction. |
| Strategy | What is specific to the type: side, pattern, stock to leave… |
| Entry | Entry type and Ramp angle: see Entering the material. |
| Tabs | Profile only: see Tabs. |
| Accessories | Vacuum and Coolant (mist M7 or flood M8), written only if the machine declares these accessories (see Machine settings). |
Cut direction: climb (the default) usually gives a better surface; conventional is more forgiving of the backlash of light machines. Below the choice, a diagram shows it seen from above (clockwise spindle): the tool, its rotation, its feed and the side of the material that is kept.
Chip load: below the spindle speed, the editor computes the chip thickness with the operation's feeds: feed rate ÷ (spindle speed × number of flutes of the tool). Too thin, the bit rubs and heats up; too thick, it strains and may break: compare it with the one the manufacturer recommends (see also Feeds and speeds calculator). For a drill operation, it is the feed per revolution: plunge rate ÷ spindle speed.
Clearing pattern (pocket, rest pocket, dogbone slot, surfacing, reliefs): a thumbnail shows the path on a sample shape, concentric offsets or raster at the chosen angle with its outline pass. It follows the settings; check the real machining in the preview.
Depth: a final depth greater than the stock thickness cuts into the spoilboard; Dusty points it out. To cut through, go a few tenths of a millimeter deeper.
Profile
Follows the outline of the shapes, to cut out a part or engrave a line. Tools: end mill, ball mill, V-bit, round-over, scribe.
- Side: Outside (the part keeps its size, the tool runs outside), Inside (for an opening), Along line (the tool center follows the path, open shapes included).
- Nested closed shapes are read as a part and its holes: with Outside, the part's outline is machined outside and its holes inside. Two parts closer than the tool diameter are cut around together.
- Stock to leave (Outside and Inside): material left for a finishing pass.
- Passes: all passes of an outline are done before moving to the next; inner outlines before those around them (the part stays held), then the nearest. On an open shape, every other pass runs the other way.
- Tool path: Direct, or trochoidal to spare the spindle (see Trochoidal path).
- Entry: plunge, zigzag ramp, spiral, or helical with the trochoidal path (see Entering the material).
Dusty warns about a profile that cuts through the stock without tabs (the part will come free and may be thrown) and about tabs too short or too thin to hold.
Tabs
Tabs (holding bridges) leave small bridges of material on a through profile, so that the part does not move at the end of the cut. You cut them afterwards with a knife and sand. How many to use, and the other way to hold a cut-out part (thin last pass): see Through cuts.
Check Tabs in the "Tabs (holding bridges)" group of a profile:
- Tab type: Partial retract (the default: the tool rises to the tab height above the bottom, only for the deeper passes), Full retract (the tool rises to the start depth over the tab), Ramp (same height, with a sloped rise and descent over the first and last quarter of the tab).
- Tab size (5 mm by default): it is measured on the center of the tool. The bridge left is "size − tool diameter" (half of that for a ramp tab): with a 6 mm bit, use at least 8 to 10 mm. Dusty warns when almost nothing is left.
- Tab height (2 mm by default): thickness of the bridge, above the bottom.
Placement: without tabs placed on its shapes, Dusty spreads them automatically on closed outer outlines (not on holes, whose scraps may fall), about one every 150 mm of perimeter, between 4 and 16, without covering more than a quarter of the outline. Tabs placed on a shape (by hand or by the assistant) replace this placement; they are kept in the .dusty file and are machined only if the profile's Tabs box is checked.
- Tabs tool (B, tool column and Drawing menu): a click on an outline places a tab there, a click on a tab removes it; a dragged tab follows the outline of its shape to its new place (Escape puts it back). Each click or drag is undone with ⌘Z.
- Tab assistant (button in the bar of the Operations panel, Operations menu, right-click on an operation): select the shapes, then set the placement. The proposed tabs appear in green on the canvas at each change; nothing is placed before Place Tabs.
- Even spacing: a tab at the start of each path, then one every Spacing; At least sets a minimum number of tabs per path (they move closer if needed), Limit the number of tabs a maximum.
- Count per shape: the path is split into equal parts; on a closed shape, the first tab is shifted by half a part.
- Skip inner shapes: a shape entirely inside another closed shape gets no tab (its scraps may fall).
- Two tabs stay at least two tab lengths apart (that of the profiles machining these shapes, 5 mm without a profile): a small shape gets fewer.
- Place Tabs replaces the tabs of the shapes concerned, in a single undoable action; a shape that gets no tab keeps its own. If a profile of these shapes does not have its Tabs box checked, the assistant offers to check it in the same action. Cancel (or Escape) keeps nothing.
- The tabs placed remain adjustable with the Tabs tool.
Start point and direction
By default, Dusty starts each outline where the tool arrives (the shortest way) and follows it in the direction set by the operation's cut direction. To choose where a shape starts (for example on a straight side rather than in a corner, where the start leaves a small mark):
- Start Point tool (D, tool column and Drawing menu): click the outline of a shape; it is selected and its start goes under the click, snapped to the nearest node (the nodes of the shape are shown as small gray squares). A green square marks the start. On an open path, the start goes to the nearest end.
- Shift-click: reverses the direction of the shape; a green arrow shows it.
- ⌘-click (Ctrl-click): default start and direction.
- Edit › Reverse Direction (also in the Shapes menu of the toolbar): reverses the direction of the selected shapes; an open path then starts from its other end.
Effect on machining: the start applies to profiles and chamfers (the machined outline starts at the point nearest to the start, pushed to the end of a tab if it falls on one; an open path starts at the chosen end). The chosen direction applies to an along line profile; inside or outside, the operation's cut direction (climb or conventional) decides, to keep the intended cut quality. Each choice is undone with ⌘Z and kept in the .dusty file.
Clears the inside of closed shapes, down to the final depth. A shape inside another is an island: it is left standing. Tools: end mill or ball mill.
- Clearing pattern: Offset (the default: from the center toward the wall, the finished wall last) or Raster (parallel zigzag lines, Raster angle 0° along X, 90° along Y, and an Outline pass before, after or none).
- Stepover: distance between two passes, as a % of the diameter (40% by default) or as a length: the % or mm (in in inches) choice under the field also applies to tools and the library; the other value is shown ("i.e. 2.4 mm"). If it exceeds half the diameter, Dusty adds clean-up loops in the corners so that nothing is left.
- Stock to leave on the walls and the islands.
- Barcodes and QR: Module rows (the default) or Pocket the areas, for the codes assigned to the pocket (see Barcodes and QR codes).
- Entry: plunge, zigzag ramp or helical; without room for the helix, a zigzag ramp.
- Tool path: Direct, or trochoidal (see Trochoidal path).
- Each separate area is cleared completely, all passes included, before the next one. Short links happen within the material already cleared; the others go through the pocket lift or the retract height.
Open shapes are ignored: the operation reports it (“open shape(s) ignored”) and Edit › Select › Open Shapes of Pockets selects them, so that you can close them (see Cleaning up paths); Machine Open Shapes as a Profile machines them on the line instead (see Open shapes: machining them as a profile).
Rest pocket
Takes up, with a smaller tool, what a pocket cut with a large tool could not reach: tight corners, narrow passages. Create the pocket with the large bit, then a rest pocket on the same shapes with the small one, placed after it in the list.
- Clearing tool diameter: the diameter of the large bit (6 mm by default).
- The other settings are those of the pocket. The small tool only goes where material remains, overlapping the cleared area slightly.
- The two operations use two tools: a tool change is inserted between them.
V-carving
Carves grooves of varying width with a V-bit (or a ball mill): the depth follows the medial axis of the shapes, so that the flanks of the bit touch both edges exactly. Ideal for lettering and fine patterns. Dusty uses the included angle and the tip radius of the tool: enter them carefully.
- Limit maximum depth (checked by default) and Maximum depth: where the shape is wider than that depth allows, the bottom is cleared flat at that depth, at the stepover; check Finish stepover to go over it a second time with a finer step (fewer ridges at the bottom). The depth never exceeds the cutting part of the bit.
- Depth per pass: the tip goes down at most this much at each pass.
- Start depth: shifts the whole carving down.
- Open shapes: Dusty carves a "valley" groove along the path, at the maximum depth (or the whole cutting part of the bit), back and forth.
Letters are carved one after another, the nearest first. A text of several hundred characters is computed in one or two seconds.
Chamfer
Cuts a bevel along the edge of a closed outline, with a V-bit; the depth is computed to obtain the requested width.
- Side: Outside (the shapes are the part: its outline and the rims of its holes are chamfered) or Inside (the shapes are openings).
- Chamfer width, measured on the part from the path.
- Tip offset and Measured from (Bit tip or Contact edge, the edge of the flat tip): offsetting the tip uses a higher part of the flank. For a pointed bit, both references are the same.
- A width of more than half the tool diameter, or one that its cone cannot reach, is refused.
- Passes and entries as for the profile.
Dogbone slot
The dogbone slot clears a rectangle and cuts a round relief of the tool diameter into its four corners, so that a square-cornered part (tenon, panel, half-lap joint) fits despite the bit's radius. The drawing is not changed: only the toolpaths are. Tool: end mill.
- Accepted shapes: rectangles (even rotated) whose long side exceeds the short side by at least 1 mm; the others are left out with a warning.
- Relief style: Inline (the relief extends the slot lengthwise), On the long sides, Minimal (on the diagonal, the least material removed).
- The other settings are those of the pocket.
Drill
Drills a hole at the center of each shape (two shapes with the same center give a single hole), going each time to the nearest hole. Tools: drill, end mill, V-bit. Dusty writes simple moves (no canned drilling cycles, which GRBL does not know).
- Drill type: Plunge (straight down, rapid up); Peck (successive descents of the depth per peck, a dwell at the bottom, a retract above the material or by a distance, at the retract rate); Spot (a starting point 0.5 mm below the surface, to guide a drill); Countersink (a conical seat for a screw head, see below).
- Depth measured from the tip (the default): unchecked, the depth is that of the full diameter and the tool goes further down by the height of its tip.
- Fields with no effect for the chosen type are grayed out: the final depth only serves plunge and peck drilling; spot drilling always starts from the surface.
- Only the plunge rate and the spindle speed are used.
Countersink: with a V-bit (or a drill), Dusty cuts a cone whose hole diameter is the one wanted at the start depth (the top of the part, by default). It derives the depth from the tool's included angle: (hole diameter ÷ 2 − tip flat radius) ÷ tan(angle ÷ 2) — 4 mm for an 8 mm hole with a 90° V-bit. Below the hole diameter, the editor shows this countersink depth; the Depth column of the list shows it too. Choose a tool with the angle of the screw head (90° for most wood and metric screws). A diameter larger than the tool's is brought back to it (warning). Drill the clearance hole before or after, with another drill operation.
For a hole larger than the tool, use boring.
Bore
Machines round holes larger than the tool by going down in a helix along the wall, then making a flat turn at the bottom. Tool: end mill.
- Accepted shapes: circles (an ellipse with equal width and height, a circular path, a regular polygon with at least 16 sides). A square or a flattened ellipse is left out with a warning.
- Depth per revolution: descent at each turn of the helix (0.5 mm by default).
- Stock to leave, Cut direction.
- A hole smaller than the tool is refused; a hole of the tool's diameter is drilled with a plunge; in a hole larger than two tool diameters, a central core remains (it falls if the hole goes through): a pocket would clear it.
Surfacing and face
Two operations to flatten, with an end mill (a wide surfacing bit goes faster):
- Surfacing (of the spoilboard): draw a rectangle of the area to surface. The tool center runs on the outline, so the tool overhangs by half its diameter; Dusty works from the outside inward. Raster pattern by default (or offset), angle, outline pass.
- Face (the top of the stock): raster only; Clearance beyond the shape as a % of the tool radius (0%: like a pocket, 100%: the tool center reaches the outline, 200%: the tool goes completely out), at the end of each line and on the edges.
A small depth per pass (a few tenths of a millimeter) and a stepover of 40 to 70% give a good surface. Dusty warns when the tool leaves the project work area: check the machine travel and the clamps.
Fluting
Decorative flutes with tapered ends (columns, legs, frames, trays, signs): the tool follows the path itself, like a profile on the line, but goes down gradually along the entry ramp, cuts at the wanted depth along the flat section, then comes back up gradually along the exit ramp. With a ball-nose bit or a V-bit, the width follows the depth: the flute narrows towards its ends. Open or closed paths. Tools: ball-nose bit, V-bit (recommended), end mill (constant width, sloped ends).
Depths:
- Start depth, Final depth (as a value or a % of the stock): the flute goes down by the final depth minus the start depth.
- Final width: the width at its widest, along the flat section. It is linked to the final depth by the tool profile: changing one recomputes the other (90° V-bit: width = 2 × depth; ball-nose bit: width = 2 √(depth × (diameter − depth)), then its diameter). With an end mill, the width is its diameter. Changing the tool, or its dimensions, recomputes the width; deeper than the profiled part of the tool (cone height, ball radius), the width no longer grows (warning).
- Depth per pass: Dusty works out the number of passes (shown under the field). Each pass follows the same profile, deeper and deeper: no pass removes more than one depth per pass.
Ramps ("Strategy" group):
- Entry style and Exit style: Linear (constant slope), Fall (goes in gently, then dives more and more), Arc (dives, then eases off down to the bottom), Ogee (S-shaped, flat at both ends), Smooth (eased ends, steady slope in the middle). The exit mirrors the entry of the same style.
- Entry length and Exit length, as a length (10 mm by default) or a percentage of the path. A zero length gives a vertical plunge or retract.
- Flat section (shown, not editable): the path length minus both ramps, in mm and %, on the longest path of the operation. When ramps are longer than a path, they are shortened there in the same proportion, with no flat section (warning).
- Flute preview: under the ramps, the longest path straightened, seen from the top (the width all along) and from the side (the depth, and the bottom of each pass dotted), with the ramp limits marked. Vertical scales are enlarged for readability; with no shape assigned, a 100 mm sample path.
What Dusty does:
- Start: a closed path starts at the point set with the Start point tool, otherwise at its first node; direction chosen with Reverse direction, otherwise the drawing's. An open path starts at its nearest end (to the start point set, otherwise to the tool). The ramps of a closed path meet at the start point: the flute is shallowest there.
- Passes in a row: on an open path, every other pass runs backward; on a closed path, the passes follow each other in the same direction. The tool is at the start depth at the end of each pass: no move in the air.
- Feeds: descents at the ramp rate, flat section and climbs at the cutting feed.
- The nearest path first; circles and arcs written as
G2/G3.
Tip: for a column or a leg, draw evenly spaced parallel lines (Arrays tool), then a single Fluting operation for all of them.
Texturing
A textured background (hammered, gouged or bark-like look) for a panel, a sign or the floor of a pocket: the inside of closed shapes is covered with short ramped strokes laid along parallel lines; each stroke goes in, cuts a bottom, then comes back out. Lengths and depths are drawn at random within the chosen ranges, for a hand-worked look. Closed shapes only; a shape inside another is spared (same rule as the pocket): to texture the background around a motif, assign both the frame and the motif. Tools: ball-nose bit or V-bit (the cut width follows the depth), end mill.
Depths:
- Start depth: the top of the material where the texture goes (0: the surface; the depth of a pocket cut beforehand, to texture its floor).
- Minimum depth and Maximum depth: the bottom of each stroke is drawn between the two, below the start depth; the maximum as a value or a percentage of the stock. Example: start at 3 mm, strokes of 1 to 3 mm → cuts 4 to 6 mm below the surface. A minimum above the maximum is brought down to it (warning).
- Under these fields, Dusty shows the stroke bottoms below the surface, the cut width at the bottom of the shallowest and deepest strokes (from the tool profile) and a side view: two 100 mm sample lines computed exactly like the machining, the material removed and the depth range dotted (enlarged vertical scale), with the number of strokes cut and of pieces skipped.
Lines ("Passes" group):
- Stepover: the spacing between two lines of strokes, as a % of the tool diameter.
- Stepover variance: shifts each line and tilts each of its ends by at most this percentage of a quarter of the stepover: uneven spacing, slightly slanted lines, but never two lines crossing (at 100 %, two lines may touch). Dusty shows the line spacing, at its tightest and widest, and, below, the strokes seen from the top on a sample shape (the outline of each cut, with the operation's tool).
Strokes ("Strategy" group):
- Raster angle: direction of the lines (0°: along X, 90°: along Y).
- Stock to leave: shrinks the textured area by that much.
- Minimum length and Maximum length: the length of each stroke is drawn between the two.
- Discard below: the edges of the area cut strokes into pieces; a piece shorter than this threshold is not cut: the tool goes up to the fast retraction height and resumes at the next stroke of the same line. 0: lines cut from end to end.
- Line overlap: each stroke starts earlier, above the exit ramp of the previous one (this percentage of that ramp); the tool follows the deeper of the two, so the ridge between two strokes no longer rises all the way up (0 %: it touches the start depth; 100 %: about halfway).
- Offset alternate lines: every other line starts half an average length earlier, the strokes are staggered (clearly visible with two equal lengths).
- Ramp style: Linear, Fall, Arc, Ogee, Smooth, the profiles of fluting, for the entry and, mirrored, the exit of each stroke.
- Ramp share of each line: the share of each stroke's length taken by its two ramps (100 %: V-shaped stroke, no flat bottom; 0 %: vertical plunge and retract).
- Random seed: every draw (lengths, depths, line placement) depends on it. Same seed, same settings: same texture in the preview, the G-code and on the machine, also after saving and reopening the project. Change it for another texture.
What Dusty does:
- Area: the shapes shrunk by half the width of the deepest cut (plus the stock to leave): the cut never goes past the shapes nor touches a spared motif.
- Order: each part of the area entirely, the nearest first; lines in a zigzag; strokes that follow each other are cut in one go, without lifting.
- Feeds: descents at the ramp rate, bottoms and climbs at the cutting feed, vertical moves at the plunge rate.
- Strokes deeper than the profiled part of the tool (cone height, ball radius) are reported: beyond it, the width no longer grows.
Tip: with a 6 mm ball-nose bit, strokes of 6 to 14 mm cut 0.5 to 2 mm deep, a 40 to 50 % stepover and an arc ramp over half the stroke give an even hammered background; check the result in the preview (simulated workpiece) before machining.
Differences from MillMage: the seed is a setting of the operation (the reference software says nothing about it); the overlap is measured as a share of the exit ramp and the stepover variance never crosses two lines (formulas of Dusty's own, the reference software only giving the names of the settings).
Entering the material
How the tool starts each pass:
- Plunge: straight down at the plunge rate. Simple, but hard on the tool in hard materials; only for center-cutting bits.
- Zigzag ramp: the tool goes down while moving back and forth along the path, at the ramp angle (3° by default) and the ramp feed rate. Recommended for pockets and profiles in hardwood and aluminum.
- Spiral (profile): continuous descent along the outline, one depth per pass per turn, then a flat turn at the bottom.
- Helical: in a direct pocket, a small helix where there is the most room (without room, a zigzag ramp); with the trochoidal path, a helix on the circle of the first loop (
CAM-41). A direct profile has no helix: Dusty makes a zigzag ramp.
V-carving always enters with a plunge (a V-bit is not suited to ramps).
Trochoidal path
For a weak spindle (3018) or a hard material (aluminum, hardwood): instead of moving straight ahead with its whole diameter engaged, the tool describes small loops that advance along the path. It bites a thin slice at the front of each loop, then comes back into the area already cleared: less load, better cooling, better chip evacuation, and a larger depth per pass becomes possible (the whole cutting length of the bit is used). Machining takes longer.
In the “Strategy” group of a profile, pocket, rest pocket or dogbone slot:
- Tool path: Direct, Trochoidal (full circles) or Trochoidal (half circles): a half circle at the front, then a straight line to the next one; a little faster, a little more load (the first loop and those in the corners make one and a half turns).
- Trochoidal diameter (3 mm by default): diameter of the loops followed by the center of the tool. For a profile, the slot measures trochoidal diameter + tool diameter, on the waste side.
- Trochoidal step (0.5 mm by default): advance from one loop to the next. It limits the tool engagement: each loop only removes, beyond the previous one, a slice as thick as the step. Under this field, the editor shows the slot width (profile) and the maximum radial engagement, in mm and as a % of the diameter (a direct slot engages 100%). Start around 10 to 20% of the diameter.
What Dusty does:
- Profile: the loops run in the waste, one loop radius away from the outline; then, at each pass, a direct wall pass follows the outline and gives the exact size (the small scallops between two loops and the inside corners) while removing almost nothing. On the line, the loops follow the path itself (centered slot, no wall pass). A hole too small for the loops is machined with the direct path (warning).
- Pocket (and rest pocket, dogbone slot): the clearing pattern (offset or raster, at the stepover) is laid out in the area of the loop centers, then the loops follow it; at each pass, the wall (and the spurs of a dogbone slot) is finished with the direct path, except in raster without an outline pass. The trochoidal diameter is reduced to the tool diameter there (no material is left between two neighbouring loops). An area too narrow for the loops is cleared with the direct path.
- Tabs: the loops stay above each tab across the whole width of the slot, like the direct path; the material bridge is the same.
- Entries: plunge; zigzag ramp on the first loop; helical on the circle of the first loop, at the ramp angle, then the loop itself makes the flat turn (a ramp if a tab crosses that circle); spiral (profile): the loops go down one pass per turn, a flat turn at the bottom, then the wall in a spiral.
- Safeguards (warnings): step reduced to the tool radius (beyond that, the load is no longer reduced); half circles changed to full circles if the trochoidal diameter exceeds the tool diameter (the straight return would cross the material at the center of the loops).
- The loops are written as
G2/G3arcs (or as segments if the machine refuses them). The pattern thumbnail shows the loops on a sample shape, under Tool path for a profile, under Clearing pattern for a pocket.
Machining order
The order of the list in the Operations panel is the machining order. To change it: drag an operation, use the Move Up and Move Down arrows in the panel header, or right-click.
Tips:
- Machine what is inside the part first (engravings, pockets, holes), and the cut-out profile last: the part stays held by the stock as long as possible.
- Group the operations that use the same tool: each tool change stops the machine so that you fit the next tool (see Tool change).
- Turn off an operation's output to try it on its own, without deleting it.
Within an operation, Dusty chooses the order: the nearest first, inner outlines before outer ones, each pocket area cleared completely before the next.
Operations library
Proven settings (depths, passes, feeds, entry, tabs, accessories, tool) are kept in an operations library and applied again from one project to the next. Each machine has its own libraries: the active machine's library is offered, and it follows the machine.
- Save: right-click an operation of the project › Save to Operations Library, at the top level or in a folder. The operation is kept with a copy of its tool (dimensions and feeds), without its shapes or its color.
- Open the window: Operations › Operations Library…, or its button in the Operations panel.
- List: the folders and the saved operations, with an overview of their settings in columns: type, tool (diameter), final depth (or % of the stock), depth per pass, feed rate, plunge, spindle speed, stepover. Clicking a column title sorts the list, a second click reverses the order; Library Order goes back to the order arranged by hand. Sorted by a column, each folder shows its subfolders first.
- Organize: drag an item onto a folder to put it inside, onto an operation to place it just before it, onto the first row (the library itself) to bring it back to the top level. Right-click also offers New Folder, Rename…, Move to (without dragging, with the keyboard or a finger on iPad) and Delete (a folder with all its content, after a confirmation). Folders can be nested and collapsed (arrow left of the name).
- Edit: double-click an operation (or the Edit button): its editor opens on the right — name, type, saved tool, then the same parameters as in the operation editor, grouped and greyed out according to their conditions. The type does not change.
- Apply: select shapes on the canvas, choose a saved operation, then Apply to Selected Shapes (or right-click › Apply). A new operation is created at the end of the list with these settings; its tool is copied into the project (an identical tool already there is reused). It is a single action, undone with ⌘Z.
- Import Operations from a Project…: the operations of a Dusty project (
.dusty) or a MillMage project (.mage) go, with their tools, into a new folder named after the file.
Every change is saved at once. At the bottom, the Library menu chooses the machine's active library: Machine Library (file Operations/<machine>.dustyops in the app folder, created at the first save), a new library or an existing .dustyops file, and the ones recently opened for this machine; the file path is shown.
In Dusty Studio and the desktop app, each machine's library is kept by the browser (or the desktop app); Import… and Export… exchange it as .dustyops (the name of the last file is shown: a browser does not give its path), New Library… replaces it with an empty library. Drag and drop and right-click work as in the Mac app; a double-click on an operation applies it to the selected shapes.
Open shapes: machining them as a profile
A pocket — like the rest pocket, the chamfer, the dogbone slot, the bore, surfacing and facing — only machines closed shapes: it ignores open shapes and reports it. Before closing paths whose ends are far apart (a drawing received from elsewhere, for example), consider whether a profile would suit better: it follows an open line very well, on the line.
In the operation editor (Open Shapes section) or by right-clicking it: Machine Open Shapes as a Profile. The open shapes go into a new profile on the line, placed just after, with the same depths, passes, feeds, cut direction, accessories and the same tool (if it suits a profile); the operation keeps its closed shapes. If it only machined open shapes, the profile replaces it (same name, same color, same output). It is a single action, undone with ⌘Z; check the result in the preview. Shapes coming from a color applied automatically stay in the operation, which still ignores them: remove that color from it if needed. To close the paths instead, see Cleaning up paths.
Not available yet
In this version:
- 3D relief roughing and 3D relief finishing are listed in the New Operation menu, but their toolpaths are not computed yet: such an operation is ignored (problem reported). 3D relief is planned for a later version.
Cutting tools
Project tools
The Tools panel lists the bits of the project. The project keeps its own copy of each tool: it will machine the same way on another computer, even if your library changes.
- Add Tool: a new tool of a geometry, or From Library.
- Geometries: end mill, ball mill, V-bit, drill, round-over, scribe. Each operation type only accepts some geometries (a pocket refuses a V-bit, a chamfer requires a V-bit…).
- Editor: name (empty: a name built from the geometry and the diameter), geometry, units, number (tool changer), vendor, link to the spec sheet, notes; a silhouette of the tool updated live; the dimensions for its geometry (diameter, flute length, number of flutes, corner radius, included angle, tip radius or length); the feeds and speeds (feed rate, plunge, ramp, spindle speed, depth per pass, stepover) and the resulting chip load.
- Spec sheet: an
httporhttpslink (or an address such aswww.example.com/bit, completed withhttps://) shows Open the Spec Sheet, which opens it in the browser; any other text is not opened. The notes freely keep references, materials tried, sharpening… - Spindle advance (drills): below the feeds, how far the drill goes down during one spindle revolution, plunge rate ÷ spindle speed (300 mm/min at 12,000 rpm: 0.025 mm per revolution). Compare it with the feed per revolution recommended by the manufacturer.
- What feeds and speeds should I use?: a collapsed box, in a tool's editor and in an operation's editor, recalls what feeds depend on, the signs of badly set feeds (bit rubbing and heating, burnt wood, chatter, breakage) and gives links to public pages (Wikipedia, CNC Cookbook).
- A tool's feeds are copied into an operation when it chooses the tool; they then belong to the operation. After changing a tool's feeds, choose it again in the operation to take them over.
Tool library
Operations › Tool Library… (⇧⌘L), or the library button of the Tools and Operations panels.
- On the left: the categories and their tools, then the project tools; a search by name (ignoring case and accents).
- At the top: new category, new tool (of a geometry), duplicate or delete the selected item.
- A library tool: Add to Project; a project tool: Copy to Library.
- Changes apply to a copy: OK saves it, Cancel discards it (after a confirmation if you changed something).
At the bottom, the Library menu chooses the active library: the Dusty Library (file Outils.dustytools in the app folder), a new library or an existing .dustytools file, and the recently opened ones; the file path is shown. The Dusty Library starts from a starter library of 14 tools in 5 categories (end mills from 1 to 6 mm, V-bits, ball mills, a 25 mm surfacing bit, drills), with cautious feeds for plywood on a desktop CNC.
In Dusty Studio and the desktop app, the library is kept by the browser (or the desktop app) and is imported or exported as .dustytools; the name of the last file imported or exported is shown (a browser does not give its path). Edit… opens its editor: library name, categories (new, renamed, duplicated, deleted), tools (new of a geometry, name, vendor, number, spec sheet, notes, fields, feeds and speeds calculator, duplicate, delete). OK keeps the changes, Cancel puts the library back as it was when the editor opened.
Feeds and speeds calculator
In a tool's editor, the Feeds and Speeds Calculator suggests suitable feeds and speeds:
- Material: softwood, hardwood, plywood, MDF, acrylic, polyethylene (HDPE), aluminum, foam;
- Radial Engagement: the share of the diameter in the cut (100% when slotting, 10 to 40% in a pocket or for finishing);
- Machine and Spindle: machine class (desktop CNC, rigid hobby router, professional machine), spindle speed range, power, maximum feed rate — read from the active machine, otherwise those of a 3018-type CNC.
The result: a verdict in green, orange or red, explained; the spindle speed, the feed rate, the plunge and ramp rates, the depth per pass, the chip load and the power needed for slotting, with notes (spindle slowed down to keep thick chips, not enough power…). Apply to Tool copies these values. They are cautious starting points: the tool manufacturer's values come first. In Dusty Studio and the desktop app, the calculator is in the tool editor (Tools tab); the chosen material is remembered.
Preview
Operations › Toolpath Preview… (⌥⌘P), or the Preview button. Dusty computes the toolpaths, then simulates the job with the kinematics of the active machine (speeds, accelerations, slowing down in corners); without a machine, those of a 3018-type CNC. Closing the preview changes nothing in the project.
On the right:
- Estimate: estimated time, cutting distance and time, rapid moves, dwells;
- Tool at Cursor: tool position in the work coordinates, current operation and move;
- Display: content of the 3D view (toolpaths, machined part or both), remaining toolpath faded or hidden, tool shown or not, project shapes, projection of the 3D view;
- Machined Part (when it is shown): toolpaths on the part, colors, stock texture, level of detail, hidden pieces — see Machined part;
- Operations: a click puts the cursor at the start of one of them;
- 3D Check: collisions, rapid moves through material, plunges too fast, air cutting — see 3D check;
- Pre-send Check: see Pre-send check;
- Troubleshooting: see Preview troubleshooting.
The legend (at the top) recalls the colors: cuts from gold (surface) to purple (bottom), rapids dotted. The real durations of jobs, learned by the machining log, correct the estimate when you start a job.
Top view and 3D view
At the top of the preview, choose Top, 3D or Both side by side (one above the other on a narrow screen). Both views show the same moment.
The 3D view shows the cuts tinted by depth, the rapids dotted, plunges and ramps, the first plunge and the final position, the translucent stock, the origin and axes, and the tool with its shape. To see the material removed, show the machined part.
- Mouse and trackpad: drag to rotate; ⌥ + drag (or two fingers on the trackpad) to pan; wheel or pinch to zoom toward the pointer; double-click to frame the whole job (on the machined part, double-clicking a piece cut all the way through hides it).
- Buttons: Top, Front, Side, Iso views; zoom out, zoom in, reframe.
- Keyboard, after a click in the view: arrow keys to rotate (with ⌥: pan), + and − to zoom, 0 to reframe.
- iPad: one finger to rotate, two fingers to pan, pinch to zoom, double-tap to reframe (or hide a cut-out piece of the machined part).
- Orthographic projection (Display section): no perspective, handy to check entries, exits and heights.
The system's "Reduce motion" setting is respected.
Project shapes
The Project Shapes setting (Display section) shows the drawing's outlines as thin lines, to compare the toolpaths with the shapes: Under Toolpaths (default: the cuts pass in front), Over Toolpaths (the shapes stay visible even where the tool goes) or Hidden. It applies to the top view and to the 3D view, where the shapes lie on top of the stock. Only visible layers count; images are not shown.
Machined part
In the Display section, the 3D View setting offers Toolpaths (the paths as wireframe), Machined Part (the stock as machining leaves it) or Part and Toolpaths: the part on the left, the toolpaths on the right (one above the other on a narrow screen), seen from the same angle — rotating, panning or zooming one does the same to the other.
Dusty simulates the part: each tool move carves the stock with the real shape of the operation's tool — flat bottom of the end mill, rounded corner of an end mill with a corner radius (bull nose), round tip of the ball mill, cone of the V-bit, the scribe and the drill, and the concave profile of the round-over bit (its radius and tip length, like the tool's outline): the edge it follows comes out rounded. The project's stock and Z zero are respected; what is cut through shows the table, and tabs remain. The part follows the slider and playback: move the slider back and the material comes back; play the job and watch the tool carve.
Settings of the Machined Part section:
- Toolpaths on the part: none, the last 100, 1,000 or 10,000 segments already machined, or all. They are drawn in front of the surface they carved.
- Colors: Material (the stock color everywhere; the shape reads through lighting), Depth (the toolpath gradient, from gold to purple) or Operation (each operation's paint color: you see which one machined what). Untouched stock keeps its color.
- Texture: the look of the stock, drawn by Dusty (nothing is downloaded) — Stock color (the brand color, by default), about fifteen woods (oak, walnut, maple, pine, birch…, MDF, plywood with its plies on the sides), painted wood in thirteen colors (paint on top, wood where the tool went), metals (brushed aluminum, brass, copper), ten solid colors and a few miscellaneous patterns (concrete, cheese, leopard fur, fur, ice cream, foam). The pattern follows the material through its thickness: machined sides and floors show the heart of the wood. With the Depth or Operation colors, only untouched stock takes the texture. The choice is kept from one opening to the next.
- Detail: Low, Normal, High or Fine — one point of the part every 0.5, 0.25, 0.125 or 0.0625 mm at best. On a large stock, Dusty widens this step to keep memory and computing bounded (from 2 MB at low detail to 24 MB at fine detail, plus the snapshots that make going back instant). Lower the detail for a very large stock or a modest device, raise it for fine engravings.
Good to know:
- The part is computed when it is shown and whenever the detail changes; on a very large job, it catches up with the slider in a few frames.
- The simulation follows a 3-axis machine, the tool carving from above: no undercuts.
- Rapids carve too: a rapid through the material shows on the part (the pre-send check reports it).
- Hidden pieces: a cut all the way through splits the part into pieces (the frame around a cut-out part, the slug of a hole). Double-click (iPad: double-tap) a piece to hide it and see the rest better; a piece still held by tabs cannot be hidden (the double-click reframes then, as elsewhere). Show Hidden Pieces brings them back, as does opening the preview again or changing the detail. The mask applies from the moment of the cut: moving the slider back before it brings the piece back.
- VoiceOver describes the part: view, moment shown, depth reached, share of the surface machined, cut through, hidden pieces, detail.
In Dusty Studio and the desktop app, the preview is the same: Top, 3D or Both layout (at the top; Both at the first opening, then the last choice), Tool at Cursor, Display (choosing a 3D content from the top view alone shows the 3D area) and Machined Part (texture included) sections, preset views, zoom and reframing, 3D Check and Troubleshooting sections. Drag to rotate, Shift + drag (or right button) to pan, wheel to zoom, double-click to reframe (or hide a cut-out piece of the machined part); on the keyboard, arrows, + and −, 0.
3D check
Each time the preview opens, Dusty checks the job in 3D, in the background: it carves the simulated part move by move, like the machined part, and checks each move against the material left just before it. The 3D Check section shows the progress (Cancel stops it; what is already checked stays shown), then the summary and the findings:
- Tool holder collision (danger): the collet nut or the spindle nose, above the tool stick-out, goes into the material — a pocket deeper than the tool sticks out, for example;
- Tool shank collision (danger): the non-cutting part of the tool, above its cutting length, rubs the material — a small end mill on a 3.175 mm shank going deeper than its flutes;
- Rapid move through material (danger): a rapid move goes through material still in place;
- Plunge too fast (warning): a feed move down into the material whose vertical speed is more than 10 % above the tool's plunge rate (the library's) or, for an unknown tool (opened G-code file), half the operation's highest lateral feed; a gentle ramp passes;
- Air cutting (information): a run of moves at cutting feed that remove nothing, from an adjustable length (5 mm by default); the summary gives the share of the cutting time spent in the air, approach descents included.
Each finding gives the G-code line (of the file sent to the machine, or of the opened G-code file), the operation, the position of the tool tip and the time; a click puts the cursor at that time: the views show the tool where the problem is. On the top view, each finding is marked with a red (danger), orange (warning) or blue (information) diamond.
Check settings: Detail of the checked part (normal by default), Tool holder diameter (20 mm by default: an ER11 collet nut with some margin), Tool stick-out (20 mm by default, from the tip to the collet nose; at least each tool's cutting length plus 2 mm) and the length from which air cutting is reported. They are kept; Check Again runs the check again with them.
Good to know:
- The cutting length comes from the operation's tool; its shank is assumed to be its cutting diameter, and at least 3.175 mm. For an opened G-code file the tools are unknown: the tool holder, rapids, plunges and air cutting are checked, not the shank.
- The check follows a 3-axis machine at the chosen resolution, without refinement: a move that removes less than one grid step along a wall counts as a move that cuts (a finishing pass is never taken for air cutting), and contacts of less than 0.05 mm are ignored. A move is judged as a whole: if part of it cuts, it is not in the air.
- Clamps and the spoilboard are not modeled.
- The computation runs off the interface (in slices in Dusty Studio and the desktop app); closing the preview stops it.
Preview troubleshooting
The Troubleshooting section, at the bottom of the preview, gathers the usual questions; those about the project or the last check come first, marked Check this:
- 3D check alerts: collision → let the tool stick out further from the collet, use a tool with a longer cutting length or cut less deep; rapid move through material → raise the safe height; plunge too fast → lower the plunge rate or enter with a ramp; air cutting → lower the retract height, check the stock thickness and the Z zero.
- The estimated time is wrong: the estimate follows the active machine (speed and acceleration of each axis, slowing down in corners); choose the right machine, read its settings from the controller or correct its simulation speed factors; the machining log then refines the estimate.
- The machined part does not look like the preview: check the clamping (the stock did not move), the tool (tight, sticking out enough), the axes (lost steps), the feeds advised by the tool maker, and that the mounted tool is the operation's tool.
- Some shapes are not machined: a tool that is too large does not fit into the narrow parts of a pocket or between two close contours; use a smaller tool or add a rest pocket.
- Inside corners are rounded: a round bit leaves a radius of half its diameter in every inside corner; rest pocket with a smaller tool, or dogbones for joinery.
- See a cut-out part without its offcuts: double-click the piece to hide (see Machined part).
Playback and time slider
Below the views: the Play button (Space), the slider for the moment of the job, the elapsed time over the estimated time, and the playback speed (× 1, × 10, × 50, × 200). The part already machined is in color, the rest faded or hidden; the machined part follows. Drag the slider to see the tool at any moment; the Tool at Cursor section gives its exact position.
Pre-send check
Before every send, Dusty reads the program again. In the preview, the Pre-send Check section shows what it finds without a machine; the same check, completed with the machine (work zero and travel), appears when you start the job.
Blocking (sending is refused):
- the safe height is not above the stock;
- a rapid move goes through the material (Dusty takes into account the material already removed by earlier cuts of the same job);
- the toolpath leaves the machine travel;
- the work zero is not set (checked when sending);
- a tool is not defined, a feed rate is zero, the spindle is stopped during a cut, or there is nothing to machine.
Warnings (you decide): feed rate beyond the machine maximum (the controller will cap it), tool going below the stock (into the spoilboard), toolpath leaving the stock (clamps!), spindle to start by hand.
Then come the problems of the operations themselves (open shape, unsuitable tool…), preceded by the operation name.
G-code
Saving the G-code
File › Save G-code… (⇧⌘E), or the G-code button. The G-code is written for the active machine (its flavor, spindle, accessories, custom blocks and post-processor options); without a machine, for GRBL 1.1 (3018-type CNC). Right-clicking an enabled operation also offers Export This Operation… (that operation alone) and Export the Operations Using the Same Tool… (the enabled operations that use its tool).
- Name format: the name of each file, in free text and tokens in braces, for example
{project}_{seq}_{tool name}. A slash/creates a folder:{project} {date}/{seq}_{tool name}. Operations that get the same name go into the same file: with no operation or tool token, everything fits in a single file; with{op}, one file per operation; with{seq}, one file per sequence (consecutive operations using the same tool); with{tool}, one file per tool (you change the tool by hand between two files). Operations that do not follow each other, gathered in the same file, are machined one after the other there: the machining order changes, and Dusty says so. The extension is the flavor's (.ncfor GRBL). - Preset: a single file, one file per tool, per sequence or per operation, dated folder with one file per sequence. Save as Preset… keeps the format under a name; your presets can be renamed and deleted. The default format can also be chosen in Settings › Machining.
- Three tabs: Files (the tree of folders and files, with their number of lines), Operations (the file of each operation, and its tool), Syntax (the tokens and their meaning; double-clicking a token adds it at the end of the format).
- The post-processor warnings, including this one: several tools in the same file on a machine without an automatic tool changer, with a format that does not separate the tools. Each tool change is then written according to the flavor (a pause for GRBL: see G-code flavors).
- Output folder: chosen once (Choose…), then remembered, like the format and your presets. Export… writes the files there (and first asks for the folder if none is chosen); an existing file is replaced only after your confirmation.
| Tokens | Replaced by |
|---|---|
{project}, {project short} | The project name; the same without spaces, 12 characters at most. |
{op}, {op index}, {op name} | The rank of the operation, with or without leading zeros; its name. |
{seq}, {seq index} | The rank of the sequence, with or without leading zeros. |
{tool}, {tool index} | The rank of the tool in order of appearance, with or without leading zeros. |
{tool name}, {tool number}, {tool radius}, {tool category} | The tool name, its number (tool changer), its radius in millimeters, its type (end mill, V-bit…). |
{timestamp}, {date}, {time} | YYYY_MM_DD_HH_MM_SS, YYYY_MM_DD, HH_MM_SS. |
{day}, {day name}, {month}, {month name}, {year}, {year short} | The day, its name, the month (01 to 12), its name, the year on four or two digits. |
{hour}, {hour short}, {hour ap}, {minute}, {second} | The hour from 00 to 23, from 01 to 12, am or pm, the minutes, the seconds. |
An unknown token is ignored. Dusty's G-code is strict ASCII: accented letters in names are transliterated (a non-ASCII character could be taken by GRBL for an immediate command). Saving the G-code does not change the project, except the counter of the variable text when its auto-advance is checked.
All pages, one folder per page (project with several pages): the G-code of each page, with the same format, in a folder named after the page — “all pages at once” series machining. Pages with nothing to machine and those that still have variable text (the template of a series) are skipped, with a warning.
The Machine panel also offers Save G-code…: it saves exactly the program of the job that would be sent.
Opening and replaying G-code
File › Open G-code… (⇧⌘O) opens a G-code file (.nc, .gcode, .ngc, .tap…) as is, to send it to the machine: a program saved by Dusty or by another software. The open project is not touched (neither the drawing nor the undo history); to rework a file's paths as shapes, use Import… instead (see Importing).
The G-code Program window (a sheet on iPad; Machine › G-code Program to come back to it) shows:
- the text, line by line and colored: comments in gray, M codes in orange, G codes, feeds and speeds in blue, X in red, Y in green; a line Dusty cannot read is marked;
- the wireframe view, a top view to scale: cuts tinted by depth, rapids dashed; the line chosen in the text is highlighted;
- the summary: lines, estimated time with the active machine's kinematics, tools, feeds, spindle speed (the file's highest S value and the actual spindle speed on this machine), cut extent, cutting length;
- the pre-send check without a link (the work zero is checked when sending).
Send to machine… (or Send… in the Job section of the Machine panel) follows exactly the path of a job: pre-send check of the program and of the machine, your consent ("The spindle will turn"), job log, and resume if it is interrupted. The check is as strict as for a job prepared by Dusty:
- machine travel (from the work zero read on the controller), safe height, feeds;
- the tool diameters of a file are not known: Dusty assumes Z zero on top of the stock and refuses any rapid move below Z 0 (a file that lifts the tool with rapids inside a pocket is therefore refused);
- cutting with the spindle stopped is refused (unless the spindle is started by hand); an S speed above the machine's maximum S value is reported, with the actual speed the spindle will run at;
- a line Dusty cannot read (
G81drilling cycle,#parameters…) blocks sending: the path that follows could not be checked; - commands the controller would refuse are reported by the machine check.
While sending, the current line is marked in the text (and followed when Follow the current line is on) and highlighted in orange in the wireframe view; a red crosshair shows the tool position. STOP stays in the window's toolbar.
Resume at a line… (or a line's context menu, Resume at this line…) resumes the program at the chosen line. Dusty rebuilds the program's state at that point (units, distances, plane, coordinate system, spindle and its speed, coolant, feed), rises to the safe height, moves to the resume point, starts the spindle, then goes down at the chosen feed. At the start of the pass (recommended), the tool restarts from a point outside the material. The resume then goes through the pre-send check and the confirmation of a job; it is refused while the position is lost. An interrupted program can also be resumed like any job (see Resuming an interrupted job).
The program follows the active machine: changing it rereads the file (flavor) and redoes its check.
G-code flavors
The flavor is the controller's dialect, chosen in the machine settings. It sets the extension, the comments, the way to change tools, the dwell unit and the default blocks.
| Flavor | Tool change | Extension | Good to know |
|---|---|---|---|
| GRBL 1.1 | M0 pause, after retract and spindle stop | .nc | 3018-type desktop CNC. |
| GRBL M3 | M0 pause | .nc | Older variant without M4. |
| grblHAL | M6 T | .nc | Manual or automatic change, depending on the controller. |
| GRBL-STM | M0 pause | .nc | GRBL ported to STM32 boards. |
| FluidNC | M0 pause without a configured changer | .nc | GRBL-compatible ESP32 boards. |
| Smoothieware | Suspend (M600) | .gcode | No M4; ; comments. |
| Marlin (Snapmaker) | M0 pause with an on-screen message | .gcode | Millimeters only; never M30; arcs written as segments. |
| Duet / RepRapFirmware | Message box (M291) | .gcode | ; comments. |
| LinuxCNC | T M6 | .ngc | Four decimals. |
| Mach3 / Mach4 | T M6 | .tap | |
| UCCNC | T M6 | .nc | Like Mach3. |
| MASSO | T M6 | .nc | Dwells in milliseconds. |
| Centroid | T M6 | .nc | ; comments. |
| Generic (RS-274) | T M6 | .nc | The most common G-code, to adapt with the blocks. |
Dusty drives the GRBL family of controllers directly (GRBL 1.1, grblHAL, FluidNC and their variants). For the others, save the G-code and send it with the controller's software or SD card.
Arcs in the G-code
The curves of the toolpaths are written as arcs (G2 clockwise seen from above, G3 the other way): circles, but also the arcs of the outlines — rounded corners, fillets, shapes redone by Fit to arcs (see Optimize shapes) — and those of their offsets, in profiles as in pockets. Dusty finds an arc when a run of small segments follows a circle within the curve tolerance (at most two tolerances between the arc and the segments); the G-code is shorter and the motion smoother.
- An arc can go beyond half a turn: it is written with its center (
I,J, relative to the start point), and split into pieces of 120° at most for a machine set to radius (R). - A tiny arc (radius or length under 0.1 mm) or an almost straight one stays as segments, like segments whose height does not follow the arc (tabs).
- Marlin only reads arcs when built with that option: with the Marlin flavor, arcs are written as segments.
- Settings › Machining › Curves in G-code › Segments Only: no arc at all, circles included, for a machine that reads arcs poorly.
The preview, the simulation, the pre-send check (true extent of each arc), resuming at a line and opening a G-code file read arcs as the machine does.
Post-processor options
The machine settings, Post-processor section (in Dusty Studio: Machine panel, G-code Options…), adjust the flavor's G-code for this controller. Without a setting, the G-code is exactly the flavor's.
| Option | Effect |
|---|---|
| Tool changes | Nothing: no command (save one file per tool); M0 pause and message: the program stops so that you change the tool; M6: the controller changes the tool. |
| Automatic tool changer | With M6: T M6 alone, with neither pause nor message. On a flavor that stops at tool changes (GRBL), M6 is written only with a tool changer: otherwise the controller would ignore M6 and not wait. |
| Dwell units | G4 P in seconds, G4 P in milliseconds or G4 S in seconds (by default: the flavor's). |
| Comment characters | ( … ) or ; … for Dusty's comments (by default: the flavor's); blocks keep their own. |
| Block escape character | The character that protects the reserved characters of G-code blocks (\{, \x18…), the backslash by default: choose another one (^, &, @, #, %, !) if your blocks write backslashes, for example file paths. |
| Suppress comments | No comment in the program, including those of the blocks (the message of an M0 pause disappears, the pause stays). |
| Verbose output | The motion mode (G0, G1…) and the feed repeated on every line, for controllers that do not keep them from one line to the next. |
These options go into the machine profile: a profile without them keeps its flavor's G-code.
Custom G-code
Machine › Machines… › choose a machine › Settings… › Custom G-code section › G-code Blocks: the blocks Dusty writes at specific moments of the program, grouped into Program and operations, Tool, Spindle, Coolant and vacuum:
- Header (program start) and Program end;
- Operation start and Operation end;
- Tool change (it must stop the program:
M0,M6…) and Tool length probe; - Spindle on (clockwise, counterclockwise), Spindle off;
- Mist (M7), Flood (M8), Coolant off, Vacuum on, Vacuum off;
- Dwell (spindle spin-up, drilling pauses).
Each block says what it does, when it is written and whether it is written for this machine. A block left at its default follows the flavor; Back to Default Block clears your text; an empty custom block writes nothing. The text is typed in a fixed-width editor; the Insert menu adds a variable or a macro. Problems are shown at each keystroke, with their line, and the preview shows the expanded block with example values. As long as a block written for the machine has an error, OK is refused: the G-code could not be produced.
Variables: {name} is replaced by its value.
| Variable | Value |
|---|---|
tool_number, tool_name, tool_diameter, tool_angle | Number, name, diameter and included angle of the tool (no angle for an end mill). |
rpm | Spindle speed written (none with the spindle off). |
feed | Last feed rate written. |
operation, section, program | Operation name, its rank (from 1), program name. |
safe_z, tool_change_z | Safe height, height of the retract before a tool change. |
x, y, z | Current position (none when unknown, for example after a tool change). |
units | mm or in. |
message | Tool change prompt (tool change block only). |
dwell | Dwell duration (dwell block only). |
Lengths and feeds are written in the unit of the line (the program's, or the one a macro sets).
Optional values and conditional lines:
{?name}: the line disappears if the variable has no value. Without?, a variable without a value is an error: Dusty refuses to produce the G-code rather than write a wrong line.{*name}: the line is only written if the value has changed since it was last written.[S]{rpm}: the word (the letter and its value) is only written if the value has changed; a line made only of unchanged words disappears.- A line that can disappear must not carry the code that does the block's job (
M0/M6of the tool change,M3/M4,M5): Dusty refuses it.
Mode macros: |REL| (relative distances, G91), |ABS| (absolute, G90), |MM| (G21), |INCH| (G20) change the mode for the block; |RESTORE| is required after them and restores the program's modes. A block that leaves another mode active is followed by the codes that restore the program's, with a warning.
Reserved characters: { } [ ] | are used by templates; write \{, \}, \[, \], \| (and \\) to get them as is (or with the escape character chosen in the post-processor options). A control byte is written \x18 (from 00 to 7F); GRBL and Smoothieware controllers would read it as an immediate command: it is refused there, like ?, ! and ~.
Example of a tool change block for GRBL that raises the tool before the pause:
|MM|G0 Z{tool_change_z}|RESTORE|
T{tool_number}
M0 ({message})Workholding
Workholding fixes the stock to the table so that it does not move while machining. A bit pushes and pulls the material at every turn: badly held stock shifts (wrong dimensions), vibrates (poor finish), breaks the bit or gets thrown. This guide presents the usual methods on a desktop CNC, their limits and what to check before starting.
To fit or remove a clamp, a screw, a brad or a part: spindle stopped and still, machine idle (no job, framing or jog running; a switch-operated router turned off), safety glasses on, and never a hand under or near the bit. Move the tool away first (see Go to): a bit cuts even when it is not turning.
Choosing and checking
Good workholding:
- holds the stock in every direction, including against being pulled up (an up-cut bit lifts the material);
- stays clear of the toolpaths and below the safe height: the bit must never meet a clamp, a screw or a brad, cutting or in a rapid move (see Heights and rapid moves);
- keeps the part held until the end: a part that breaks free spins with the bit; plan tabs (see Through cuts);
- does not damage the part: a wooden pad under a clamp avoids marks;
- is easy to repeat for a series (see Jigs).
| Method | Suits | Limits |
|---|---|---|
| Screws into the spoilboard | Thick or large stock, through cuts, strong forces | Holes in the waste; screws to keep away from the toolpaths |
| Clamps | Rigid stock of even thickness, quick changes | Bulk above the stock; safe height to raise |
| Double-sided tape | Thin sheets, small parts, engraving | Little side force; the glue gives way with heat or dust |
| Masking tape and cyanoacrylate | Thin or small parts, whole surface free | Curing time; glue to handle with care |
| Jigs and stops | Series, identical parts, flipping | Jig to make, often on the CNC itself |
| Machinable brads | Wood, through cuts, saving space | Nailer and plastic brads; brads to keep out of finishing passes |
| Vacuum table | Flat panels, series | Equipment; leaks; small parts that let go at the end of the cut |
| Vise | Blocks, thick parts, soft metals | Limited area; jaws to avoid; vise to fix square |
| Tabs and thin last pass | Every through cut | Bridges to cut and sand afterwards |
Before starting:
- Shake the stock by hand, spindle stopped: it must neither slide nor tilt.
- If useful, draw the clamps, screws and jaws on a tool layer (T1, never machined): you see on the canvas that no toolpath runs over them.
- Set the safe height above the highest point of the clamps; if there are some between the shapes, turn off the fast retract (see Travel heights).
- Frame the job (the tool goes around, spindle stopped) and watch it pass well clear of the clamps, then do a dry run above the stock (see Running a job).
- Start with the feed reduced (50%), stay by the machine, a hand near STOP.
Screwing to the spoilboard
The stock is screwed into the spoilboard (MDF or plywood laid on the table, which you accept to cut into). Very strong and simple, it is the basic method for through cuts.
- Put the screws in the waste, at least one bit diameter plus 5 mm away from the toolpaths; draw their places on layer T1 before screwing.
- Use countersunk screws sunk below the surface, and pre-drill near the edges so as not to split the stock. Brass or plastic screws harm a bit that touches them less; a steel screw that gets hit breaks the bit and throws fragments.
- Do not overtighten: a screw driven too hard bows a thin sheet. Several screws spread out are better than one very tight.
- For a part cut out from the middle of the stock, add tabs, or a screw in an area of the part that will be cut away later.
Clamps
A clamp presses the stock onto the table from above (step clamp and stud, toggle clamp) or holds it from the side (side clamp, cam, small bar clamp).
- Keep the clamp roughly level: set the step block to the stock height.
- Put the stud closer to the stock than to the block: the force goes where it is needed.
- Tighten moderately: too tight, a clamp marks wood or bends a thin sheet; slip a scrap of wood under the pad.
- At least two opposite clamps; one more in the middle of long stock.
- A clamp sticks out above the stock: raise the safe height above it and check while framing that the tool passes well clear. Side clamps, lower than the top of the stock, keep the way free.
- Keep at least one bit radius plus 5 mm between a toolpath and a clamp.
Double-sided tape
Thin double-sided tape (woodworking, cloth or carpet tape) sticks the stock to the spoilboard. Quick, with nothing sticking out: ideal for thin sheets, small parts and engraving.
- Both surfaces must be clean, dry and dust-free: vacuum and wipe the spoilboard.
- Put tape under each part that will be cut out, not just under the stock.
- Press hard for a few seconds (mallet, press, weight): the hold comes from the pressure.
- Limit the force: shallower passes, a slightly reduced feed. The glue softens if the bit heats up.
- To remove, spindle stopped: slide a thin putty knife under the part, always pushing away from you and from your other hand, or use the solvent recommended by the tape maker.
Masking tape and cyanoacrylate glue
A very strong variant of taping: a strip of masking tape on the spoilboard, another under the stock, and a few dots of cyanoacrylate glue ("super glue") in between. The tape then peels off cleanly: neither the part nor the spoilboard keeps any glue.
- Masking tape smoothed well on the spoilboard and under the stock, strips edge to edge, without bubbles.
- A few dots or a bead of glue on one of the tapes; an activator sprayed on the other speeds up curing.
- Lay down, press for 10 to 30 seconds, then wait for the full cure given by the maker before starting.
- After machining, spindle stopped, peel the tape slowly or slide a thin putty knife under it.
Precautions: ventilate (the fumes irritate eyes and nose), wear glasses and keep your fingers out of the glue, which bonds skin in seconds (keep the debonder recommended by the maker at hand). Glue and unglue away from the bit; gloves used for gluing come off before touching the controls or starting the machine: a glove can be caught by a turning tool.
Jigs and indexing fixtures
For a series, or a part machined on both faces, a jig (a plate fixed to the table, with a pocket or stops) puts every part back in exactly the same place: you change the part, not the zero.
- Three contact points locate a part: two stops on a long side, one on a short side; push the part against them, always the same way.
- Machine the jig on the machine itself (a pocket shaped like the part with a few tenths of clearance, or holes for dowel pins): it is then aligned with the axes. Leave it fixed, or locate it with two dowel pins in the spoilboard.
- Set the work zero on the jig (a pocket corner, a pin) and keep it as a position (see Positions and macros); a project template keeps the jig drawing on a tool layer, with the operations.
- The pocket locates the part but does not hold it: add a clamp, a cam, tape or a screw.
- For a flip (two faces): two dowel pins on either side, in the spoilboard and in the stock, symmetric about a line parallel to a machine axis; the flipped part drops back onto the same pins.
Machinable brads
Plastic (or composite) brads, driven with a nailer through the stock into the spoilboard, hold it without sticking out of the surface. A bit that hits one cuts it without damage, unlike a steel nail.
- Drive them into the waste, and near the cut-out parts to hold them until the end; avoid finishing passes (a cut brad leaves a mark).
- The stock must be thick enough for the brad length, and the spoilboard soft enough to hold them (MDF, plywood).
- To separate the parts, spindle stopped, gently pry with a wood chisel, blade pointing away from you; brad remains sand off.
- Never steel nails or staples: hit by the bit, they break it and fly off in fragments.
Vacuum table
A vacuum table holds the stock down by suction: a pump draws the air from under the stock through a drilled or grooved plate, often covered by an MDF spoilboard that lets air through.
- The hold depends on the area under the part: a large sheet holds very well, a small part hardly at all at the end of its cut. Keep tabs or a thin last pass for small parts.
- Cover the free areas (waste, sheet, film): every leak costs holding force.
- Surface the spoilboard from time to time (see Surfacing and face): a dug spoilboard leaks.
- Switching on: plug the pump into its own switch and start it before the job. If it is wired to a controller output, have it started by the Header block of the custom G-code, followed by a dwell (
G4) of a few seconds, and stopped by the Program end block, once the spindle has stopped (see Custom G-code). Do not declare it as the dust collection: Dusty may switch dust collection off when a job is interrupted, and STOP resets the controller, which turns its outputs off: the part would be released while the bit spins down. - A pump failure during machining releases the part: stay by the machine. After a STOP or an alarm, wait for the spindle to stop completely before coming near.
Table-mounted vise
A milling vise fixed to the table holds blocks, thick parts and soft metals (aluminum, brass) by side clamping.
- Fix the vise with clamps or screws and align the fixed jaw with the X or Y axis (dial indicator, or a reference face surfaced by the machine).
- Rest the part on parallels: it stands above the jaws by the height to machine plus a margin. The bit must never go down to the jaws: draw their outline on layer T1.
- Tighten by hand, then tap the part with a mallet to seat it on the parallels; they must no longer move.
- Set the work zero on the fixed jaw: it does not move from one part to the next, so the vise becomes an indexing fixture for a series.
- Remove the vise handle before starting.
Through cuts: tabs and thin last pass
When a profile cuts through the stock, nothing holds the part on the last pass: it can move, be nicked by the bit, or even be thrown. Two ways to keep it in place until the end, on top of holding the stock:
- Tabs: small bridges of material remain on the contour; you cut them afterwards (wood chisel, saw), then sand (see Tabs: type, length, height, assistant). Count at least four tabs per part, more for a long part or a machine that vibrates.
- Thin last pass: a first profile stops a few tenths above the spoilboard (for example at 0.3 mm), a second one, on the same shape with the same tool, cuts through in a single light pass: the remaining skin holds the part almost until the end. Combine it with tabs for small parts.
- Take the last pass 0.2 to 0.3 mm into the spoilboard to cut through everywhere; Dusty warns that the tool cuts into the spoilboard: that is intended (see Common settings).
- Machine holes and inner details before the outer contour (see Machining order): the part is still attached to the stock when they are cut.
- If a part breaks free anyway: STOP, wait for the spindle to stop completely, then remove it.
The machine
Machines and catalog
Machine › Machines… (a window on Mac, a sheet on iPad): the list of your machines. A selected machine shows its summary (flavor, connection, travel, machine zero, spindle) and its machining log.
- New Machine… (+): the assistant (see Adding a machine).
- Use This Machine: the active machine receives the G-code and connects from the Machine panel.
- Settings…, Duplicate, Delete… (its settings are lost; your projects do not change).
- Export Profile…: a
.jsonfile to keep or share; Import a Profile… (toolbar) adds it to the list under a new internal name. The same file imports on Mac, iPad, in Dusty Studio and in the desktop app.
A "directly controllable" machine connects from Dusty; a machine with "no connection" is used to prepare G-code.
Adding a machine
You need at least one machine to prepare G-code. At first launch, Dusty offers Add My CNC…, Import a Package or Profile… (the starter package of another Dusty installation, settings and machines, or an exported profile) or Use a Dummy Machine (no connection, to draw and prepare without a machine; the virtual CNC is still available). The New Machine assistant goes step by step:
- Model: the preset 3018 CNC (GRBL 1.1) (300 × 180 × 45 mm, over USB), a dummy machine, a commercial machine chosen in the catalog (67 models from Carbide 3D, FoxAlien, Genmitsu, Inventables, MillRight, Ooznest, OpenBuilds, Sienci, Snapmaker…) or another machine to set up from its controller's G-code flavor. For a catalog machine, the sheet says what comes from the manufacturer's public pages and what to check. When in doubt about the controller, choose GRBL, then type
$Iin the console. - Connection: USB (serial port) with its speed, network (Telnet: address and port), HTTP network of a Duet board (address, password), FluidNC's WebSocket (address, port 81), or none.
- Information: name, controller units, X, Y, Z travel, machine zero corner.
- Communication: flavor, serial signals, streaming mode, spindle.
- Summary, then Create Machine (with "Use This Machine").
At each connection, Dusty reads the controller's settings and updates the profile (travel, speeds, spindle, machine zero corner).
In Dusty Studio and the desktop app, New Machine… (Machine tab) opens the same assistant: 3018 CNC, dummy machine, commercial machine (manufacturer, then model) or generic machine (travel, spindle and controller to set), then Connection, Information, Communication and Summary. For a USB or network machine, the The machine is plugged in: run the connection assistant box chains with the connection assistant, which finds its port and speed and saves them in the new machine.
Machine settings
Machines… › Settings… opens a copy of the profile: OK saves it (refused while a setting is inconsistent), Cancel discards it.
| Section | Settings |
|---|---|
| Machine | Name, controller units, X, Y, Z travel, machine zero corner (where the tool goes when homing), automatic detection of that corner. |
| Connection | None, USB (serial port, speed in baud; the USB port is detected at each connection), network (Telnet: IP address or name, port), HTTP network of a Duet board (address, password), FluidNC's WebSocket (address, port 81). See Other controllers. |
| Controller | G-code flavor, DTR signal, RTS/CTS flow control, native jog ($J), regular position queries, job streaming: buffered (recommended) or synchronous (one line at a time). |
| Startup | Offer Homing When Connecting (a question, never without your agreement); pre-start checklist, one item per line, to check before each job. |
| Spindle and files | Maximum S value (setting $30; 1000 on 3018 boards, where S = rpm ÷ 10), spindle speed at max S (Dusty converts the tools' rpm in this ratio), wait after spindle start, spindle started by hand (router), file extension. |
| Post-processor | Tool changes, automatic tool changer, dwell units, comments, block escape character, verbose output: see Post-processor options. |
| Kinematics | Maximum speeds and accelerations per axis, to estimate durations (read back from the controller). |
| Simulation | Junction deviation, minimum corner speed, simulated cutting and overall speeds (in %): they adjust the time estimate. |
| Accessories | Vacuum and coolant: present or not, on and off commands, stop when a job is interrupted. |
| Custom G-code | The blocks: see Custom G-code. |
| Probe | Z plate only or XYZ block: thicknesses, walls, search distances, speeds: see Probing. |
| Tool length sensor | See Tool length sensor. |
| Saved positions, Macros | See Positions and macros. |
| Notes | Free text. |
In Dusty Studio and the desktop app: Machine tab › Machine Settings…, with the same sections and the same behavior (a copy, OK refused while a setting or a written G-code block is in error); the probe, the tool length sensor, positions and macros have their own windows there (see Studio's Machine tab).
Connection
In the Machine panel, Connection section:
- Choose the machine (the active machine).
- Connection: Virtual CNC (built into Dusty) or Machine (the connection of its profile: USB or network). A machine without a connection can only be reached through the virtual CNC.
- Connect. Dusty opens the port (the most likely USB port is chosen automatically: CH340, FTDI, CP210x chips…), waits for the controller's welcome message, reads its settings, updates the profile (travel, speeds, spindle) and reports what remains to be checked. Unsure of the port or the speed: Connection Assistant… (see Connection assistant).
Once connected: the section shrinks to the machine, Disconnect, Reconnect (the port is detected again, also with Machine › Reconnect, ⌃⌘R) and Machine Settings…. If the machine asks for it in its settings, Dusty offers homing as soon as it is ready ("Home the machine?": nothing moves without your agreement).
Auto-Detection… (under the port choice) excludes from auto-detection a port that is not the machine (another USB device, a 3D printer): it is never picked automatically again, but stays in the list. The setting applies to all machines; Include … Again puts it back. Disconnecting waits for the end of the running job; STOP is always possible.
Settings to Check: if the settings read differ from the profile, the panel lists them with their fix. GRBL's laser mode ($32=1) is blocking for a milling machine (it would let the spindle slow down during moves): Write $32=0 fixes it after your agreement. For the maximum spindle speed or the travel, Align Profile with Machine takes the controller's values.
If the connection is lost (cable unplugged, machine switched off), Dusty says so, stops what can be stopped and offers to reconnect. A controller that no longer responds is reported ("check the cable and the power supply").
Connection assistant
The machine does not answer, or you do not know which port to choose? In the Machine panel, Connection section, Connection Assistant… (machine disconnected) runs the checks one after the other and tells what is missing. Nothing moves: the assistant only reads (?, $I, $$), one port at a time.
- Computer ports: USB ports are kept; Bluetooth ports and the computer's built-in ports are ignored, like the ones you excluded from auto-detection.
- USB adapter driver: on Windows, a CH340, CP210x or FTDI adapter plugged in without a driver is reported, with a link to the driver page of the manufacturer; on Linux, an adapter without a serial port (missing kernel module, or adapter taken by
brltty); macOS recognizes these adapters out of the box. - Each port, at each speed: the profile's, then 115,200, 250,000 and 9,600 baud. A port already open in other software, a denied access (
dialoutgroup on Linux), an unreadable answer (wrong speed) or no answer at all are explained; without an answer, a last try is made without DTR. A controller from another family than GRBL (Marlin, Smoothieware, Duet over USB) is recognized; Marlin and Smoothieware are driven through their bridge (see Other controllers). - Controller settings: the travel (
$130to$132) is read. - Connection stability: twenty status reports requested in two seconds; if some are missing, the assistant recalls the cable rules (USB data cable, shielded, shorter than 3 m, no hub, away from the motor cables). In Dusty Studio and the desktop app, Long stability test extends it to 30 seconds (300 reports): a cable or power supply that drops out after a few seconds shows up.
- Catalog machine: the models with the same travel and the same controller are suggested.
At the end, Save in the Active Machine (port, speed, DTR) or Add This Model (the suggested model, with the connection found, becomes the active machine). A machine whose profile has a network address is reached at that address, then queried the same way.
In Dusty Studio (browser), the browser shows neither the list of ports nor the drivers: Choose the Port and Start opens its port chooser, then the assistant tries that port at each speed. The desktop app tries every port, like the Mac app.
Other controllers: Duet, Smoothieware, Marlin, FluidNC over WebSocket
Since version 1.5, Dusty also drives controllers that do not speak GRBL: it keeps all of its work (confirmations, pre-flight check, pause, resume, STOP, log) and translates at the border, through a bridge of its own for each controller. Choose the controller (flavor) and the connection in the machine settings; the virtual CNC of such a machine already speaks its protocol, so everything can be tried without a board.
To be validated on a real board. These drivers were written from the controllers' public documentation and tried against virtual boards only: no real Duet, Smoothieware, Marlin or FluidNC board has been plugged in yet. Make your first tries in the air, spindle off, hand near the STOP.
Duet board (RepRapFirmware)
HTTP network (Duet) connection: the board's address (name or IP address, followed by :port if it is not 80) and its password if it has one (M551 in config.g). Dusty opens a session (rr_connect): a wrong password, or an address that is not a Duet board, is reported straight away.
- State and positions: read from the board's object model four times per second (state, axes, job, spindle).
- Jogging, zero, homing, probing: sent as commands (
rr_gcode); the board's answer (rr_reply) shows in the console, an error on an incident card. There is no continuous jog: steps only. - Job: Dusty checks the G-code, then sends it to the board (
0:/gcodes/<name>), which runs it itself (M32): machining goes on even if the computer goes to sleep. Progress and remaining time come from the board; if the board has simulated the file (M37), its simulated duration is noted in the console. - Pause:
M25(the board runs itspause.gmacro: retract, spindle); Resume:M24(resume.g); Stop Job: pause, then cancel (M0). - Board messages outside commands (an error while running the file,
M118…): in the console. A file abandoned by the board (limit switch hit, line refused) stops the job with its cause, like a GRBL error. - Message boxes (
M291, for instance at a tool change of a board macro): shown in the Machine panel; OK (or Cancel if the board offers it) answers withM292. A blocking box stops the board until it is answered. - STOP:
M112thenM999; the board restarts and Dusty opens the session again. Home the machine again. - Feed overrides go through
M220; rapid and spindle overrides do not exist. The board's settings stay inconfig.g(no$$).
In Dusty Studio (browser), the page reaches the board with fetch: the page must be opened from an http:// address (Dusty Link, local network; an https:// page cannot reach an unencrypted local board), and the board must accept the page: send it M586 C"*" once (or add this line to config.g). Without it, the browser refuses the answers ("page refused by the board"). The desktop app, the Mac and the iPad do not need this setting.
Smoothieware
USB connection (115,200 baud) or Network (the board's Telnet, port 23). Smoothieware in GRBL mode already understands most of Dusty's commands; the bridge translates the rest:
- answers and errors in plain text ("Unsupported command"), old-style status reports put back into the GRBL form;
- HALT stop (button, limit switch, STOP): the board refuses everything (
!!) until Unlock — Dusty sends$Xafter an alarm (limit switch, homing) andM999after a stop; stopping a job (feed hold, then reset) is unlocked straight away; - SD card: file list (
ls), file run by the board (play), progress read withprogress; - settings read with
M503(steps per mm, speeds, accelerations), written withM92,M203,M201thenM500; - feed override with
M220; no continuous jog (Smoothieware does not stop it when the key is released): steps only.
Marlin
USB connection (usually 250,000 baud) or Network (TCP) if the board offers it. Marlin has neither immediate feed hold nor software reset: its bridge works differently.
- Each line is sent numbered with its checksum (
N12 G1 X10*cs), one at a time; a line damaged on the way is sent again when the board asks (Resend:). During a long command, the board says "busy": the connection stays alive. - State: Marlin does not report one; Dusty works it out (running as long as a move is not finished, checked with
M400); positions withM114, or automatic reports (M154) if the board announces them. - Pause: always with retract, between two lines (the moves the board has already accepted finish first). Stop Job: quick stop
M410(position kept), then spindle and coolant off. - STOP:
M112. The board halts and waits for its reset button (or a power cycle); Dusty then finds it again by itself. Home the machine again. - Homing with
G28(Z first), active work zero withG92, spindleM3/M5(SPINDLE_FEATUREoption), probingG38.2if the board has it compiled in, settings read withM503. - Marlin does not read "modal" moves (an
X10 Y5line withoutG; theGCODE_MOTION_MODESoption is off by default): Dusty puts the current move back in front (G1 X10 Y5); a spindle speed alone (S8000) is only applied when the spindle is already running.
FluidNC over WebSocket
WebSocket network (FluidNC) connection: the board's address and the port of its web interface (usually 81). Control is the same as FluidNC over USB or Telnet (status reports, continuous jog, SD card, overrides); the messages meant for the board's web interface are left out. In Dusty Studio, the WebSocket only opens from an http:// page. Telnet (port 23) is still possible.
Virtual CNC
The virtual CNC is a GRBL machine simulated in Dusty: axes with accelerations, spindle, coolant, probe, limit switches, homing, offsets, door. Everything can be tried without a machine: jog, zero, probing, framing, job, pause, tool change, STOP, incident cards. Its simulation speed goes from real time to × 20, to watch a whole job without waiting. Jobs on the virtual CNC are counted separately in the log. For a Marlin, Smoothieware or Duet machine, the virtual CNC speaks that controller's protocol (virtual board): its bridge can be tried without a board too.
The Machine panel
Once the machine is connected, the Machine panel shows, from top to bottom:
- State: controller state (idle, running, paused, alarm…), connection, the large STOP button, the banner for a locked machine or homing to do, the last event;
- Incidents: the current incident cards;
- Settings to Check (see Connection);
- Job: see Running a job, and the open G-code program (see Opening and replaying G-code);
- Controller SD Card (if the controller has one);
- Position: work and machine positions, zeros, probing, go to XY zero;
- Go to: see Go to;
- Saved Positions, Jog (also with the keyboard), Tool Length Sensor (if the machine has one), Surface Leveling (see Surface leveling), Position Check (see Position check), Spindle, Macros, Overrides, Console.
The machine state and STOP also stay in the toolbar of every project window.
Control mode
At the top of the Machine panel (machine connected), Layout switches between Setup (the whole panel, described above) and Control, a production layout that gathers what you use while machining: state and STOP, incidents, job, position and zeros, jog, spindle and accessories, macros, overrides and a taller console. Settings to check, SD card, Go to, saved positions and the tool length sensor stay in Setup. The choice is kept; the G-code Program window stays available in both.
Require Control mode before sending: a send (job, G-code program, resume, framing, dry run) requested in Setup first switches the panel to Control; check the machine, then send again. The pre-send check and the confirmations stay the same. In Dusty Studio, the same choices are at the top of the Machine tab.
Jogging and homing
Jog section:
- Arrows for X and Y in a cross, Z on the right; the central button stops the current move (it is not an emergency stop).
- XY step and Z step (from 0.01 to 50 mm), XY speed and Z speed (from 100 to 3000 mm/min).
- Continuous jog: holding an arrow moves the tool until you release it (if the machine accepts native
$Jjogging). For safety, Dusty keeps renewing the order: if the interface stops responding, the motion stops by itself. - Home (
$H, if the machine has limit switches): the tool looks for its switches and sets the machine zero. X, Y and Z next to it (Studio: $HX, $HY, $HZ) home a single axis, if the controller accepts it: FluidNC, grblHAL when bit 1 of$22is set, GRBL 1.1 only if it was built with this option (otherwise it answerserror:3without moving, and Dusty explains it in the console). The machine is referenced only once all three axes are done, together or one by one. - Keyboard jog: click Keyboard Jog (in Dusty Studio, one of the arrows); while the jog arrows have the keyboard, the arrow keys move in X and Y, Page Up and Page Down in Z, and the numeric keypad too (4 and 6 for X, 8 and 2 for Y, 9 and 3 for Z); Shift multiplies the step by 10, ⌥ (Alt) divides it by 10, Esc (or 5) stops the move. In continuous jog, the held key moves the tool until it is released. These keys do nothing elsewhere: neither in a field nor on the canvas.
Without homing, machine coordinates are not reliable: Dusty says so, and the features that depend on them (saved positions, tool length sensor) require it. A locked machine (alarm) is released by homing or by Unlock, once the cause is dealt with.
Work zero
The work zero carries the project's origin and Z zero over to the machine (see Origin and Z zero). Position section:
- The Work (work zero coordinates, G54) and Machine positions, in project units.
- Work zero: XYZ, X, Y, Z: the current tool position becomes the origin on these axes.
- Probing…: see Probing.
- Go to XY Zero: brings the tool above the work zero without changing Z.
Manual method: bring the tool tip above the corner (or the center) chosen as origin, set X and Y zero; go down in small steps until a sheet of paper is pinched between the tool and the stock, then set Z zero (subtract the paper's thickness, about 0.1 mm, if precision matters). The pre-send check refuses a job as long as the work zero is not set.
Go to
Go to section of the Machine panel: bring the tool to precise coordinates.
- Coordinates: Work (the work zero) or Machine (machine coordinates).
- X, Y, Z: an axis left empty stays unchanged. Read Position fills the three axes (or one, from its menu) with the current tool position in the chosen coordinates.
- Go…: after your agreement (the target is recalled), if X or Y changes, the tool first rises to the top of the travel (just below the Z switch), moves in X and Y, then descends to the entered Z; without an entered Z, it stays at the top. A Z alone is done directly. Speeds: those of the jog.
Every move is checked against the machine travel before it starts: homing is therefore required, and a target outside the travel is refused with the reason (axis, value, limits). Nothing starts either if the machine is not idle. Stop the move (central jog button, or Esc) interrupts it.
- Machine → Selection: sends the tool above the reference point of the selection (the one of the inspector: center, corner…), Z at the top of the travel, after your agreement.
- Selection → Machine: places the reference point of the selection at the current tool position (work coordinates); undoable like any move.
- Tool Position on the Drawing: an orange crosshair shows the last known tool position on the canvas, kept after disconnecting.
Work coordinates match those of the drawing when the work zero is set at the project origin.
Probing
Probing sets the zero with a conductive plate or block wired to the controller: the tool goes down until it makes electrical contact. Position › Probing… (or Machine › Probing…) opens the assistant:
- Probe: Z plate (laid on the stock: Z zero on the top of the stock, plate thickness subtracted) or XYZ block (laid on the front left corner of the stock: X, Y and Z origin on that corner, then carried over to the project origin, even if it is another corner or the center). Axes to probe: Z is always probed before X and Y.
- Position: with the built-in jog, bring the bit about 10 mm above the plate (or the block, near its inner corner); for X and Y, enter the tool diameter.
- Values: thicknesses, search distances, fast and precise speeds, precise distance, back-off — taken from the machine and kept for it.
- Probing: Probe Z (axis by axis) or Probe All; a fast approach then a slow second touch give a precise contact. At the end, Origin set and the values found.
Before starting: clip on the bit, cable plugged in, spindle off; begin with a fast probing speed below 200 mm/min. If the project's Z zero is on the spoilboard, Dusty lowers the origin by the stock thickness.
A failure stops probing: alarm 4 (the probe was already touching at the start) or alarm 5 (no contact within the search distance). Unlock, move the tool clear, check the clip and the cable, then Try Again.
Center finder
Machine › Center Finder… (Dusty Studio's Machine tab: Center finder…) finds the center of a round part (or of a regular polygon, from its corners):
- With the built-in jog, bring the tool tip against the edge (with paper, without forcing), then Take point 1.
- Repeat for points 2 and 3, well spaced around the edge.
- Dusty shows the center (machine and work coordinates) and the diameter.
Go to Center brings the tool there along the safe path of Go to (Z at the top of the travel), after your agreement; then lower it with the jog and set the X and Y zero. Add a Guide Circle to the Project draws a circle of the diameter found, centered at the right place, on tool layer T1 (never machined). Start Over clears the points.
Messages: points too close (at least 5 mm between two points), points aligned (no circle goes through them: take a point again), center outside the work area (check the homing and the points).
Tool length sensor
A tool length sensor is a fixed probe on the table: after a tool change, the difference between the contacts of the old and the new tool corrects the Z zero. It is set up in the machine settings:
- X and Y position of the sensor, in machine coordinates (Use the Current Tool Position when the machine being edited is connected and homed);
- start at the top of travel (below the Z switch) or at a given start height; search descent;
- approach, fast and precise speeds, precise distance, back-off.
- Length compensation: shift the work zero (
G10 L2, all controllers, kept by a reset) or tool length offset (G43.1, cleared by a controller reset, then restored by Dusty as soon as the machine is idle); - Measure Each Tool During the Job: the Tool length probe block is written at the start of the program and after each tool change (GRBL, grblHAL and FluidNC controllers driven by Dusty).
Homing is required (positions in machine coordinates); the cycle starts at the top of the travel, below the Z switch. In the custom G-code, Write from the Sensor Settings fills in the Tool length probe block.
Use (Tool Length Sensor section of the Machine panel):
- Set the work Z zero with the first tool, then Measure the Reference…: the machine rises, goes above the sensor and probes (fast then precise); this contact becomes the reference.
- After a tool change done by hand: New Tool… measures the new tool and applies its length difference with the reference (shown, "+1.500 mm" for a longer tool): no need to set Z zero again.
- During a job whose profile asks for the measurement: the starting tool is measured at the beginning (reference, or correction if it has changed), then each new tool when resuming from a tool change; the rest of the job waits for the end of the measurement.
- Without the measurement in the job: at a tool change, the prompt's Measure New Tool… measures it before resuming.
A new Z zero (zero, probing) forgets the reference: the next measurement becomes one again. Each measurement started by hand asks for your agreement (the machine will move).
Surface leveling
A circuit board, a bed or a spoilboard is never perfectly flat: on a 0.1 mm engraving, a tenth of a millimeter of height difference is enough to engrave nothing on one side and cut too deep on the other. Leveling probes the surface on a grid, builds a height map, then adapts the G-code: every move follows the measured surface, and the depth is the same everywhere.
Preparing (Surface Leveling section of the Machine panel):
- Connect the probe to the tool: clip on the bit and probe plate on the surface, or, for a circuit board, clip on the bit and a wire on the copper. Check with Probing that the contact is seen.
- Set the X Y zero of the job and the Z zero on the surface, at the origin (X0 Y0): the map corrects relative to the surface height at the origin. After a tool change without a tool length sensor, redo the Z zero at the same place.
- Set the grid: origin and size of the area (Stock Area takes the project's stock), points in X and Y (2 to 30 per axis, 400 at most; a 10 to 25 mm step is usually enough), clearance (travel height between points, above the whole surface), search below zero (the probe goes down at most that far), probing feed (60 mm/min recommended, 300 at most).
Probe the Grid… asks for your consent: the machine will move on its own from point to point. Spindle off (Dusty refuses to probe with the spindle running and sends M5 first), it rises to the clearance, moves to the next point, goes down to the contact (G38.3), rises again, and so on in a serpentine. The map is drawn as it goes.
- The probe touches nothing within the travel (probe unplugged, surface lower than expected): the tool rises to the clearance and probing stops cleanly, without an alarm; the message says which point.
- A contact less than 1 mm below the clearance also stops probing: raise the clearance.
- Stop Probing lets the current point finish, then raises the tool; STOP stops everything at once.
The map: top view in false colors (blue lower, red higher than the origin), height difference, average slope in X and Y (mm per 100 mm). Dusty warns if the Z zero was not on the surface at the origin or if the surface varies by more than 3 mm (probe, stock badly seated). Save Map… and Open Map… keep it in a file (.json); it also stays from one launch to the next until Forget Map.
Adapt Jobs to the Map: when checked, every project job and every G-code program sent follows the map. Dusty splits moves into segments of 2 mm at most, turns arcs into segments (within 5 µm) and corrects Z at each point by interpolating between the probed points; outside the probed area, the correction is extended from the edge (reported). The pre-flight check covers the adapted G-code, and its warnings give the range of corrections. Left as is, and reported: moves in relative mode (G91), in machine coordinates (G53), G28/G30 returns and probing moves; a program with inverse time feed (G93) or arcs outside the XY plane is refused. Framing, dry runs and job resumes are not adapted (a resume replays the already adapted G-code).
Position check
A machine that loses steps (acceleration too high, loose belt, too much load) keeps believing the tool is where it should be: the rest of the job is shifted. The position check detects it with the probe block or plate fixed to the table (it must not move between the two measurements).
- Before the job: bring the tool above the block, as for probing, then Measure Reference…: Dusty probes the block (Z, then X and Y with an XYZ block, from the machine's probe) without setting an origin and keeps its corner, in machine coordinates.
- After the job, without homing again: Check Position…: the machine rises to the top of its travel, returns above the block (machine coordinates: homing done at the start) and probes it again.
- Dusty compares: position correct (deviation under the threshold, 0.1 mm by default), or deviation beyond the threshold, axis by axis, with advice: home and redo the zero before the next job, reduce the accelerations (
$120to$122) and rates ($110to$112), check belts, pulleys, couplers and rails.
Each measurement asks for your consent (the machine moves on its own) and is refused with the spindle running, the machine not idle or the position not read back yet. The reference is kept until Dusty is closed.
Dimension calibration
Machine › Dimension Calibration… (Dusty Studio's Machine tab: Calibration…) checks that the machine cuts to the right dimensions and proposes corrections:
- Test piece: a raised square (40 mm by default) surrounded by a groove wide enough for the caliper jaws, with a square pocket in the middle (20 mm), 2 mm deep. Set the tool, feeds and spindle, then Open as Program: the piece is sent like any G-code program, with the pre-flight check and your consent (the spindle runs). Origin at the front left corner of the stock, Z zero on top of the stock; the stock size needed is shown.
- Measurements with a caliper: width of the boss and of the pocket in X and Y, both diagonals of the boss, depth of the pocket. Not all are required.
- Corrections: the scale of each axis comes from the sum boss + pocket (the real tool diameter cancels out); the effective tool diameter from their difference (to enter in the tool library); the squareness from the diagonals (angle and mm over 100 mm); the depth deviation. For a connected GRBL-family controller, Write Steps per mm… proposes the new
$100and$101(vendor settings), shown before → after, written after your consent. Then cut the test piece again to check.
Running a job
Job section of the Machine panel (machine connected, idle):
- Frame…: the tool runs around the bounding rectangle of the cuts, or their outline (which follows a round or slanted part more closely), at the safe height, spindle off. Check that it stays on the stock and away from the clamps. Frame continuously (Studio: Continuously) repeats the loop until Stop Framing, which stops the machine at once (it keeps its position); without a stop, it ends by itself after 10 minutes. These choices are kept. The Machine menu also has Frame the Rectangle (⌥⌘R) and Frame the Outline (⌥⇧⌘R; Ctrl+Alt+R and Ctrl+Alt+Shift+R in Studio on Windows and Linux): the Machine panel opens and the same framing is checked then confirmed, the chosen shape becoming the panel's.
- Dry Run…: the whole job is played raised above the stock, with spindle, coolant, vacuum and tool change pauses removed. Check the path, the retracts and that no alarm occurs.
- Start Job…: the pre-send check appears: file, number of lines, estimated time (and the time corrected by the log, "historically +18%"), findings about the program and the machine, G-code warnings, and a safety reminder. A blocking finding prevents the start.
- Checklist: if the machine has one (see Machine settings), each item must be checked before you can start.
- Start Machining… asks for your agreement: "The Spindle Will Turn". Nothing starts without it.
Framing and the dry run also ask for a confirmation (the machine will move).
During the job: file, state, lines done out of the total, elapsed time and estimated time remaining. For a first run, lower the feed rate to 50% from the start (see Spindle, accessories and overrides).
Save G-code… in the Job section saves the exact program of the job.
Pause, stop and STOP
| Command | Effect |
|---|---|
| Pause (click) | Immediate pause: the machine slows down and stops on its path, spindle running. |
| Pause with Retract (Pause button menu) | The tool rises in Z and the spindle stops: to inspect or clear chips. |
| Resume… | Resumes after a pause, a tool change or a program stop, after your agreement: "The Spindle Will Restart". |
| Stop Job | Controlled stop: the machine comes to rest, keeps its position, the spindle is turned off. The interrupted job can be resumed. |
| STOP (⌘., red button) | Immediate reset of the controller: motion interrupted, job abandoned, spindle and coolant off. |
With the keyboard (Machine menu): Pause Job or Resume Job… (⌃⌘P; resuming always asks for your agreement), Stop Job (⌥⌘.), Reconnect (⌃⌘R). In Dusty Studio's Machine tab, outside a field: P pauses or resumes, Shift+S stops the job; anywhere in Studio, Ctrl+Alt+Shift+C (⌥⇧⌘C on a Mac, can be changed in the shortcut editor) reconnects the machine, like the Reconnect button: the link is closed cleanly, then opened again with the same choices (refused during a job).
After a STOP during a move, GRBL goes into alarm (alarm 3) and the position may be lost: home the machine (or set the work zero again on a machine without limit switches) before going on. The accessory stop commands chosen in the profile are sent after the reset.
Tool change
When a job uses several tools, the program stops at each tool change (GRBL 1.1 cannot change tools by itself). Before inviting you to change the tool, Dusty makes the machine safe: it waits for the moves to end, raises Z to the top of travel (below the switch, once the machine is homed; without homing, by the lift of a pause with retract), stops the spindle and coolant, then checks on a status report that the machine is idle with the spindle stopped. Only then does the prompt appear in the Job section:
- the title ("Tool change: tool #2") and the program message (tool name);
- the steps: spindle stopped and Z raised; mount tool #…, tighten the collet, remove the wrench; take its length into account; resume;
- a warning as long as the new tool's length is neither measured nor compensated.
How the new tool's length is taken into account depends on the machine:
| Machine | What the prompt says |
|---|---|
| Without a tool length sensor | Set Z zero again with the new tool: jog and Z zero, or probing with the plate. Do not touch the X and Y zero. |
| With a sensor | Measure New Tool… (after your agreement: the machine goes above the sensor and probes, spindle stopped). The difference from the reference corrects the Z zero; the prompt shows "New tool measured: +1.500 mm". |
| Sensor measured during the job | Nothing to do: the new tool is measured as soon as you resume. |
| Controller tool table | Nothing to do: the job applies the tool's offset (G43 H). |
Resume… asks for your agreement: "Tool #2 mounted and tightened, wrench removed? The spindle will restart and the job resume", followed by the warning if something is left to do. The machine goes back above the stop point at the top-of-travel height; if the spindle was stopped out of the material (a tool change made at the safe height), the tool stays there and the program positions it itself; otherwise it comes back down, slowly into the material. Resuming follows the work frame as it is when you resume: zero set again or length applied during the stop.
A program stop (M0 in the program) is resumed the same way, without raising Z. A grblHAL or FluidNC controller that announces it can change tools receives the M6 and handles the change itself (see Tool table and automatic tool changer); otherwise, Dusty stops as for GRBL 1.1.
Tool table and automatic tool changer
A grblHAL controller built with a tool table keeps the length offset of each tool; with an automatic tool changer, it runs the M6 commands itself (Z up, spindle stopped, tool changed), without stopping the job.
- Machine settings, G-code tab (Studio: G-code Options): Tool changes as M6, then Automatic Tool Changer and Controller tool table (G43 H after each M6). The G-code then applies the tool's offset (
G43 H2afterT2 M6), the starting tool included. A tool table and measuring each tool during the job contradict each other: Dusty points it out. - Machine panel, Tool Table section (shown when the controller reports a table): the offset of each tool, in mm more than the reference tool. Type a value (written with
G10 L1, then read back), or, with a tool length sensor: first measure the reference (the tool used for the work Z zero), mount a tool (T3 M6in the console), then Measure… on its row writes its length difference to the table (after your agreement: the machine moves).
The virtual CNC simulates such a board when the machine is a grblHAL declared with a tool changer: eight pockets, a tool table, tools of different lengths. No test has been made on a real tool-changer board yet: run the first one dry, spindle stopped, Z above the stock.
Resuming an interrupted job
An interrupted job (stop, lost connection, alarm, Dusty closed) is kept on disk. The Job section shows Interrupted job: file, lines done, cause, and two buttons:
- Resume… opens the resume sheet:
- Resume Point: at the start of the pass (recommended: the tool starts again from a point outside the material) or at the exact line of the G-code (suggested line shown; Dusty goes back by the size of the controller's buffer, without ever going back over a tool change);
- Heights: safe height, top of stock, feed for going back down, spindle delay, suggested from the project when the job was started;
- the computed resume program: line, position of the resume point, remaining lines, points to check;
- Prepare Resume… then opens the pre-send check and the confirmation of an ordinary job.
- Forget abandons the job (after a confirmation: resuming will no longer be possible).
Resuming is refused if the position is lost: home the machine first (the work zero is kept by the controller). On a machine without homing, check "I have set the work zero again (XY and Z)" after doing so. Before resuming: right tool fitted, work zero unchanged, stock and clamps in place.
Spindle, accessories and overrides
- Spindle: Speed (in rpm, at most the spindle speed at S max of the profile; Dusty converts it into an S value as for jobs), then Start… (always confirmed: "The Spindle Will Turn"); Stop turns off the spindle and the accessories. On a machine whose spindle is started by hand (router), set the speed on the tool and start it yourself: Dusty reminds you before machining.
- Coolant: on or off.
- Vacuum: on or off, if the machine profile has a vacuum (accessories: on and off commands,
M7andM9by default, or those of your relay). Only when idle: disabled in alarm and during a running job (the job controls the vacuum itself). The state comes from the controller report when the command isM7orM8, otherwise from the last command sent. - Overrides, immediate effect during the job: Feed and Spindle (−10%, +10%, back to 100%), Rapids (25, 50 or 100%). The value shown is the one the controller reports.
Controller settings
Machine › Machine Settings… (machine connected; a window on Mac, a sheet on iPad): the settings read from the controller ($$), with their name, unit and editable value.
- Change the values, then Write Changes: only the changed settings are sent, after your agreement ("before → after"); everything is then read back and backed up. Discard Changes goes back to the values read.
- Manufacturer Settings (steps per millimeter, inversions, homing direction…): folded behind a warning. A mistake can drive the machine hard into its stops.
- Read Again, Save to a File…, Load a File… (the writes are prepared, then confirmed the same way).
- Automatic Backups…: one backup at each read that changes something (20 kept per machine), plus the original settings, never deleted. Restore… only writes what differs, after your agreement.
- Reset (
$RST=$settings,$RST=#offsets,$RST=*everything), under confirmation; resetting the settings requires the manufacturer section to be unfolded (in Dusty Studio: "I want to change the manufacturer settings" checked) and settings already read, hence backed up. Refused during a job or a motion; the console itself always refuses$RST.
A value suggested by the My Machining Is… assistant arrives here as a change to write.
No-go zones
A no-go zone marks what the tool must not touch: a clamp placed for this project, or the vise fixed on the table. It has a height: the tool may pass above it, never through it. Zones never produce G-code: they are only used for checking.
- Project zones (orange, stock coordinates), saved in the
.dustyfile: clamps. - Machine zones (red, machine coordinates), saved in the machine profile: the vise, a fixed jig. They apply to every project, and require homing.
Drawing: Machine panel › No-Go Zones…, or the button of the same name below the machine in Studio. Choose Project or Machine, Rectangle or Circle, then drag with the mouse or a finger on the plan. From Selection takes a closed shape from the drawing; Add by Numbers creates a zone to complete. Touching a zone selects it: its fields give the position, the size, the margin (1 mm by default) and the height; the plan shows it hatched, with the position of the tool. Use Current Tool Position locates a machine zone without measuring. Delete asks for confirmation.
The height works as follows, and this is the point to check before relying on it:
- The check looks at the tip of the tool, in work coordinates: those of the G-code, positive Z upward, 0 where the tool set its Z zero. The tool flies over a zone if its tip stays at least at height + margin.
- Project zone: the height is counted from the stock top. 20 means "the clamp rises 20 mm above the stock top"; it is negative if the clamp stays lower. Dusty works out the work Z from it, whatever the Z zero of the project: with Z0 on the top, work Z 20; with Z0 on the spoilboard and an 18 mm stock, work Z 38. This assumes the machine's Z zero really was set the way the project says.
- Machine zone: the height is a work Z, to confirm for the Z zero in force (Use Tool Height or Confirm for Current Zero). Dusty keeps that zero: if it changes (another stock, another tool), no flying over is allowed and crossing becomes uncheckable, until the next confirmation.
- Without a height, the zone blocks at every Z, even at the top of travel.
- After a tool change (
M6), the check assumes the Z zero was set again, as the prompt asks. It does not know the real length of the tool. AG53in Z does not say where the tip is: until a work Z follows, flying over is not allowed.
The check looks at the whole path, not at end points: G0, G1, arcs and helixes, taking G53, G54–G59, G92, G90/G91 and G20/G21 into account. The zone is enlarged by the tool radius and the margin. For an imported G-code, whose tool is unknown, Dusty assumes a 6 mm radius and says so: a wider tool needs a larger margin. It applies to the pre-send check, the start, framing and the dry run, manual moves (a continuous jog stops before the zone), Go To, saved positions, macros, the console, resume and jobs submitted to Dusty Link. Raising Z without moving in XY is always allowed, to clear the tool.
Three answers, never a fourth:
- Whole path checked: no active zone is crossed, nothing blocks. With no active zone, Dusty says nothing: that is not an "OK".
- No-go zone: the start or the move is refused. The message says which zone, of which family, at which line or operation, where, at what height, and how to fix it.
- Cannot be checked: Dusty cannot answer, and this blocks too. Causes: no homing (machine zones), unreadable position or offset, work zero not set since connecting, position lost, height not confirmed, tool length unknown after a change, line not understood (macros, variables,
O,M98, rotary axes, unknown codes), unknown path (G28,G30, cycles,M6left to the controller), file on the SD card.
Turning a zone off (Zone active box) is the only way past it: there is no override. A zone that is off is still shown as such, gray on the plan and in the Machine panel; each job started without it notes it in the machining log (zones_coupees column of the export). Starting stays an explicit action.
Limits: these checks rest on what you drew and on the zeros you set. They do not see the real table: always verify with framing and a dry run, and keep your hand near the stop. The 3D view does not show zones (they show on the work plane and in their window). Homing itself is not checked: the machine must be able to do it without hitting anything. An imported G-code is only checked when connected to a machine: only the driver knows the coordinates. A machine without homing ($22=0) cannot use machine zones: make them project zones. Shared machine: only the zones in the Dusty Link profile count. Headless, send it the profile from Dusty Studio (Dusty Link section); in Hub mode, draw them on the computer that shares the machine. Project zones go with the job.
Positions and macros
Saved Positions (Machine panel): bring the tool to a useful place (corner of a jig, tool change position…), then Save Current Position…: a name, then XY Only (the tool will stay at the top of travel when going there) or With Z. Go takes it there by a safe route: up to the top of travel, XY move, then down. Positions are in machine coordinates: homing is required. They are deleted by right-clicking or in the machine settings.
Macros: one button per macro in the Machine panel, to send a series of commands in one click. They are created and edited in the machine settings: a name, then one command per line (; or parentheses for a comment). Three macros are provided at the start: top of travel, back to work zero, settings and state. A macro that starts the spindle (M3, M4) asks for a confirmation before each run; a macro can neither reset the settings ($RST), nor write a manufacturer setting, nor change the startup lines; non-ASCII characters are refused.
Macro shortcut: in its settings, ⌥⌘1 to ⌥⌘9 on Mac and iPad, Alt + letter or digit or F2 to F10 in Studio and the desktop app. A key already in use is refused, with the name of the command or macro that holds it. The shortcut only works inside the app, never while typing in a text field, and goes through the same confirmations and checks as the button: spindle, travel, no-go zones.
SD card
With a grblHAL or FluidNC controller fitted with an SD card, the Controller SD Card section appears: List Files, then Run… on a file, under the confirmation of a job (the spindle will turn). The controller machines the file by itself: Dusty no longer sends anything and shows the progress; STOP keeps priority.
Console
The Console section shows the latest exchanges and accepts a command ($$, $I, G0 Z10…), sent with Return. Full Console… (Machine › Console) shows everything since the connection; Show all adds the status reports, acknowledgements and job lines.
A command that starts the spindle (M3, M4) or resumes a program (~) first asks for your agreement. To clear settings, use the reset of the controller settings.
Cheat sheet (button to the left of the field; Studio: Command cheat sheet under the field): a click puts the command in the field without sending it (Return sends it).
| Command | What it does |
|---|---|
$I | Controller information: version, options, buffer size. |
$$ | All settings ($0 to $132…). |
$# | Offsets: G54 to G59 coordinate systems, G28, G30, G92, tool length, last probe. |
$G | Parser state: active modes (G54, G90, G21, M5…). |
? | Immediate status report: state, positions, feed, spindle. |
$X | Unlocks after an alarm, without homing: the position is not guaranteed. |
$H | Homes all axes (limit switches required). |
$HX, $HY, $HZ | Homes a single axis, if the controller accepts it. |
$n=v | Writes a setting ($110=2000); prefer Controller settings, which checks the value. |
$C | Check mode: G-code is read without moving; send it again to leave. |
$N | Lines run each time the controller starts. |
$J= | Jog, for example $J=G91 X10 F1000 (10 mm along X). |
$SLP | Sleep: spindle and coolant off, reset to wake up. |
With grblHAL, $ES reads the setting descriptions; with FluidNC, $SD/List lists the SD card.
Incident cards
At each alarm (ALARM:n) or error (error:n) of the controller, an incident card appears in the Machine panel: a clear title, the cause according to what the machine was doing (job, probing, homing), steps to check off when there is a procedure, and one-click actions: unlock, home, reset, move the tool clear with the jog, probe again, switch to synchronous streaming (for an error 8 repeated during a job). No action starts the spindle or a job. A lost position is reported: home the machine before any job.
Understand and Fix… opens the My Machining Is… assistant on that incident. Close Card removes it.
Machining log
Dusty records each job: start, end or interruption (with the reason), machine, estimated and real duration, tools. In Machine › Machines…, a selected machine shows its log:
- finished and interrupted jobs, on the machine or on the virtual CNC (counted separately);
- the learned real duration: from two finished jobs onward, the real deviation from the estimate ("historically +18%"), used when you start a job;
- tool wear: accumulated cutting time and length, number of jobs;
- Export Log (CSV)….
Job log: check Job log (DustyJobs.csv) and choose a folder (Documents, for example): after each job, Dusty rewrites DustyJobs.csv there, one line per job (start, file, machine, connection, lines, duration, estimate, outcome, reason), for production tracking. In Dusty Studio, the folder is chosen each time it opens (Chrome, Edge and the desktop app); elsewhere, export the log.
Hour counter and maintenance
In Machine › Machines… (Studio: machine settings), the counter keeps, per machine, the machine hours (job in motion: no pause, tool change or manual move) and the spindle hours (spindle running, even outside a job). The virtual CNC never counts. A machine that has already been used gets a starting value, which does not trigger any reminder by itself. The counter is written atomically at most every 30 seconds, at the end of a job and on closing: a crash or a reconnection loses 30 seconds at most.
Reminders: lubrication (50 h), belts (200 h) and bearings (500 h, in spindle hours) are provided at the start. These values are to adjust for your machine: they are not manufacturer recommendations. You can change them, add some, remove some. Done… restarts the count of a reminder from zero, after a confirmation.
A reminder never interrupts a job and never blocks a start: it appears on connecting and at the end of a job, in the Machine panel.
Wear threshold per tool: a threshold in cutting hours, on the wear accumulated in the machining log, which is never changed. Replaced… restarts from zero for the new tool.
Limits: the counter is kept by the host: the app on this Mac, this browser, or Dusty Link for a shared machine. A machine used from several hosts therefore has several counters, with no total. In Studio it is kept by the browser: clearing the site data clears it. The Apple app does not show the counter of a remote Dusty Link.
My Machining Is…
The My Machining Is… assistant starts from what you observe to find the cause. It opens from Help › My Machining Is…, Machine › My Machining Is…, the More menu on iPad, or Understand and Fix… on an incident card. In Dusty Studio and the desktop app: Help › My Machining Is…, or Understand and Fix… on an incident card of the Machine tab; actions on the machine lead to the Machine tab (controller settings, probing, homing), with a message saying what to open.
- Symptom: the edges are burnt, the finish is rough, the bit broke, the part was torn out or moved, the dimensions are wrong, there are steps in the pockets, a pocket was not machined, everything shifted during machining, the contours do not close, the depth is wrong, the part is offset on the stock, the tool hit a clamp or the stock, the job stops partway, the machine stops in alarm, the connection is lost.
- Questions: two or three, one at a time, with a way back; Show the Diagnosis Now skips the remaining ones.
- Diagnosis: the likely and possible causes, each with its explanation, what Dusty saw, the checks to make and actions; unlikely causes are folded away.
Dusty relies on what it knows: the project's machine, the settings read from the controller, the last job in the log (or the incident received), the operation concerned and the material (chosen in the "What Dusty Knows" section), to put figures on its explanations ("0.008 mm chip for 0.05 mm recommended"). Without any of that, it reasons from your answers alone.
Actions lead to the right place: feeds and speeds calculator, recommended feeds applied to the operation (an undoable action), operation opened on the right parameter, tabs turned on, tool library, log, controller settings with the suggested value (written only after "Write Changes" and your agreement), machine settings or its G-code blocks, synchronous streaming, homing, Z zero probing, tool length sensor, preview, framing, project setup, surfacing the spoilboard, and a list of mechanical checks to tick off (machine unplugged: rails, backlash, loose parts, belts, table, speed). The assistant never acts on the machine by itself.
Connection symptoms and questions about alarm codes are only offered for a machine that Dusty drives; $ settings are only mentioned for the GRBL family.
Dusty Studio and desktop app
In the browser
Dusty Studio is Dusty in a web browser, with nothing to install: same core, same computations, same .dusty file. It also works offline once loaded, and can be installed as an app from Chrome or Edge.
- File: new project, open (a
.dustyproject, or a MillMage project), open a recent project (Chrome and Edge, which ask again for access to the file; the desktop app), open an example (see Example projects), save, save as (Chrome and Edge save over the opened file; elsewhere, the project is downloaded), import, open G-code (as is, to send it to the machine; a.ncfile dropped on the page too), export the drawing (SVG, DXF, DXF R12, PDF) or the selection alone, export the G-code, project setup, Settings…, close the project (back to the start screen). - Edit, Drawing and Arrange: the same commands as on Mac (see Editing and arranging), arranged in submenus (Select, Preset Shapes, Align, Distribute, Place on Stock, Dock, Move Together, Same Size, Rotate); the Drawing menu also chooses the drawing tool.
- Panels on the right: Drawing (inspector and colors), Operations, Tools, Machine.
- The tool library and the machine list are kept in the browser; the library is imported and exported as
.dustytools. - Help: Dusty Manual, Help on What You're Doing (F1: the topic of the open window, the tool or the tab), Keyboard Shortcuts (?), Dusty Tour, Example Projects…, What's New, Troubleshooting, Send Feedback…, Anonymous Usage Statistics, About Dusty Studio.
- Language: the FR / EN selector in the top bar, View › Language or the Settings; Settings… (File menu): see Settings. File › Project Assistant…: see Project assistant.
Studio's Machine tab
The Machine tab follows the Machine panel of the Mac app, with the same safeguards (the core is the same):
- Machines: a list kept in the browser; New Machine… opens the assistant (see Adding a machine); Duplicate, Export… (a
.jsonfile to share) and Import… (the machines of such a file, the first one becomes active). Machine Settings… opens the full profile (see Machine settings), including the custom G-code. G-code Options… sets the machine's post-processor (see Post-processor options). Probe and Tool Length Sensor… sets the probing plate or block and the fixed sensor (its position is taken on the active machine, connected and homed). The machine's machining log (finished and interrupted jobs, learned real duration, tool wear, Export the Log (CSV)…) is below the list, the virtual CNC counted apart: see Machining log. - Connection: the virtual CNC (in the page), or the USB port through WebSerial: Chrome or Edge on a computer, with the page served over HTTPS; elsewhere, Dusty Studio explains why the port is not available. The browser asks which port to open. Studio drives GRBL, grblHAL and FluidNC controllers. In the desktop app, a machine whose profile has an address can also be reached over the network (Telnet: GRBL over Wi-Fi or Ethernet, grblHAL, FluidNC); a browser cannot open that connection, and a Duet board (HTTP) is not driven yet. Connection Assistant…: see Connection assistant.
- STOP always visible (top bar and panel), also with Ctrl+. (⌘. on Mac);
- state, positions, incident cards (Understand and Fix… opens the My Machining Is… assistant), homing (all axes or a single one), unlock, zeros, step or continuous jogging, spindle (confirmed start), coolant, vacuum, overrides, console and its cheat sheet, trace of the virtual CNC; jog feeds, plate thickness and spindle speed accept calculations and units like the other fields; Setup or Control at the top of the tab: see Control mode;
- Job: Send the Project… (pre-send check, with the duration corrected by the log, then confirmed start), progress, immediate pause or with retract, confirmed resume, stop; Frame… and Dry Run…: the machine moves, spindle stopped (see Running a job);
- G-code program open: Show the Program… (colored text, wireframe view, summary; double-click a line to resume at that line) and Send the Program…: see Opening and replaying G-code;
- Interrupted job: kept from one connection to the next; Resume… (at the start of the pass or at the line, project heights from when the job started; refused while the position is lost) or Forget: see Resuming an interrupted job;
- Controller Settings…: settings read (
$$), changes shown "before → after" then written after your approval, manufacturer settings folded away, file, automatic backups and restore, Reset ($RST) under confirmation; differences with the profile appear in Settings to Check (fix written after your approval, or Align the Profile with the Machine): see Controller settings; - Surface Leveling (grid, height map kept in the browser, adapted jobs and programs) and Position Check: see Surface leveling and Position check; Calibration…: see Dimension calibration;
- Probing…: the probing assistant, Z plate or XYZ block (see Probing); Probe Z stays in the probing section for the plate;
- Saved Positions (Save the Current Position…, Go) and Macros (Edit…): see Positions and macros;
- Controller SD Card with a grblHAL or FluidNC controller: see SD card.
- Go to, Center finder…, Tool length sensor, keyboard jog: as on Mac (see Go to, Center finder, Tool length sensor); Export Profile… and Import a Profile… under the machine list; Startup: homing offered when connecting and pre-start checklist; in the desktop app, ports excluded from auto-detection under the port choice.
- Help menu: Debug log (kept in the page, Save Debug Log… to attach it to feedback;
?debugin the address opens it from page load, see Debug log), Generate Support Data… (see Support data) and Reset Dusty Studio Settings… (machines, log, backups and preferences kept by the browser erased, after confirmation; saved projects do not change). - If you leave the page during a job over the USB port, the browser asks for confirmation, then Dusty sends STOP. Keep the tab in front during a job: browsers slow down hidden pages.
What the browser keeps. In Dusty Studio, the machine list, the machining log (its last 4,000 lines), the automatic settings backups and the checkpoint of an interrupted job are kept in the browser storage: a few megabytes per site, specific to this browser and this computer, deleted with the site data (private browsing included, when it closes). A job too large for this storage has no checkpoint: Dusty says so, and if it is interrupted, it can only be resumed while the page stays open. The desktop app keeps all this in its data folder, like the Mac app.
Windows and Linux
The desktop app is Dusty Studio in a window of the app, with in addition:
- files through the system dialogs, an opened project saved in place (safe writing: the file is replaced in one go);
- opening a
.dustyfile by double-click, in the window already open; - the system serial port for the machine (no need for WebSerial), and the network connection (Telnet) with a machine whose profile has an address;
- the connection assistant on every port, which reports a missing driver (CH340, CP210x on Windows): see Connection assistant;
- File › Open Recent Project (the last ten projects opened or saved);
- Help › Check for Updates…, and a check at launch: see Feedback, updates and statistics;
- the Mac app shortcuts, Ctrl instead of ⌘: see Keyboard shortcuts;
- the machining log, the automatic settings backups and the checkpoint of an interrupted job in the app's data folder (
~/.local/share/com.websolutis.dustyapp.desktopon Linux,%APPDATA%\com.websolutis.dustyapp.desktopon Windows), the virtual CNC apart from the real machine; - closing the window during a job asks for confirmation, then stops the job cleanly (spindle off); the job becomes resumable;
- Hub mode, which lends the machine connected to this computer to the other devices on the local network, and the connection to a machine shared by Dusty Link: see Dusty Link and Hub mode.
On Linux, your user must be allowed to open the serial port (the dialout group on most distributions). The desktop app has been tested on Linux and on Windows 10. On Windows, it is distributed through the Microsoft Store, which signs and updates it; Windows then keeps its data in the package folder, under %LOCALAPPDATA%\Packages.
What differs from the Mac app
In this version, the browser does not have the direct network connection to the machine (the desktop app has it; it drives it through Dusty Link), and the computer's fonts are only read there in Chrome and Edge, with your permission (see Text). On the virtual CNC, the probe is a plate: side probing with an XYZ block stops there with alarm 4 (probe already in contact).
There, the tab assistant opens as a floating panel over the work area, which stays visible for the preview. The G-code is saved after the pre-send check: a blocking finding asks for an explicit confirmation. The G-code files are written into a folder chosen at each export (the dialog opens on the previous one) with Chrome, Edge and the desktop app; elsewhere, each file is downloaded (the folders of the format become " - " in its name). The two-point rotation is announced by a message and in the status bar, and most shortcuts of the drawing commands are missing (see Keyboard shortcuts).
Art libraries, recent templates and operation libraries are kept by the page (a copy of each file): see Art library, Project templates and User bundles.
Dusty Link and Hub mode
Dusty Link shares a CNC machine on the workshop's local network: it stays plugged over USB into a computer next to it, and the other devices drive it — Dusty Studio in a browser, the iPad or Mac app, another desktop app. Two forms, the same thing for the devices that join:
- Headless Dusty Link: a small service on a Raspberry Pi, another ARM board or an old PC (Linux or Windows), with no interface. It also serves Dusty Studio: a browser on the network opens its address and drives the machine, with nothing to install. See Installing Dusty Link.
- Desktop app Hub mode: the Windows or Linux computer connected to the CNC lends it to the other devices, while keeping it on its own screen. See Desktop app Hub mode.
Control goes through the same core as on the device connected to the machine: same pre-send checks, same incident cards, same tool change prompt, same safeguards. Nothing comes from the Internet: Dusty Link only accepts local network addresses.
Installing Dusty Link
On a Raspberry Pi or a Linux PC (with systemd and Internet), plug the CNC over USB, then in a terminal:
curl -fsSL https://dusty.websolutis.com/link/install.sh | sudo shThe script takes the package of the operating system (64-bit Raspberry Pi OS or other 64-bit ARM, 32-bit ARM for every Raspberry Pi running a 32-bit system, 64-bit PC), checks its SHA-256 sum, installs the dusty-hub service (system user dusty, dialout group) and shows the pairing code and the Dusty Studio address (http://<computer name>.local:46590/). The same line updates Dusty Link. Options go after sh -s --, for example … | sudo sh -s -- --port /dev/ttyUSB0 --nom Workshop.
| Option | Effect |
|---|---|
--port <port> | The CNC's port (otherwise: every USB port where a GRBL controller answers) |
--ignorer <port> | Port kept for another device, never opened (repeatable); preferably /dev/serial/by-path/… |
--reseau <host[:port]> | CNC over Wi-Fi or Ethernet (Telnet, port 23 by default) |
--machine <identifier> | Profile of a machine from Dusty's catalog |
--profil <machine.json> | Profile exported from Dusty's machine list |
--nom <name> | Name shown to devices ("Dusty Link" by default) |
--virtuelle | The virtual CNC, to try everything without a machine |
A 3D printer on the same computer (often with the same CH340 USB chip as a 3018-type CNC): Dusty Link only keeps a port where a GRBL controller answers. A printer that announces itself (Marlin, Klipper) is set aside without receiving anything; otherwise it only receives two read-only questions (? then $I), once per plug-in, and its port stays free for its own software. To never touch its port, keep it with --ignorer. Linux's phantom serial ports (/dev/ttyS… slots with no hardware) are not offered.
The pairing code stays the same from one start to the next, power cuts included; it only changes after too many wrong codes. To see it again: sudo dusty-hub --code. The service starts with the computer, reconnects to the machine after a cut (CNC switched off, cable unplugged) and announces itself on the network (Bonjour / mDNS): the apps find it without typing an address. The QR code of the mobile pendant, to scan with a phone: sudo dusty-hub --pendant.
On Windows, unzip the dusty-link folder, then in a command prompt: dusty-hub.exe --studio studio. The code shows in the window; keep it open and allow Dusty Link on the private network if Windows asks.
The full installation guide (packages, ARM boards, installing without Internet) comes in every package (LISEZ-MOI.md).
Joining a shared machine
- In a browser: open Dusty Link's address (
http://workshop.local:46590/): Dusty Studio opens, and the Machine tab offers Dusty Link; enter the code, then Connect to Dusty Link. A page over HTTPS (the online version of Dusty Studio) cannot reach a machine on the local network: open the one served by Dusty Link. - In the desktop app: Machine tab › Dusty Link; Search the Network finds the announced Dusty Links, or enter the address; then the code.
- On Mac and iPad: Machine panel › Shared Machine › Dusty Link…: choose a Dusty Link found (or enter its address), then the code. On iPad, this is how to drive a USB CNC.
Address and code are kept for next time. Disconnecting does not touch the machine: a started job goes on.
Mobile pendant
The mobile pendant drives the shared machine from a phone or a tablet, next to the machine, with nothing to install: a page served by Dusty Link and by the desktop app's Hub mode, in the phone's browser (Safari, Chrome), on the workshop network.
Opening it: scan the QR code with the phone's camera — the pendant opens already paired. The QR code is shown by sudo dusty-hub --pendant on Dusty Link, in the Hub mode section of the desktop app, in the shared machine section of Dusty Studio (Mobile Pendant (Phone)) and in the Dusty Link sheet on Mac and iPad. Or open http://workshop.local:46590/pendant (the Dusty Link address followed by /pendant) and enter the pairing code. The phone keeps the code; add the page to the home screen to find it again like an app.
The screen shows the machine state (idle, running, paused, alarm), the tool position (work coordinates large, machine coordinates small) and the STOP bar, always at the bottom of the screen, above everything. Two tabs:
- Jog:
- step (0.1, 1, 10 or 50 mm: one tap, one step) or Continuous: the machine moves as long as your finger stays on the key, and stops as soon as it lifts, the page is hidden or the connection is lost (Dusty Link stops it on its own half a second after the last news from the phone);
- three speeds;
- Zero X, Y, Z, XY, XYZ at the tool position;
- Probe Z with the plate thickness (the machine profile's by default), after a question: the machine moves down on its own until contact;
- Home (after a question) and Unlock after an alarm.
- Machining:
- the running job: file, progress, line, elapsed and remaining time, feed and spindle;
- Pause (with Z retract), Resume… and Stop Job… (questions asked on the phone);
- the tool change prompt (with the new tool measured on the tool length sensor);
- the speed overrides: feed and spindle in 10% steps, rapids at 25, 50 or 100%;
- the Dusty Link queue: a job sent from the computer or the iPad is started here with Start Here…, next to the machine. The phone takes the job over; the start question is asked on the phone, and the phone is the one that can resume the job after a pause or a tool change.
The pendant follows the chosen language (EN/FR button) and switches from the dark theme (the default, high-contrast for the workshop) to the light theme (in sunlight) with the ☀ button. A browser cannot keep the phone screen on for an http page: set the phone's auto-lock to a long delay while machining. The machine continues even if the screen turns off; STOP is one tap away as soon as it turns back on.
Job queue and confirmation
Start in the job window (Studio) or Send the Project to Dusty Link… (Mac, iPad) puts the job in Dusty Link's queue (G-code and what its pre-send check needs: tools, heights, stock top), then the start question is asked on your device. If the machine is free, the job starts; otherwise, it waits.
- Nothing starts on its own: every job, even the next one in a queue, is confirmed on the device that sent it, machine free (the stock must be changed, the tool checked). A waiting job expires after 12 hours.
- Only the device that sent a job starts or withdraws it; the desktop app in Hub mode can withdraw any queued job. The mobile pendant can take a job sent by another device to start it next to the machine, with its own question.
- The confirmation is tied to the device: the number of the question asked on your device only works for it. Another device cannot start the spindle, a job or a resume with your answer.
- During another device's job, yours can pause, stop, adjust the overrides and follow; not move the machine or resume.
Remote tool change, pause and stop
Dusty Link runs jobs like the device connected to the machine:
- Tool change: at the job's
T…/M6, the spindle stops and Z rises, then the prompt shows on every device (tool, steps, warning). The device that started the job can measure the new tool on the tool length sensor (if the profile has one) and resume, after the question asked on it. If that device has not shown up for a minute, another paired device can resume the suspended job. See Tool change. - Pause with retract: the machine finishes the moves already sent, raises Z, stops the spindle and the coolant; resuming goes back into position. Allowed from every device.
- Stopping the job: controlled stop (the machine comes to rest, position kept), spindle, coolant and accessories off; the job becomes resumable. STOP: immediate controller reset, always allowed, from any paired device.
The machining log, the controller settings backups and the checkpoint of an interrupted job are kept by Dusty Link itself (/var/lib/dusty folder).
Desktop app Hub mode
In the desktop app, Machine tab, check Share this machine on the network (Hub mode) (off by default). Sharing starts when the machine is connected (USB, network or virtual CNC) and stops with the app. The section shows:
- the pairing code (kept from one launch to the next; New Code changes it);
- the addresses to open in a browser on the other devices (Dusty Studio is served by the app);
- the mobile pendant: its address and its QR code, to scan with a phone (see Mobile pendant);
- the connected devices, the queue (with Remove) and the activity (requests, confirmations, pauses, stops, job ends).
You stay in control: your own commands do not go through the sharing, STOP and pause stay on your screen, and a job started here belongs to you (the other devices can only pause or stop it). The machine profile is set on this computer. Windows asks to allow the app on the private network the first time it shares.
Dusty Link security
- Local network only: private, link-local or loopback addresses; a request from the Internet is dropped without an answer. Never open port 46590 on your router.
- Pairing code on every request; eight wrong codes change it (to read again on Dusty Link).
- Confirmation on the device that sends for the spindle, every job and every resume; nothing starts on its own.
- STOP and pause always allowed; if a device is lost during a continuous jog, the jog stops. Only the device that started a continuous jog holds it: another device cannot extend it. During a job, the machine goes on without the device (the controller runs the program on its own).
- No-go zones: the machine and project zones apply here too. A job that crosses one is refused on submission, with its message, and the moves of the pendant go through the same check.
- Stay near the machine while it cuts, as over USB: see Safety.
Assistant (MCP)
A conversational assistant (Claude, for example) can prepare your projects through the MCP protocol: shapes, texts, barcodes, stock, cutting tools, operations and their parameters, pre-send check and estimate, G-code or drawing export, undo. It never controls the machine: no tool connects, moves, starts the spindle or sends a job — you start the machining in Dusty.
- On Mac: Settings › Assistant (MCP) › Local MCP server (off by default). The server only listens on this computer (
http://127.0.0.1:46580/mcp) and requires a token; it serves the project of the active window. Show Token shows the command to run to add Dusty to Claude Code. Every change by the assistant is an undoable action in the history, like yours. - Standalone program
dusty-mcp(Mac, Windows, Linux): it works on.dustyfiles (open, save, import SVG, DXF, PDF, LightBurn, MillMage…, export) and on your machines (--machines machines.json) for the G-code post-processor. Declare it in the assistant as an MCP server overstdio. - The server does not exist on iPad, on iPhone or in the browser.
Settings
Dusty › Settings… (⌘,) on Mac, More › Settings… on iPad. They apply to every window.
| Section | Setting | Default |
|---|---|---|
| Interface | Language, beginner mode, remembered transform toggles, Keyboard Shortcuts…, Reset to Default Layout: see Interface and language | System language, no, no |
| Project | Units of new projects (millimeters or inches) | Millimeters |
| Project | Set up each new project (stock, origin, Z zero) | Yes |
| Project | New project setup: step-by-step assistant or everything on one page | Step-by-step assistant |
| Machining | Curve Tolerance: fineness of the toolpaths along curves (smaller: more accurate, longer G-code) | 0.01 mm |
| Machining | Curves in G-code: arcs (G2, G3) fitted on curves and rounded corners, or segments only (no arc at all, circles included) for a machine that reads arcs poorly: see Arcs in the G-code | Arcs |
| Machining | G-code files: the name format offered when saving (a preset or your own) | A single file |
| Machining | Ignore shapes outside the stock: a shape that is not entirely on the stock is not machined (a shape straddling the edge is ignored entirely), with a warning on its operation; otherwise it is machined and the pre-send check reports the travel | No |
| Machining | Ignore “Start” when the screen wakes up: while the screen is asleep and for 3 seconds after it wakes, starting a job is ignored, so that a key pressed to wake the computer never starts the machine | Yes |
| Canvas | Work area: same as the interface, light or dark | Same as the interface |
| Canvas | Grid spacing (0: automatic, depending on the zoom) | 0 |
| Canvas | Curve quality: fine, or fast for very busy drawings | Fine |
| Canvas | Inverted scroll wheel zoom | No |
| Display | Grid contrast, handles and nodes, full-view crosshair, cross at the center of the work area, numbers on palette colors, icon size, text size, animations (in Studio, high density): see Display | Medium, normal size, no, no, yes, normal, same as the system, same as the system (yes) |
| Drawing | Snap to objects, snap to grid | Yes, no |
| Drawing | Return to the Selection tool after a shape | Yes |
| Drawing | Arrow key step, arrow key step with Shift | 1 mm, 10 mm |
| Drawing | Click selection tolerance and object snap distance, in screen points | 5 pt, 8 pt |
| Drawing | Copy and paste through the system clipboard: copied shapes paste into another window, after a restart or into a drawing program (as SVG); an SVG, text or image copied elsewhere pastes into Dusty | No |
| Text | Default font and height of new texts | Helvetica (Tuffy in Studio), 10 mm |
| Text | Right-to-left writing (offers “Right to left” in the text panel) | No |
| Text | Double-clicking a text opens the “Edit Text” window | No |
| Text | SHX fonts: folder of single-line fonts (see Single-line fonts) | None |
| Import | Center imported shapes on the stock; select imported shapes; group shapes from the same file | No; yes; no |
| DXF, SVG | DXF units, text and path closing, native arcs on export, SVG resolution: see Importing | File units (otherwise mm), text kept, 0, segments, 96 DPI |
| Settings file | Export, import, automatic backups, open the settings folder (Mac), reset (Studio): see Settings file and backups | |
| Usage Statistics | Send anonymous usage statistics | Yes |
| Maintenance | Debug Log: the exchanges with the machine and the error messages recorded in debug.log (app folder) from startup, to attach to feedback, nothing is sent (see Debug log); Generate Support Data… (see Support data); Reset App Settings… (settings backed up first, with or without the machine list, after confirmation; projects do not change) | No |
| Feedback | Send Feedback…, Rate Dusty on the App Store… | |
| Assistant (MCP) | On Mac only: Local MCP server, port and token, see Assistant (MCP) | No |
The Usage Statistics and Feedback sections are described in Feedback, updates and statistics.
In Dusty Studio and the desktop app: File › Settings…, with the same sections (the Text section adds SHX fonts one by one) and the same defaults, kept by the browser (or the desktop app); the G-code file name format is remembered by the save window, and statistics are set in the Help menu. “Set up each new project” opens the assistant or the project setup on File › New Project. Starting a job is ignored there when the page was hidden (screen asleep, another tab) or has just come back. The browser may ask for permission to read the clipboard.
Interface and language
- Language: the system's, French or English (Settings › Interface, or the Dusty menu on Mac; in Studio, View › Language or Settings). Window contents and messages change at once; on Mac and iPad, menus and system windows follow the next time Dusty starts.
- Beginner mode: see Beginner mode.
- Keyboard Shortcuts…: the shortcut editor, see Keyboard shortcuts.
- Remember the Move, Rotate, Resize and Skew toggles: the transform toggles of a window that opens (in Studio, of a page) take the state left by the last window where they changed; without this setting, everything is allowed when it opens.
- Layout: the inspector (shown or not) and its panel, in Studio the tab of the right-hand panel, are kept from one launch to the next. View › Reset to Default Layout brings back the inspector on the Shapes panel, closes the floating sheets and shows the whole stock; on Mac, holding Shift while Dusty starts does the same. Neither the drawing, nor the settings, nor the machines change.
- Several windows: all Dusty windows (on iPad, all its windows side by side; in Studio, all browser tabs and the desktop app windows) share the same settings. A change is written at once and the other windows follow it; none of them, when it closes, puts its own settings in place of another's.
Display
Settings › Display (in Studio, the View section of Settings). Every window follows at once.
- Grid contrast: none (grid hidden, only the edge of the work area remains), low, medium or high.
- Handles and nodes: normal size, large or very large: selection handles, nodes of the Nodes tool, corner and side dots, a text's bend handle, and the area where you grab them. With a finger, on iPad, these areas are already enlarged.
- Full-view crosshair: two thin lines follow the pointer from one edge of the view to the other, to align by eye. On iPad, with a trackpad or a mouse (a finger has no pointer).
- Cross at the center of the work area: two lines run through the center of the work area, from edge to edge.
- Numbers on palette colors: each palette swatch (below the canvas on Mac and iPad; "+" button of the Colors panel in Studio) shows its number, to tell two close shades apart; unchecked, the color alone (the active color stays outlined).
- Icon size: seven steps, from smallest to largest: the canvas tool column (in Studio also the top bar, the toggles and the panels' icon buttons). On iPad, they also follow the system text size.
- Text size: same as the system (in Studio, same as the browser), or from 10 to 24 points (pixels in Studio). On Mac, the text and control size of project windows and Settings; on iPad, "Same as the system" follows Settings › Accessibility › Display & Text Size (Dynamic Type) and a chosen size takes precedence; in Studio, all the text of the page. If a size that is too large gets in the way, go back to "Same as the system" or reset the settings.
- Animations: same as the system (Mac: System Settings › Accessibility › Display › Reduce motion; iPad: Settings › Accessibility › Motion › Reduce Motion; Studio: the same system setting, read by the browser), reduced or normal. Reduced: the color found with Flash stays highlighted for a moment without flashing, the running step of the connection assistant no longer pulses, preview playback moves in steps (two per second) and window fades and transitions disappear.
- High density (Retina, 4K screens), in Studio and the desktop app: the work area and the preview (top view, 3D view) are drawn at the screen density (at most 4 pixels per point); unchecked, in page pixels, lighter for a modest graphics card, slightly blurry on a dense screen. On Mac and iPad, the display always follows the screen density: no setting.
Settings file and backups
- Export Settings… writes a
.dustyprefsfile: settings, shortcuts, language, layout (not the machines, the tool library or chosen folders). Import Settings… reads it back, after confirmation: your current settings are backed up first, and those the file does not have go back to their default value. A file from a newer version of Dusty is refused. Mac and iPad settings are exchanged with each other, Dusty Studio settings between browsers and the desktop app. In Studio, the file also carries the text settings (font and height of new texts, double-click, favorite and recent fonts), framing (rectangle or envelope, continuous), Control mode and its requirement before sending, the stepover unit, the connection assistant's long stability test and the preview layout; these choices are written as on the Mac. An older file, without them, is still read: they go back to their default value. - Export a Starter Package (Settings and Machines)… writes a single
.dustyprefsfile with your settings and all your machines (complete profiles; neither the active machine nor the excluded ports, which belong to this device). On the first launch of another installation, Import a Package or Profile… (Mac, iPad) or Import a Package… at the top of the Machine tab (Dusty Studio, also Import a Starter Package… in Settings) adds its machines and applies its settings, after confirmation. Machines are exchanged between all the apps; settings, like a settings file. An older Dusty reads the package as a plain settings file. - Automatic backups: Dusty backs up your settings a few seconds after a change and when it closes, if they have changed; the 50 most recent are kept (on Mac, in the app folder, “Sauvegardes des réglages” subfolder; in Studio, in the browser). Automatic Backups… lists them by date, with what the chosen backup contains (application, number of settings, machines at that time); Load… restores it, after confirmation.
- Open Settings Folder (Mac): the “Sauvegardes des réglages” folder opens in the Finder, with an up-to-date backup of the current settings (
.dustyprefsfiles, to copy or keep elsewhere); the settings themselves are in the system preferences. On iPad, no folder is visible: Export Settings… and Automatic Backups… stand in for it. In Studio and the desktop app, the settings are kept by the browser, with no folder: Export Settings… writes a copy. - Reset: Settings › Maintenance › Reset App Settings… (Mac, iPad), or Reset Settings… in the Settings file section (Studio; also in the Help menu): after confirmation, every setting goes back to its original value, language, shortcuts and layout included, in every window. They are backed up just before: Automatic Backups… restores them. On Mac and iPad, the machine list can be emptied at the same time; in Studio, the machines, the tool library and the machining log stay, and Help › Erase Everything in This Browser (Machines Included)… erases everything the page keeps, backups included.
User bundles
A user bundle (.dustypack) gathers in a single file what you have set up in Dusty, to find it again on another computer, an iPad, in Dusty Studio or the desktop app, or to keep a copy:
- the app settings and the keyboard shortcuts (two separate items);
- the machines (complete profiles);
- the tool libraries (Dusty's one if it has been saved, the active one and the recent ones), operation libraries (those of the machines and those received from a bundle) and art libraries (the loaded ones).
Your projects are not in it: copy them separately, like the SHX fonts folder.
File › User Bundles › Export User Bundle… (More menu on iPad) lists everything, checked by default: uncheck what you do not want to take, then Export…. The bundle is a ZIP archive; each item keeps its own format in it (.dustyprefs, machines file, .dustytools, .dustyops, .dustyart) and can be taken out by hand.
File › User Bundles › Import User Bundle…, or a .dustypack file dropped on the canvas, shows each item and what the import will do with it:
- New: nothing like it here, it is added;
- Already here, identical: grayed out, nothing to do — except a machine, which can still be imported as a copy (unchecked by default);
- Same name, different contents: imported as a copy, under a numbered name (“Wood (2)”); what is already here is never overwritten;
- Settings and shortcuts: they replace yours, backed up first (see Settings file and backups); the settings do not touch the shortcuts, nor the other way round.
Check what you take, then Import. Machines come before libraries: an operation library becomes its machine's library (same name) if that machine does not have one yet, otherwise it is stored in the “Importées” folder of the operation libraries (to open from the operation library window). A received tool library is a new file, added to the recent libraries; on a new installation, the first one becomes the active library. A bundle from a newer version of Dusty is refused.
In Dusty Studio and the desktop app, the machines are exported together; the page keeps one tool library (the bundle's replaces its own: export it first if needed) and one operation library per machine (a received library goes to its machine if it does not have one yet, otherwise it is reported and left aside).
The starter package (settings and machines in a .dustyprefs, see Settings file and backups) is still offered at the first launch.
Moving to a new computer
- On the old computer: File › User Bundles › Export User Bundle…, everything checked, then save the
.dustypackwhere you will find it again (USB stick, iCloud Drive, e-mail). - Copy your projects (
.dusty) and your templates (.dustytemplate) separately, and, if you have one, the folder of your SHX fonts (to choose again in Settings); the computer's fonts come with the system. - On the new computer (Mac, iPad, Dusty Studio or desktop app): install Dusty, then File › User Bundles › Import User Bundle… (or drop the file on the canvas), check the list and Import.
- Check the active machine and its connection (the serial port changes from one computer to another), then run a dry test before machining.
Feedback, updates and statistics
Send Feedback… (Help menu, Settings › Feedback; in Studio, Help menu): a problem, an idea? An email opens in your mail app, addressed to the Dusty team, filled in with the Dusty version, the system, the device model, the language and the connected controller (or "virtual CNC", "not connected"). No personal data, and nothing leaves without you sending it.
Rating Dusty: in App Store versions, Dusty may ask for a rating through Apple's official window, after your third job that went all the way without alarm or interruption on a real machine (the virtual CNC does not count), never during a job, at most once per version and four months apart. The "Rate Dusty on the App Store…" link (Help menu and Settings) opens Dusty's review page on the App Store.
Updates: on Mac, iPad and iPhone, the App Store announces and installs new versions; the app does not look for them itself. Dusty Studio updates itself when it loads.
In the desktop app (Windows, Linux), Dusty looks for new versions at launch (at most once a day) and with Help › Check for Updates…, on the sheet of the latest version published on the Dusty website. A new version is announced with its notes: Open the Download Page (in your browser: nothing installs by itself), Later (the question comes back in three days), Skip This Version; the Check for updates at launch box turns off the check at launch.
Anonymous usage statistics: to know which features are used and which cause problems, Dusty can send anonymous events, in batches, to a statistics server run by the Dusty team:
| Event | What is sent |
|---|---|
| Launch | Unit, theme |
| File exported | Format (G-code, SVG, PDF, DXF, DXF R12) |
| Machine connected or disconnected | Controller family, connection type; closed or lost |
| Job started or finished | Controller family, connection type; finished or interrupted |
| Alarm | Alarm number |
Never sent: file name or content, drawing, project settings, machine name, port or network address, device name, serial number, identifier of the person. To turn sending off: Settings › Usage Statistics (Mac, iPad), or uncheck Help › Anonymous Usage Statistics (Studio, desktop). Development builds send nothing. The complete plan is kept in the project documentation (docs/telemetrie.md).
Keyboard shortcuts
On Mac and on iPad with a keyboard. In Dusty Studio and the desktop app on Windows and Linux, Ctrl replaces ⌘.
| Shortcut | Command |
|---|---|
| ⌘N, ⌘O, ⌘S, ⇧⌘S | New, open, save, duplicate (Mac) |
| ⌘I | Import |
| ⇧⌘O | Open a G-code file as is, to send it to the machine |
| ⌘E, ⌥⌘E | Export the whole drawing, the selection |
| ⌥⌘, | Project setup |
| ⇧⌘E | Save G-code |
| ⌘P, ⇧⌘P | Print in black, in colors |
| ⌘Z, ⇧⌘Z | Undo, redo (drawing and operations) |
| ⌘X, ⌘C, ⌘V, ⌥⌘V, ⌘D | Cut, copy, paste, paste in place, duplicate |
| ⇧⌘D | Duplicate with operations |
| ⌘A, ⇧⌘I | Select all, invert selection |
| ⌥⌘Z | Undo history |
| ⌘J, ⌥⇧⌘D | Join paths, delete duplicates |
| ⌥⌘U, ⌥⌘S, ⌥⌘N | Union, subtract, intersection |
| ⌥⌘A, ⌥⌘X | Weld, cut with shape |
| ⌥⌘C, ⌥⌘B | Convert to path, break apart |
| ⌥⌘O, ⌥⇧⌘O | Offset, optimize shapes |
| ⌥⇧⌘T | Trace image |
| ⌘G, ⇧⌘G | Group, ungroup |
| ⌘L, ⌥⌘L | Lock, unlock |
| ⌃⌘←, ⌃⌘→, ⌃⌘↑, ⌃⌘↓ | Align left, right, top, bottom edges |
| ⌃⌘C | Place at the center of the stock |
| ⌥⌘←, ⌥⌘→ | Rotate 90° left, right |
| ⌥⇧⌘←, ⌥⇧⌘→ | Rotate 15° left, right |
| ⌃⌥⌘←, ⌃⌥⌘→ | Rotate 45° left, right |
| ⌃⌥⇧⌘←, ⌃⌥⇧⌘→ | Rotate 1.5° left, right |
| ⌃⇧⌘←, ⌃⇧⌘→, ⌃⇧⌘↑, ⌃⇧⌘↓ | Dock left, right, up, down |
| ⌃⇧⌘H, ⌃⇧⌘V | Move together horizontally, vertically |
| ⇧⌘H, ⇧⌘V, ⇧⌘M | Flip horizontally, flip vertically, mirror across line |
| ⇧⌘], ⌘], ⌘[, ⇧⌘[ | Bring to front, bring forward, send backward, send to back |
| ⌘K, ⇧⌘K | Add the selection to the selected operation, remove it |
| ⇧⌘L | Tool library |
| ⌥⌘P | Toolpath preview |
| ⌘+, ⌘−, ⌘0, ⌥⌘0 | Zoom in, zoom out, whole stock, selection |
| ⇧⌘T | Show or hide the toolpaths |
| ⌘R, ⌥⌘F | Rulers, filled shapes |
| ⌥⇧⌘N | Project notes |
| ⌥⌘I | Show or hide the inspector |
| ⌘. | Machine STOP |
| ⌃⌘P | Pause the job, or resume it (confirmed) |
| ⌥⌘. | Stop the job (controlled stop) |
| ⌃⌘R | Reconnect the machine |
| ⌥⌘1 to ⌥⌘9 | Machine macro, if you gave it this shortcut (Studio and desktop app: Alt + letter or digit, F2 to F10); see Positions and macros |
| ⌥⌘R, ⌥⇧⌘R | Frame the rectangle, the outline of the cuts (confirmed) |
| ⌘, | Settings |
| ⌘? | Dusty Manual |
| F1 | Help on what you are doing (manual topic; pointer on a tool: that tool's), even while typing |
Canvas (when it has the keyboard):
| Key | Action |
|---|---|
| V, R, E, P, L, T, N, M, X, B, D | Selection, Rectangle, Ellipse, Polygon, Path, Text, Nodes, Measure, Trim, Tabs, Start Point |
| Arrow keys | Move the selection by 1 mm (Shift: 10 mm, ⌥: 0.1 mm) |
| Delete | Delete the selection (or the chosen nodes) |
| Escape | Cancel the gesture, leave the tool, deselect |
| Tab, Shift+Tab | Next shape, previous shape |
| Space held | Move the view by dragging |
| Shift while dragging | Square, circle, angles in steps of 15° or 45° |
| ⌥ while dragging | Shape drawn from its center; node handle freed |
| Ctrl while dragging | No snapping |
| Return, ⌫ (Path tool) | Finish the path, remove the last node |
| S (Path tool) | Smooth mode |
| , and . (Selection tool) | Rotate the selection 90° left, right |
| Shift+L, R, T, B, C, E (Selection tool) | Align left, right, top, bottom edges, centers on a vertical line, on a horizontal line |
| Shift+P (Selection tool) | Move the selection to the center of the stock |
| D, I, M, C, S, B, L, A, T, E (Edit Nodes tool) | Node mode keys: see Editing nodes |
Machine panel, when the jog arrows have the keyboard (see Jogging and homing):
| Key | Action |
|---|---|
| ←, →, ↑, ↓ | Jog X and Y |
| Page Up, Page Down | Jog Z |
| 4, 6, 8, 2, 9, 3 (numeric keypad) | Jog X, Y and Z |
| Shift, ⌥ (Alt) | Step × 10, step ÷ 10 |
| Esc, 5 (numeric keypad) | Stop the move |
Preview: Space plays or pauses; in the 3D view, arrow keys to rotate (⌥: pan), + and − to zoom, 0 to reframe.
Dusty Studio and the desktop app: ⌘O, ⌘S, ⇧⌘S (save as), ⌘I, ⌘E (export the G-code), ⇧⌘P (preview), ⌘P and ⌥⌘P (print in black, in colors), ⌘Y (redo), ⇧⌘V or ⌥⌘V (paste in place), ⇧⌘D (duplicate with operations), ⌘J (join paths), ⌘G and ⇧⌘G (group, ungroup), Ctrl+← and Ctrl+→ (rotate 1.5°), Ctrl+Shift+← and Ctrl+Shift+→ (rotate 45°), ⌥⌘R and ⌥⇧⌘R (frame, Machine menu), ⌘. (STOP), F1 (manual, even in a field or an open window), ? (keyboard shortcuts); node mode keys, S of the Path tool, "," "." and Shift + letter of the Selection tool as on Mac; in the Machine tab, keyboard jog as on Mac (once a jog arrow is clicked), P (pause or resume) and Shift+S (stop the job). The desktop app adds the Mac app shortcuts that browsers keep for themselves: Ctrl+N (new project), Ctrl+Shift+O (open G-code), Ctrl+, (settings), Ctrl+Alt+, (project setup), Ctrl+=, Ctrl+−, Ctrl+0 and Ctrl+Alt+0 (zoom in, zoom out, whole stock, selection), Ctrl+Shift+T (toolpaths), Ctrl+Shift+L (tool library), Ctrl+? (manual); in a browser, the shortcut editor shows them as desktop app shortcuts. The other shortcuts of the drawing commands belong to the Mac and iPad app: in a web browser, these combinations are often taken by the browser itself.
Changing shortcuts: Settings › Interface › Keyboard Shortcuts… (in Studio, also Help › Keyboard Shortcuts…, the ? key). Every command is listed by menu or family, with a search; Edit… waits for the new key, Remove Key removes it, Restore brings back the original one, Restore All brings them all back. On Mac and iPad, the canvas keys can be changed (tools, node mode keys, S of the Path tool: a single letter or digit); menu shortcuts belong to the system and stay fixed. In Studio and the desktop app, menu commands can be changed too (Ctrl, or ⌘ on Mac, or a function key); Undo History, Project Notes, Rulers, Filled Shapes and Shear… start without a key there (⌥⌘Z and ⌘R are taken by browsers), and so does Rotate 15° (Ctrl+Alt and an arrow switch desktops on Linux): give them the one that suits you. A combination already used by another command is reported: confirming takes it away from that command. Refused: system or browser combinations (quit, close, tabs, reload…), those of undo, redo, STOP (⌘.), F1 and ?, and the jog keys of the Machine panel (arrow keys, Page Up and Page Down, numeric keypad digits 2, 3, 4, 5, 6, 8, 9).
Troubleshooting
The machine does not appear or does not answer.
- Run the connection assistant (Machine panel, Connection section): it tries the ports and speeds, and tells what is missing (see Connection assistant).
- Use a USB data cable (some only charge) and plug it straight into the computer.
- Check the connection speed in the machine settings: 115,200 baud for GRBL, grblHAL and FluidNC.
- On Windows, install the driver of the board's USB chip (CH340, CP210x) if the port does not appear; on Linux, add your account to the
dialoutgroup, then log in again. - "The controller no longer responds": machine power, cable, port. Reconnect reopens the connection.
- Try the virtual CNC: if everything works there, the problem is the connection.
The machine is locked (alarm). Read the incident card: home the machine, or Unlock once the cause is dealt with. After a STOP during a move (alarm 3), the position may be lost: home again, or set the work zero again on a machine without limit switches.
The job is refused at the start. The pre-send check says why:
- work zero not set: set X, Y and Z zero;
- rapid move through the material: safe height too low, or Z zero below the surface;
- outside the travel: the work zero is too close to an edge of the machine, or the drawing goes beyond it; move one or the other;
- laser mode (
$32=1): write$32=0(button in Settings to Check).
Errors during the job (error:n). Open Understand and Fix… on the card. If error 8 repeats, switch job streaming to synchronous in the machine settings. Keep the computer from going to sleep during a job.
The spindle does not start, or turns too slowly. Check the maximum S value (setting $30: 1000 on 3018 boards) and the "spindle started by hand" setting in the machine settings.
An operation produces nothing. Read the operation's Problems section: no tool, unsuitable tool, no shape, open shape for a pocket (close it, see Drawing tools), final depth not beyond the start depth, or an operation type not available yet.
The part is cut too deep or not deep enough. Check the stock thickness, the Z zero (top or spoilboard) and the final depth. The My Machining Is… assistant › "The depth is wrong" guides the search.
The dimensions are wrong, the contours do not close. Tool diameter, mechanical backlash, belts, steps per millimeter: see My Machining Is… and its mechanical checks.
The estimated time is far from reality. The machine settings are read at connection; adjust the Simulation section of the machine settings. The log learns the real deviation, job after job.
A text does not have the right font. The font does not exist on this device: Dusty uses another one and says so in the Shapes panel.
Dusty Studio cannot reach the USB port. Use Chrome or Edge on a computer, with the page over HTTPS; or the desktop app.
Duet board: password refused, or page refused by the board. Check the password in the machine settings (Connection). In Dusty Studio, open the page over http:// and send M586 C"*" to the board once (or add it to config.g); the desktop app does not need it. See Duet board.
Marlin: "noisy serial link", repeated resends. Cable too long or unshielded, speed too high for the board: try 115,200 baud (and the same setting in the board). Smoothieware answers !!: the board is halted (HALT), Unlock. See Other controllers.
Reporting a problem. Help › Send Feedback…: describe what you were doing, what you expected and what happened; the email already contains the version and the controller. For a problem that happens again, attach the support data, with the debug log open while you repeat what goes wrong.
Debug log
The debug log records, time-stamped, the exchanges with the machine, the error messages shown and, when opened from startup, the first steps of the launch: version, system, language and the reason it was opened. It helps understand a problem that happens again: open it, repeat what goes wrong, then attach it to the support data. Nothing is sent.
- Mac and iPad: Settings › Maintenance › Debug Log. The setting is kept: at the next launches, the log opens from startup. It is written to
debug.log, in the app folder (beyond 5 MB, it becomesdebug-precedent.log); Show Log in Finder (Mac) or Share Log (iPad). - Launch option (Mac and desktop app): launching Dusty with
-d(or--debug) opens the log from startup for this session only, without changing the setting; Settings (or the Help menu) say so. On Mac, in Terminal:open -a Dusty --args -d. On Windows (installer from the website), add-dat the end of the target of a Dusty shortcut; the Microsoft Store version takes no option: tick Help › Debug log instead, it will open from the next startup. On Linux:dusty-desktop -d, or the AppImage name followed by-d. - Dusty Studio: Help › Debug log (kept in this browser, opened from the next page load), or
?debugadded to the page address (for example…/studio/?debug) for this page only. The log stays in the page: Save Debug Log… writes it to a file. - Desktop app: like Dusty Studio, and the log is also written as it goes to
debug.log, in the app's data folder: it is kept even if the app closes badly.
Support data
To have a problem looked at, Dusty prepares a support archive: a .zip file that you save wherever you want and attach yourself to your message (for example to the Send Feedback… email). Dusty never sends it.
Help › Generate Support Data… (on Mac and iPad, also in Settings › Maintenance):
- Dusty gathers: versions (app, build, core), system, device model, language, rendering, settings, machine profiles, debug logs and the last lines of the machining log.
- It masks everything that could be personal or secret: your account name in paths (
~), email addresses, passwords, tokens, keys and Wi-Fi network names, network addresses (IP and hardware addresses, names of devices on the local network), file names of your documents (<fichier>.dusty), the names given to your machines ("Machine 1") and their notes. Your projects, drawings and images are never included. - The window shows each file exactly as it will be saved, with the number of masked items: read them if you wish.
- Save… writes the archive (
dusty-support-YYYYMMDD-HHMMSS.zip) where you choose; Cancel keeps nothing.
The archive contains LISEZMOI.txt (what it contains), informations.txt, reglages.json, machines.json and the journaux/ folder (debug logs, usinages.jsonl); an empty file is left out.
No results.