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:

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.

Safety

A desktop CNC is still a machine tool. Dusty adds many safeguards, but none of them replaces your attention.

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).

PlatformMinimumRecommended
MacmacOS 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
iPadiPadOS 17 (every iPad that runs it); the app also installs on iPhone (iOS 17), whose screen is too small to draw comfortablyiPad with an A12 chip or later, keyboard and trackpad for precise drawing; network machine (the iPad has no serial port)
Windows64-bit Windows 10 (x86-64) with WebView2 (built into Windows 11, installed by Windows Update on Windows 10) and a WebGL2 graphics cardWindows 11, processor from 2015 or later, 8 GB of memory, 1920 × 1080 display
Linux64-bit distribution (x86-64) with WebKitGTK 4.1 (Ubuntu 22.04, Debian 12, Fedora 38 or later) and WebGL2Ubuntu 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 computerUp-to-date Chrome or Edge: WebGPU for drawing and the 3D view, WebSerial to drive the machine over USB

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

AreaFeatures
PlatformsMac (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.
DrawingShapes, 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 simulationTop 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-code14 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.
MachineDirect 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.
NetworkDusty 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.
HelpThis manual (F1, ? buttons, collections, concepts, workholding guide), tour and example projects, My Machining Is… assistant, preview troubleshooting, debug log, support data.

Announced features

FeatureWhat it will bring
More controllers driven directlyDuet / RepRapFirmware over HTTP, Smoothieware, Marlin, FluidNC over WebSocket; tool changer tests on a real grblHAL board.
3D relief3D models (STL, OBJ, 3MF…) as depth maps, relief roughing and finishing, inlays, rotary A axis in indexing.
LaterCamera and photo of the stock, automation, more controllers (Buildbotics, remote LinuxCNC), plotter, knife and plasma modules.

Not planned

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.

  1. From drawing to part: the four moves, always in the same order — draw, choose the operations, check the preview, machine on the machine.
  2. 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.
  3. Safety first: protection, clamping, dry run, supervision, STOP and the emergency stop.
  4. 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:

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.

  1. 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.
  2. 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.
  3. Drawing: Rectangle tool (R), drag on the canvas, then type the exact width and height in the Shapes panel. Or import an SVG (⌘I).
  4. Tool: Tools panel › Add Tool › From Library › a 3.175 mm end mill. Its feeds and speeds will go into the operation.
  5. 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.
  6. 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.
  7. 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).
  8. 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:

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:

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 laserWith 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).
On the left, the laser cuts on the line (red); on the right, the center of the bit (blue) runs one radius away from the drawing (dashed): the slot is as wide as the tool.
Inside corner: sharp with a laser (left), rounded to the bit radius (middle), cleared by dogbones so that a square part goes all the way in (right).

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.

ExampleWhat it showsMaterialToolsTime
Key ringsoutside profile, holes, tabs6 mm plywood3.175 mm end mill6 min
Engraved signV-carved text, profile on the line12 mm hardwood or MDF60° V-bit5 min
Rulersingle-line font, open lines6 mm wood20° V-bit3 min
Drill bit holderpeck drilling, tool change20 mm hardwood5 and 3 mm drills3 min
CoasterSVG import, pocket, tabs6 mm plywood3.175 mm end mill7 min
Catch-all traypocket, rest pocket, tool change18 mm MDF6 and 3.175 mm end mills14 min
Cutting boardball nose groove, thick cut-out with tabs15 mm hardwood6 mm ball nose, 6 mm end mill20 min
Finger-joint boxnotches, dogbones, cut-out with tabs6 mm plywood3.175 mm end mill17 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.

  1. 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.
  2. 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.
  3. Stock: measure its real thickness and enter it in the project setup; a through cut goes 0.3 mm into the spoilboard.
  4. 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.
  5. Workholding: as the example's notes say, always clear of the toolpaths; the safe height (10 mm) must clear the clamps (see Travel heights).
  6. 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.
  7. Frame…, then Dry Run…: the job is played above the stock, spindle off (see Running a job).
  8. 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).
  9. 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.

  1. Project: File › New, stock 160 × 70 × 6 mm, origin Bottom left corner, Z zero Top of stock (see Project setup).
  2. 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).
  3. Tool: Tools panel › Add Tool › From Library › the 3.175 mm 2-flute end mill.
  4. 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).
  5. 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).
  6. Preview: about 6 minutes; the machined part shows the bridges that hold the parts.
  7. 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.

  1. Project: stock 160 × 60 × 12 mm, origin bottom left corner, Z zero top of stock.
  2. 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.
  3. Border: a 150 × 50 mm rectangle with 6 mm rounded corners, 5 mm from the edges, on another paint color (see Paint colors).
  4. 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.
  5. 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).
  6. Profile of the border: side On the line, depth 1.5 mm, with the same bit: no tool change.
  7. Preview: about 5 minutes. In the top view, the machined part shows the V bottoms and the sharp corners of the letters.
  8. 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.

  1. Project: stock 130 × 35 × 6 mm.
  2. 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.
  3. 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).
  4. Tool: the 20° V-bit of 3.175 mm from the library.
  5. 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.
  6. Preview: less than 3 minutes.
  7. 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.

  1. Project: stock 160 × 60 × 20 mm.
  2. 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.
  3. Tools: the 5 mm and 3 mm drills of the library (tools no. 1 and no. 2).
  4. 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).
  5. Preview: about 3 minutes; the holes follow the shortest path.
  6. 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.

  1. Project: stock 100 × 100 × 6 mm.
  2. 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.
  3. Tool: the 3.175 mm 2-flute end mill.
  4. 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).
  5. Profile of the disc: Outside, 6.3 mm, with 6 mm tabs.
  6. Preview: about 7 minutes.
  7. 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.

  1. Project: stock 120 × 120 × 18 mm.
  2. Star: Drawing › Preset Shapes › Star, 5 sides, inner radius 50 %, radius 50 mm, in the middle of the stock (see Drawing tools).
  3. Tools: the 6 mm (tool no. 1) and 3.175 mm (tool no. 2) end mills.
  4. Pocket of the star with the 6 mm end mill: 6 mm deep, 1 mm passes, 700 mm/min.
  5. 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).
  6. Preview: about 14 minutes. With the by operation colors of the machined part, the second operation only touches the points.
  7. 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.

  1. Project: stock 240 × 160 × 15 mm, almost the whole travel of a 3018.
  2. Groove: a 210 × 130 mm rectangle with 15 mm rounded corners, centered.
  3. Outline: a 230 × 150 mm rectangle with 20 mm rounded corners, centered, on another color.
  4. Tools: the 6 mm ball nose bit (tool no. 1) and the 6 mm 2-flute end mill (tool no. 2).
  5. 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.
  6. 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).
  7. Preview: about 20 minutes.
  8. 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.

  1. Project: stock 230 × 120 × 6 mm. Measure your plywood: the notches must match its real thickness (often 5.8 mm for "6 mm" plywood).
  2. 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.
  3. Tool: the 3.175 mm 2-flute end mill.
  4. Outside profile of all the parts: 6.3 mm, 1 mm passes, 6 mm tabs.
  5. 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.
  6. Preview: about 17 minutes; in the top view, the dogbones show at the bottom of each notch.
  7. 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:

  1. The drawing: shapes, sorted by paint color. They say where to machine, not how.
  2. 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).
  3. 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.
  4. The G-code: the toolpaths translated into the controller's dialect (the flavor): G0 for a rapid move, G1 for a straight cut, G2 and G3 for arcs, M3 and M5 for 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

From left to right: flat end mill, ball nose, V-bit, drill bit.

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 (left), outside (middle), inside (right): the drawing dashed, the path of the tool center in blue.

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 (left) and conventional (right): the bit turns the same way, it moves the other way; the machined edge is behind it.

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

Stepover and depth per pass

Section of a pocket: the bit (gray) has cleared a first depth; it moves one stepover (bottom arrow) from its previous pass (dashed); the right arrow shows the depth per pass.

Origin, zeros and coordinates

The machine knows its machine zero (black cross, found by homing); the work zero (blue cross) is set wherever you want, here at the front left corner of the stock, with the X and Y axes of the drawing.

Heights and rapid moves

Good path (blue): rapid move at the safe height (gray dashed), above the clamp, plunge, cut, retract. Bad (red): a rapid too low goes through the clamp.

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.

SettingPurpose
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 originCorner of the stock (bottom left, bottom right, top left, top right) or center, where you will set X and Y zero.
Z zeroTop of stock, or bottom of stock (the spoilboard).
On the MachineThe steps to carry the origin and the Z zero over to the machine.
HeightsSafe height, fast retract between shapes, pocket lift: see Travel heights.
Cut orderRepeated parts machined operation by operation or part by part: see Cut order of repeats.
UnitsMillimeters or inches, for display and input; Dusty always computes in millimeters.
MachineThe 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:

An inaccurate Z zero cuts into the spoilboard or leaves the part attached: set it carefully, preferably by probing.

Travel heights

HeightDefaultPurpose
Safe height10 mmHeight of rapid moves above the stock surface. It must clear anything that sticks up: clamps, screws, hold-downs.
Fast retract between shapeson, 2 mmFrom 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 lift0.5 mmInside 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:

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.

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.

ToolKeyUse
SelectionVClick, drag a box, move, resize with the handles, rotate by grabbing just outside a corner.
RectangleRDrag; 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).
EllipseEDrag; Shift: circle; ⌥: from the center.
PolygonPDrag: 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).
PathLClick: 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).
TextTClick, then type: see Text.
Edit NodesNNode bar at the top of the canvas: see Editing nodes.
MeasureMDrag between two points: distance, offsets and angle.
TrimXClick part of an outline to remove it: see Measure and trim.
TabsBClick an outline to place a tab there, click a tab to remove it: see Tabs.
Start PointDClick 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):

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:

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:

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:

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.

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:

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):

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:

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:

Settings depending on the type:

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.

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.

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.

KeyAction
DOn a node: delete it (with the other chosen nodes); on a segment: delete the segment
IInsert a node at the point of the segment under the pointer
MInsert a node in the middle of the segment under the pointer
CCorner node
SOn a node: smooth node; on a straight segment: change it into a smooth curve
BBreak the path at the node
LChange the segment into a straight line
AAlign the selection to the segment: it rotates to make it horizontal, vertical or 45°
TTrim the segment up to the nearest crossings
EExtend 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.

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

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

Rulers, guides and display

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:

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:

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 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:

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:

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.

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:

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).

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:

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:

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:

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.

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).

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:

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.

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:

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:

Each adjustment is an undoable action.

Image Options (Drawing › Image Options and the context menu; a single image, not grouped, as in MillMage):

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.

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.

Importing and exporting

Importing

File › Import… (⌘I), the Import button, or a file dropped on the canvas:

FormatWhat is imported
SVG, DXF, PDF, EPSThe 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, HPGLThe 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, WebPAn 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:

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):

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:

The MillMage file is never rewritten: Save creates a .dusty project.

In MillMageIn 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.
LayersPaint colors with the same number: their name and visibility.
Tools of the operationsProject 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-CarvingOperations 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 pointTabs 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:

Exporting the drawing

File › Export › Whole Drawing… (⌘E) or Selection… (⌥⌘E):

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.

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

  1. Select the shapes to machine.
  2. 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.
  3. 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:

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.

