Skip to content
cyrylloPublic

About

Free laser control software for K40 CO2 lasers with Lihuiyu M2 Nano boards. Draw, lay out and cut in one window: layers, material library, pattern fills, living hinges, text on a path, SVG/DXF/G-code/images. Windows installer and Linux AppImage.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

230 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kerfly

tests

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.

Kerfly main window

Installing

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.AppImage executable 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 .kerfly projects 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.

What it does

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

Drawing and editing: mouse and keys

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.

Reporting problems

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.

Supporting the project

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.

Code signing policy

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.

License

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.

About

Free laser control software for K40 CO2 lasers with Lihuiyu M2 Nano boards. Draw, lay out and cut in one window: layers, material library, pattern fills, living hinges, text on a path, SVG/DXF/G-code/images. Windows installer and Linux AppImage.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages