Installation
KizamuBeam is free and needs no account or license key. Download the installer for your system from the releases page or the website.
| System | File |
|---|---|
| macOS (Apple Silicon and Intel) | KizamuBeam_…_universal.dmg |
| Windows (64-bit) | KizamuBeam_…_x64-setup.exe |
| Linux (64-bit) | KizamuBeam_…_amd64.AppImage, .deb or .rpm |
macOS
- Open the
.dmgfile and drag KizamuBeam into the Applications folder. - Start KizamuBeam from the Applications folder.
The app is not notarized by Apple yet, so on the first start macOS may say that it cannot be checked. Open System Settings → Privacy & Security, scroll down and click Open Anyway. You only need to do this once.
Open the Terminal and run
xattr -cr /Applications/KizamuBeam.app
Then start KizamuBeam again.
Windows
- Run
KizamuBeam_…_x64-setup.exe. - If Windows SmartScreen warns about an unknown publisher, click More info → Run anyway. The installer is not code-signed yet, which is common for young open-source projects.
- Follow the installer. KizamuBeam then appears in the Start menu.
Linux
Pick the package that suits your distribution:
- AppImage (any distribution): make the file executable and start it.
chmod +x KizamuBeam_*_amd64.AppImage./KizamuBeam_*_amd64.AppImage
- .deb (Debian, Ubuntu, Linux Mint …):
sudo apt install ./KizamuBeam_*_amd64.deb
- .rpm (Fedora, openSUSE …, stable releases only):
sudo dnf install ./KizamuBeam-*.x86_64.rpm
To talk to a laser over USB, your user usually needs access to serial ports. On most distributions that means membership in the dialout group (on Arch-based systems uucp). Log out and back in after adding yourself:
sudo usermod -aG dialout $USER
Updates
KizamuBeam checks for new versions and updates itself: Help → Check for Updates …. Under Edit → Settings → General → Updates you choose the update channel:
- Stable: only finished releases (recommended).
- Nightly (including pre-releases): a new build every night from the current development state, plus release candidates before each stable version. Try new features earlier and help find bugs. Nightly builds are not tested on real hardware: watch your first job, and files saved with a nightly build may not open in the stable version.
If you used the former Beta channel, KizamuBeam switches you to Stable; choose Nightly yourself if you want it.
Next steps
- The user interface: a tour of the main window.
- Connecting a laser: the setup wizard opens by itself on the very first start.