GroupParameters
DepthsStart depth (0: the surface); Final depth, as a value or as a percentage of stock (100% = the whole thickness).
Feeds and speedsFeed rate (cutting), Plunge rate, Ramp feed rate, Spindle speed: taken from the chosen tool.
PassesDepth per pass (the last pass may be shorter); Stepover as a % of the diameter or as a length (pockets, surfacing); Cut direction.
StrategyWhat is specific to the type: side, pattern, stock to leave…
EntryEntry type and Ramp angle: see Entering the material.
TabsProfile only: see Tabs.
AccessoriesVacuum 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.

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:

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.

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):

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.

Pocket

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.

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.

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.

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.

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.

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).

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.

Surfacing and face

Two operations to flatten, with an end mill (a wide surfacing bit goes faster):

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:

Ramps ("Strategy" group):

What Dusty does:

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:

Lines ("Passes" group):

Strokes ("Strategy" group):

What Dusty does:

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:

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:

What Dusty does:

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:

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.

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:

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.

Tool library

Operations › Tool Library… (⇧⌘L), or the library button of the Tools and Operations panels.

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:

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:

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.

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:

Good to know:

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:

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:

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:

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):

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).

TokensReplaced 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:

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:

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.

FlavorTool changeExtensionGood to know
GRBL 1.1M0 pause, after retract and spindle stop.nc3018-type desktop CNC.
GRBL M3M0 pause.ncOlder variant without M4.
grblHALM6 T.ncManual or automatic change, depending on the controller.
GRBL-STMM0 pause.ncGRBL ported to STM32 boards.
FluidNCM0 pause without a configured changer.ncGRBL-compatible ESP32 boards.
SmoothiewareSuspend (M600).gcodeNo M4; ; comments.
Marlin (Snapmaker)M0 pause with an on-screen message.gcodeMillimeters only; never M30; arcs written as segments.
Duet / RepRapFirmwareMessage box (M291).gcode; comments.
LinuxCNCT M6.ngcFour decimals.
Mach3 / Mach4T M6.tap
UCCNCT M6.ncLike Mach3.
MASSOT M6.ncDwells in milliseconds.
CentroidT M6.nc; comments.
Generic (RS-274)T M6.ncThe 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.

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.

OptionEffect
Tool changesNothing: 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 changerWith 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 unitsG4 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 characterThe 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 commentsNo comment in the program, including those of the blocks (the message of an M0 pause disappears, the pause stays).
Verbose outputThe 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:

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.

VariableValue
tool_number, tool_name, tool_diameter, tool_angleNumber, name, diameter and included angle of the tool (no angle for an end mill).
rpmSpindle speed written (none with the spindle off).
feedLast feed rate written.
operation, section, programOperation name, its rank (from 1), program name.
safe_z, tool_change_zSafe height, height of the retract before a tool change.
x, y, zCurrent position (none when unknown, for example after a tool change).
unitsmm or in.
messageTool change prompt (tool change block only).
dwellDwell 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:

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:

MethodSuitsLimits
Screws into the spoilboardThick or large stock, through cuts, strong forcesHoles in the waste; screws to keep away from the toolpaths
ClampsRigid stock of even thickness, quick changesBulk above the stock; safe height to raise
Double-sided tapeThin sheets, small parts, engravingLittle side force; the glue gives way with heat or dust
Masking tape and cyanoacrylateThin or small parts, whole surface freeCuring time; glue to handle with care
Jigs and stopsSeries, identical parts, flippingJig to make, often on the CNC itself
Machinable bradsWood, through cuts, saving spaceNailer and plastic brads; brads to keep out of finishing passes
Vacuum tableFlat panels, seriesEquipment; leaks; small parts that let go at the end of the cut
ViseBlocks, thick parts, soft metalsLimited area; jaws to avoid; vise to fix square
Tabs and thin last passEvery through cutBridges to cut and sand afterwards

Before starting:

  1. Shake the stock by hand, spindle stopped: it must neither slide nor tilt.
  2. 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.
  3. 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).
  4. 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).
  5. 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.

Screws (gray) in the waste, away from the toolpaths (blue): each dashed circle marks the margin to keep around a screw.

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).

