A Rinkhals add-on package for the Anycubic Kobra 3 + ACE Pro. It installs from a USB stick: no SSH, no tools on your computer, no cables.
On the printer and in this repository's folders the package keeps its internal name open-kobra (folders, app names, log files), so existing installs upgrade cleanly.
⚠️ Experimental software. Tested on a single Kobra 3 only. It makes persistent changes to your printer (an uninstall package is provided). No warranty of any kind; use at your own risk.
| Component | Purpose |
|---|---|
| kobra-screen | A new touchscreen UI for mainline Klipper + Moonraker (English / Turkish): printing (with bed mesh and Z probe on/off per print, and automatic ACE slot matching: each colour in the file goes to the loaded slot with the same material and the closest colour), temperatures, axes, files, ACE Pro slots and drying, Wi-Fi, wizards (Z-offset measurement, nozzle cleaning, cold pull, PID, input shaper), system status (CPU, memory, MCU load). Installed disabled. |
| ACE Pro driver | Klipper driver for the ACE Pro: load/unload, drying, RFID, tangle protection, per-print tool-to-slot map (ACE_SET_TOOL_MAP). Based on Kobra-S1/ACEPRO with fixes for USB disconnects, drying and error handling. With no ACE plugged in, the printer prints from an external spool like stock (tool changes are skipped, the normal runout sensor is used). |
| Print start and motion | Stock Kobra 3 Y travel limit (260 mm) and X driver interpolation, a nozzle wipe that first probes the bed next to the wiper, purging only over the purge chute, retraction before the nozzle moves over the bed, and a shorter purge line. |
| LeviQ3 | A mainline Klipper re-implementation of the stock firmware's automatic Z-offset (nozzle contact) and bed leveling commands. |
| numpy | numpy built for the printer's CPU and C library, so Klipper's resonance measurement (SHAPER_CALIBRATE) works on the printer itself. |
| Boot guard | If a Rinkhals or Klipper update deletes the LeviQ3 files, restores them at boot; if it cannot, it makes sure Klipper still starts. |
| ace-standalone | A small web panel for running only the ACE Pro (drying, filament) while the Klipper ACE driver is not using it. Installed disabled. |
The package never writes to Anycubic's stock files; it only adds files to the Rinkhals user area and to the vanilla-klipper app.
![]() |
![]() |
![]() |
![]() |
| Home | Printing | Spools and ACE dryer | ACE slot |
![]() |
![]() |
![]() |
![]() |
| Temperatures | Bed mesh | Tools and wizards | Settings |
All 51 screens, one per page: docs/screenshots · everything on one sheet: sheet.png
Required:
- Anycubic Kobra 3 (or Kobra 3 Combo). The installer checks the model and stops without touching anything on other printers.
- Rinkhals installed and running: https://github.com/jbatonnet/Rinkhals
- The vanilla-klipper app with ACE Pro support from Kobra-S1/vanilla-klipper-swu. It is a separate project and is not bundled here; see step 1 below.
- Rinkhals' Moonraker app (
40-moonraker). It ships with Rinkhals. - A USB stick formatted FAT32 with an MBR partition table (GPT does not work).
- At least 10 MB free on the printer.
Tested with: Kobra 3 firmware 2.4.6.7, Rinkhals 20261101_01, vanilla-klipper 0.3, ACE Pro (Gen 1) firmware V1.3.863.
Optional:
- ACE Pro. Everything else works without it; with no ACE connected the printer uses an external spool automatically. ACE Pro 2 has not been tested.
Not needed: SSH, ADB, Docker, software on your computer, internet access during installation.
The printer reads one update.swu per USB insertion, so installation takes two rounds.
- Download
app-vanilla-klipper-k2p-k3.swufrom the newest folder under Kobra-S1/vanilla-klipper-swu → releases. - On the USB stick, create a folder named
aGVscF9zb3Nfand copy the file into it renamed toupdate.swu(aGVscF9zb3Nf/update.swu). - Insert the USB stick into the printer. First beep: started. Second beep: done.
- On the printer screen open Settings → Rinkhals → Manage apps, tick vanilla-klipper, then Enable App → Start App. The first start takes about a minute.
- If you have an ACE Pro: in Mainsail, open
printer.klipper.cfg, remove the#in front of[include ace_K3.cfg], save and restart Klipper.
Details: vanilla-klipper installation guide.
- Download
LibreCubic3-<version>-install.zipfrom Releases. - Delete the old
aGVscF9zb3Nffolder from the USB stick, then unzip the file to the root of the stick. It must containaGVscF9zb3Nf/update.swu. - Insert the USB stick while the printer is on.
- 1 beep: installation started.
- 2nd beep: installation finished.
- 3 short beeps: something went wrong. Changes from that run are rolled back automatically. Details are in
aGVscF9zb3Nf/open-kobra-install.logon the stick.
- Remove the USB stick and restart the printer.
- To use the new touchscreen UI: on the printer screen open Settings → Rinkhals → Manage apps, tick
kobra-screenand restart.
To update, repeat step 2 with the new version's zip. Your settings are kept.
After updating Rinkhals or the vanilla-klipper app, install LibreCubic3 once more: those updates reset Klipper's extension folder. The boot guard restores LeviQ3, but the ACE driver and numpy need a reinstall.
- Delete the old
aGVscF9zb3Nffolder from the USB stick. - Unzip
LibreCubic3-<version>-uninstall.zipto the root of the stick, insert it and wait for the second beep.
Uninstalling does not delete your printer.klipper.cfg; saved settings such as Z-offset, bed mesh and PID stay.
- The printer does not boot or hangs: put an empty file named
.disable-rinkhalsin the root of a USB stick and restart the printer. The stock Anycubic software starts. Once fixed, an empty.enable-rinkhalsfile turns Rinkhals back on. - The touchscreen UI does not start: if
kobra-screencrashes repeatedly it disables itself and brings back the stock screen. You can also go back from the screen with Settings → Return to stock. - More installation and recovery notes: open-kobra/README.md
On a Linux computer you only need sh, tar, gzip, zip, md5sum and python3:
cd open-kobra
./build.shThe result is open-kobra/dist/install/aGVscF9zb3Nf/update.swu; copy that folder to the root of the USB stick.
Tests:
cd open-kobra && ./test.sh
cd kobra-screen && python3 -m unittest discover -p 'test_*.py' # needs Pillow
cd ace-driver && python3 -m unittest discover -s tests
cd leviq3-klipper && python3 -m unittest test_leviq3The UI text-fit tests need the printer's font (AlibabaSans-Regular.ttf). It is not in this repository because its license is unclear; copy it from Rinkhals into kobra-screen/fonts/ to run those tests, otherwise they are skipped.
| Folder | Contents |
|---|---|
open-kobra/ |
USB installation package: build script, install/uninstall scripts, boot guard, tests |
kobra-screen/ |
Touchscreen UI |
ace-driver/ |
Klipper ACE Pro driver |
leviq3-klipper/ |
LeviQ3 Klipper extension |
ace-standalone/ |
Standalone ACE Pro web panel |
tools/ace-fw/ |
Advanced: ACE Pro dryer cool-down patch (details inside; needs SSH) |
tools/numpy-uclibc/ |
How the bundled numpy was built |
- Bugs and feature requests: open an issue on the Issues page. Questions and ideas are welcome in Discussions.
- Security vulnerabilities: do not open a public issue; follow SECURITY.md.
- Contributing: CONTRIBUTING.md
Before attaching logs, remove your Wi-Fi name, IP addresses and serial numbers.
GPLv3, see LICENSE. Third-party components and credits: NOTICE.md.
This project is not affiliated with Anycubic. "Anycubic", "Kobra" and "ACE Pro" are trademarks of their owners.







