Website and user guide: cyryllo.github.io/Kerfly · Download: latest release · Po polsku: README_pl.md
Kerfly is free laser control software for K40-class CO2 lasers with Lihuiyu (M2 Nano family) controller boards. It runs on Windows 10 / 11, Linux and macOS.
Download the package for your system from the latest release:
- Windows 10 / 11: run
Kerfly-<version>-windows-setup.exe. The installer is not signed, so Windows may say "Windows protected your PC": choose More info → Run anyway. The first time, tick the USB driver for the K40 laser. - Linux: make
Kerfly-<version>-x86_64.AppImageexecutable and run it. Allow the laser's USB port once: Laser → Allow USB access for the laser… (asks for your password; see INSTALL.md). Settings → Add Kerfly to the applications menu… puts it in your menu and opens.kerflyprojects with a double click. - macOS 11 or newer (preview, not yet tested with a laser): open
Kerfly-<version>-macos-arm64.dmg(Apple Silicon) or-macos-x86_64.dmg(Intel) and drag Kerfly to Applications. It is not signed by Apple; how to open it the first time: INSTALL.md.
Step by step, with the self-test and the first run on the laser: INSTALL.md (po polsku). How to use Kerfly: the user guide.
- Lay out the bed. Put several files on a picture of the laser bed, drag, scale and rotate them with the mouse or type their position, size and angle. Copy, cut and paste, align, group, combine and offset shapes, choose the order of the job, undo and redo everything; a right-click menu for the element under the pointer. Files of the same name are told apart by their folder (one folder per customer).
- Draw and edit. Rectangle (with rounded corners), ellipse, polygon, line, polyline, pen curves, freehand and text in any installed font, also along a line, curve or circle. Edit the nodes of drawn shapes and of opened SVG and DXF files.
- Patterns and hinges. The Fill tool fills closed shapes with engraved patterns (lines, waves, honeycomb, concentric, ...) while their outline is still cut. The Living hinge tool cuts hinges that let plywood bend.
- Generators. Ready designs from a few numbers: material test, finger-joint box (laid out to fit the bed, sheet by sheet, with a 3D preview), kerf test, gear, puzzle, ruler, QR code, rubber stamps, rectangular (with a text editor: bold, italic, sizes) and round (inverted and mirrored), and a test card for the laser.
- Layers, like LightBurn. Raster engrave, outline engrave and cut, each with its own speed, passes and power (M3 boards) and colour; cut layers compensate the kerf, so parts come out at their drawn size. A material library (for example "Plywood 3 mm") sets all layers at once.
- Files. SVG, DXF, G-code, and pictures (PNG, JPG, BMP, TIFF, GIF, WebP)
for raster engraving. A project (
.kerfly) keeps the layout, layers, shapes and copies of the source files in one file. - Run the laser. Connect, home, jog, trace the outline, simulate and time the job, pause and resume, stop. The design stays where it is on the bed and the head drives to it, or the design follows the head: your choice. Engrave, outline or cut only, home after each job for the next piece, a report with the job time, your own programs before and after a job (the exhaust on and off). Several lasers? Each gets its profile (board, bed, power, rotary), chosen with one click. Kerfly refuses jobs that would run the head off the bed, and tells you when a new version is out.
- Your language and look. English, Polish, German, Spanish and French (Settings → Advanced → Language); a light or dark theme (Settings → View). Help → Keyboard shortcuts lists every key.
Kerfly 1.8 is stable and ready for everyday work. Changes are in CHANGELOG.md, plans in ROADMAP.md.
| Action | How |
|---|---|
| Select several elements | Drag a frame around them, or Ctrl+click |
| Move | Drag, or the arrow keys (1 mm or one grid step; Shift: 10×) |
| Snapping | Snaps to corners, centres, middles and lines of other elements, to the bed and to the grid (View → Snap to objects, Ctrl+;) |
| Snap nothing for a moment | Hold Alt while drawing, dragging or moving a node |
| Square / circle, 45° lines | Hold Shift while drawing |
| Polyline | Click the corners. Click the first point to close; double-click or Enter for an open line; Backspace removes the last corner; Esc cancels |
| Pen (B) | Click for a corner, press and drag for a smooth curve. Click the first point to close; double-click or Enter to finish; Backspace removes the last node |
| Freehand (F) | Draw with the button held; end near the start to close |
| Measure (M) | Drag between two points: distance, width, height, angle |
| Edit nodes (N) | Drag nodes and round curve handles (Ctrl: one handle alone). Shift+click selects more. Double-click a side to add a node, a node to remove it. Keys: I insert, D delete, L line, C curve, O smooth, S symmetric, Z close / open, B break |
| Edit an opened SVG / DXF | Ungroup it: every line becomes its own shape and the picture splits into its separate parts; click to move, double-click to edit nodes |
| Edit nodes of any element | Double-click it |
| Copy, cut, paste | Ctrl+C / Ctrl+X / Ctrl+V (at the mouse pointer), Ctrl+Alt+V in place, Ctrl+A select all, Esc select nothing |
| Group / Ungroup | Ctrl+G / Ctrl+Shift+G (as in Inkscape). Clicking one member selects the whole group |
| Rotate, mirror, combine (as in Inkscape) | Ctrl+[ / Ctrl+] rotate 90°; H / V mirror; Ctrl++ union, Ctrl+- difference, Ctrl+* intersection, Ctrl+^ exclusion |
| Element list | Shows what is selected on the bed; click a row (Ctrl / Shift: several) to select on the bed |
| Zoom | The wheel zooms in; it does not zoom out further than the whole bed |
| Pan and zoom | Middle or right mouse button drags the view; the wheel zooms |
| Right click | A menu: on an element its commands (Layer ▸ moves all selected elements to another layer), on the empty bed Move the head here |
On KDE Plasma 5, Alt+drag moves windows by default. Change it in System Settings → Window Management → Window Behavior → Window Actions, or use Plasma 6, where Meta moves windows.
In Kerfly choose Help → Report a problem on GitHub… (or the Bug report button). Kerfly saves a diagnostic report (settings, self-test and the log of what was sent to the laser) and opens the report form with the version, system and board filled in; drag the report file into the form. There are forms for laser problems (wrong place, power or speed), other bugs, feature ideas and translation fixes. You can write in English or Polish.
Kerfly is free and stays free. You can help it grow:
- Use it and report what does not work, or what you miss (see above). Every report becomes a test, so the same problem does not come back.
- Tell others about it: on groups and forums, and to whoever sold you your laser.
- Test it with your machine and board, especially boards that are not confirmed yet (M3 Plus and others) and macOS.
- Improve a translation, or add a new language.
- Laser makers, sellers and shops: I am open to cooperation: testing Kerfly with your machines and new boards, ready material settings for them, mentioning Kerfly to your customers, or your own idea. Contact me through my GitHub profile, @cyryllo.
The Windows installer is not code-signed yet, so Windows SmartScreen may warn before the first start (More info → Run anyway). Signing will come once the project is better known. The installers are built from this repository by GitHub Actions, only from releases a team member approves. Committers and reviewers: the project members; approvers: cyryllo (owner). Privacy: Kerfly asks GitHub once a day whether a new version is out (Settings → Advanced switches it off) and sends nothing else; see the privacy policy.
Kerfly is free software, distributed under the GNU General Public License, version 3 or later (GPL-3.0-or-later). See LICENSE.
- Copyright (C) 2017–2026 Scorch: the original K40 Whisperer.
- Copyright (C) 2026 Kerfly contributors: changes made in this fork.
Some files come from other projects and keep their own notices. THIRD-PARTY-NOTICES.md lists each file, its author and its license.
This program controls a laser. It is provided WITHOUT ANY WARRANTY (see sections 15–16 of the GPL). Never leave a running laser unattended.
Kerfly is an independent fork of K40 Whisperer by Scorch, who wrote its laser control core. It is not affiliated with or endorsed by Scorch; please report Kerfly problems here. For developers (running from source, tests, translations, packages): DEVELOPMENT.md.