Step clamp: on the left, clamp level and stud near the stock, which takes the force; on the right, block too low, clamp tilted and stud near the block: the stock is poorly held.

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.

On the left, strips of tape (yellow) between the spoilboard and the stock, pressed down; on the right, top view: tape under each part to be cut out (blue).

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.

From bottom to top: spoilboard, masking tape, glue dots (orange), masking tape, stock; press for a few seconds.
  1. Masking tape smoothed well on the spoilboard and under the stock, strips edge to edge, without bubbles.
  2. A few dots or a bead of glue on one of the tapes; an activator sprayed on the other speeds up curing.
  3. Lay down, press for 10 to 30 seconds, then wait for the full cure given by the maker before starting.
  4. 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.

Jig (dark beige) fixed to the spoilboard: each pocket takes a part, pushed against three stops (black dots).

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.

Brads (white) driven into the waste on either side of the cut: they go through the stock and hold in the spoilboard.

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.

Section: chamber and drilled plate of the table (gray), spoilboard that lets air through, stock; the air is drawn towards the pump (right).

Table-mounted vise

A milling vise fixed to the table holds blocks, thick parts and soft metals (aluminum, brass) by side clamping.

On the left, top view: vise fixed to the table, part between the jaws. On the right, side view: parallels under the part, which stands above the jaws.

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:

View along the unrolled contour: on the left, the cut goes through and into the spoilboard, except at the tabs (blue); on the right, a thin skin remains everywhere, removed by a last pass (dashed).

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.

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:

  1. 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 $I in the console.
  2. 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.
  3. Information: name, controller units, X, Y, Z travel, machine zero corner.
  4. Communication: flavor, serial signals, streaming mode, spindle.
  5. 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.

SectionSettings
MachineName, controller units, X, Y, Z travel, machine zero corner (where the tool goes when homing), automatic detection of that corner.
ConnectionNone, 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.
ControllerG-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).
StartupOffer Homing When Connecting (a question, never without your agreement); pre-start checklist, one item per line, to check before each job.
Spindle and filesMaximum 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-processorTool changes, automatic tool changer, dwell units, comments, block escape character, verbose output: see Post-processor options.
KinematicsMaximum speeds and accelerations per axis, to estimate durations (read back from the controller).
SimulationJunction deviation, minimum corner speed, simulated cutting and overall speeds (in %): they adjust the time estimate.
AccessoriesVacuum and coolant: present or not, on and off commands, stop when a job is interrupted.
Custom G-codeThe blocks: see Custom G-code.
ProbeZ plate only or XYZ block: thicknesses, walls, search distances, speeds: see Probing.
Tool length sensorSee Tool length sensor.
Saved positions, MacrosSee Positions and macros.
NotesFree 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:

  1. Choose the machine (the active machine).
  2. 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.
  3. 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.

  1. 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.
  2. 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.
  3. 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 (dialout group 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).
  4. Controller settings: the travel ($130 to $132) is read.
  5. 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.
  6. 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.

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:

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.

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:

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:

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:

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.

  1. Coordinates: Work (the work zero) or Machine (machine coordinates).
  2. 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.
  3. 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.

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:

  1. 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.
  2. 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.
  3. Values: thicknesses, search distances, fast and precise speeds, precise distance, back-off — taken from the machine and kept for it.
  4. 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):

  1. With the built-in jog, bring the tool tip against the edge (with paper, without forcing), then Take point 1.
  2. Repeat for points 2 and 3, well spaced around the edge.
  3. 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:

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):

  1. 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.
  2. 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.
  3. 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.
  4. 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):

  1. 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.
  2. 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.
  3. 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 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).

  1. 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.
  2. 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.
  3. 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 ($120 to $122) and rates ($110 to $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:

  1. 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.
  2. 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.
  3. 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 $100 and $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):

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

CommandEffect
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 JobControlled 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:

How the new tool's length is taken into account depends on the machine:

MachineWhat the prompt says
Without a tool length sensorSet 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 sensorMeasure 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 jobNothing to do: the new tool is measured as soon as you resume.
Controller tool tableNothing 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.

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:

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

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.

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.

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 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:

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).

CommandWhat it does
$IController information: version, options, buffer size.
$$All settings ($0 to $132…).
$#Offsets: G54 to G59 coordinate systems, G28, G30, G92, tool length, last probe.
$GParser state: active modes (G54, G90, G21, M5…).
?Immediate status report: state, positions, feed, spindle.
$XUnlocks after an alarm, without homing: the position is not guaranteed.
$HHomes all axes (limit switches required).
$HX, $HY, $HZHomes a single axis, if the controller accepts it.
$n=vWrites a setting ($110=2000); prefer Controller settings, which checks the value.
$CCheck mode: G-code is read without moving; send it again to leave.
$NLines run each time the controller starts.
$J=Jog, for example $J=G91 X10 F1000 (10 mm along X).
$SLPSleep: 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:

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.

  1. 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.
  2. Questions: two or three, one at a time, with a way back; Show the Diagnosis Now skips the remaining ones.
  3. 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.

Studio's Machine tab

The Machine tab follows the Machine panel of the Mac app, with the same safeguards (the core is the same):

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:

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.

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.

Settings

Dusty › Settings… (⌘,) on Mac, More › Settings… on iPad. They apply to every window.

SectionSettingDefault
InterfaceLanguage, beginner mode, remembered transform toggles, Keyboard Shortcuts…, Reset to Default Layout: see Interface and languageSystem language, no, no
ProjectUnits of new projects (millimeters or inches)Millimeters
ProjectSet up each new project (stock, origin, Z zero)Yes
ProjectNew project setup: step-by-step assistant or everything on one pageStep-by-step assistant
MachiningCurve Tolerance: fineness of the toolpaths along curves (smaller: more accurate, longer G-code)0.01 mm
MachiningCurves 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-codeArcs
MachiningG-code files: the name format offered when saving (a preset or your own)A single file
MachiningIgnore 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 travelNo
MachiningIgnore “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 machineYes
CanvasWork area: same as the interface, light or darkSame as the interface
CanvasGrid spacing (0: automatic, depending on the zoom)0
CanvasCurve quality: fine, or fast for very busy drawingsFine
CanvasInverted scroll wheel zoomNo
DisplayGrid 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 DisplayMedium, normal size, no, no, yes, normal, same as the system, same as the system (yes)
DrawingSnap to objects, snap to gridYes, no
DrawingReturn to the Selection tool after a shapeYes
DrawingArrow key step, arrow key step with Shift1 mm, 10 mm
DrawingClick selection tolerance and object snap distance, in screen points5 pt, 8 pt
DrawingCopy 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 DustyNo
TextDefault font and height of new textsHelvetica (Tuffy in Studio), 10 mm
TextRight-to-left writing (offers “Right to left” in the text panel)No
TextDouble-clicking a text opens the “Edit Text” windowNo
TextSHX fonts: folder of single-line fonts (see Single-line fonts)None
ImportCenter imported shapes on the stock; select imported shapes; group shapes from the same fileNo; yes; no
DXF, SVGDXF units, text and path closing, native arcs on export, SVG resolution: see ImportingFile units (otherwise mm), text kept, 0, segments, 96 DPI
Settings fileExport, import, automatic backups, open the settings folder (Mac), reset (Studio): see Settings file and backups
Usage StatisticsSend anonymous usage statisticsYes
MaintenanceDebug 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
FeedbackSend 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

Display

Settings › Display (in Studio, the View section of Settings). Every window follows at once.

Settings file and backups

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:

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:

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

  1. On the old computer: File › User Bundles › Export User Bundle…, everything checked, then save the .dustypack where you will find it again (USB stick, iCloud Drive, e-mail).
  2. 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.
  3. 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.
  4. 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:

EventWhat is sent
LaunchUnit, theme
File exportedFormat (G-code, SVG, PDF, DXF, DXF R12)
Machine connected or disconnectedController family, connection type; closed or lost
Job started or finishedController family, connection type; finished or interrupted
AlarmAlarm 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 ⌘.

ShortcutCommand
⌘N, ⌘O, ⌘S, ⇧⌘SNew, open, save, duplicate (Mac)
⌘IImport
⇧⌘OOpen a G-code file as is, to send it to the machine
⌘E, ⌥⌘EExport the whole drawing, the selection
⌥⌘,Project setup
⇧⌘ESave G-code
⌘P, ⇧⌘PPrint in black, in colors
⌘Z, ⇧⌘ZUndo, redo (drawing and operations)
⌘X, ⌘C, ⌘V, ⌥⌘V, ⌘DCut, copy, paste, paste in place, duplicate
⇧⌘DDuplicate with operations
⌘A, ⇧⌘ISelect all, invert selection
⌥⌘ZUndo history
⌘J, ⌥⇧⌘DJoin paths, delete duplicates
⌥⌘U, ⌥⌘S, ⌥⌘NUnion, subtract, intersection
⌥⌘A, ⌥⌘XWeld, cut with shape
⌥⌘C, ⌥⌘BConvert to path, break apart
⌥⌘O, ⌥⇧⌘OOffset, optimize shapes
⌥⇧⌘TTrace image
⌘G, ⇧⌘GGroup, ungroup
⌘L, ⌥⌘LLock, unlock
⌃⌘←, ⌃⌘→, ⌃⌘↑, ⌃⌘↓Align left, right, top, bottom edges
⌃⌘CPlace 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, ⌃⇧⌘VMove together horizontally, vertically
⇧⌘H, ⇧⌘V, ⇧⌘MFlip horizontally, flip vertically, mirror across line
⇧⌘], ⌘], ⌘[, ⇧⌘[Bring to front, bring forward, send backward, send to back
⌘K, ⇧⌘KAdd the selection to the selected operation, remove it
⇧⌘LTool library
⌥⌘PToolpath preview
⌘+, ⌘−, ⌘0, ⌥⌘0Zoom in, zoom out, whole stock, selection
⇧⌘TShow or hide the toolpaths
⌘R, ⌥⌘FRulers, filled shapes
⌥⇧⌘NProject notes
⌥⌘IShow or hide the inspector
⌘.Machine STOP
⌃⌘PPause the job, or resume it (confirmed)
⌥⌘.Stop the job (controlled stop)
⌃⌘RReconnect the machine
⌥⌘1 to ⌥⌘9Machine macro, if you gave it this shortcut (Studio and desktop app: Alt + letter or digit, F2 to F10); see Positions and macros
⌥⌘R, ⌥⇧⌘RFrame the rectangle, the outline of the cuts (confirmed)
⌘,Settings
⌘?Dusty Manual
F1Help on what you are doing (manual topic; pointer on a tool: that tool's), even while typing

Canvas (when it has the keyboard):

KeyAction
V, R, E, P, L, T, N, M, X, B, DSelection, Rectangle, Ellipse, Polygon, Path, Text, Nodes, Measure, Trim, Tabs, Start Point
Arrow keysMove the selection by 1 mm (Shift: 10 mm, ⌥: 0.1 mm)
DeleteDelete the selection (or the chosen nodes)
EscapeCancel the gesture, leave the tool, deselect
Tab, Shift+TabNext shape, previous shape
Space heldMove the view by dragging
Shift while draggingSquare, circle, angles in steps of 15° or 45°
⌥ while draggingShape drawn from its center; node handle freed
Ctrl while draggingNo 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):

KeyAction
←, →, ↑, ↓Jog X and Y
Page Up, Page DownJog 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.

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:

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.

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):

  1. Dusty gathers: versions (app, build, core), system, device model, language, rendering, settings, machine profiles, debug logs and the last lines of the machining log.
  2. 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.
  3. The window shows each file exactly as it will be saved, with the number of masked items: read them if you wish.
  4. 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.