Rinkhals is a custom firmware for some Anycubic Kobra 3D printers (specifically the ones running Kobra OS, see below for the details).
The goal of this project is to expand existing Anycubic features with better compatibility, apps and more. I will likely not support all use cases, like running vanilla Klipper or your specific feature / plugin.
By using Rinkhals, you will keep all stock Anycubic features (print screen, Anycubic tools, calibration, ...) and get even more, like:
- Mainsail, Fluidd (with Moonraker)
- USB camera support in Mainsail, Fluidd
- Orca will show the print progress on the printer screen
- SSH access for customization
- Apps system (OctoApp, ...)
For now the following printers and firmwares are supported:
- Kobra 3 (+ combo) with firmware 2.3.5.3
- Kobra 2 Pro with firmware 3.1.2.3 (with motherboard Trigorilla Spe B v1.0.x)
- Other newer Kobra printers are not yet supported, but very well might be at some point
In case you're wondering this project is named after rinkhals, a sub-species of Cobras ... Kobra ... Rinkhals 👏
You can join the Rinkhals community on Discord: https://discord.gg/3mrANjpNJC
Warning
Make sure you're confident tweaking your printer and you understand what you're doing. I'm not responsible if you brick your printer (even if there's some documentation about that)
Rinkhals uses an overlay system to keep its modifications isolated from the stock firmware. This way it's easier to revert back to stock if needed, or use multiple versions in parrallel.
- Make sure your printer uses one of the supported firmwares (how to install firmware)
- Installation will simply fail without touching your printer if you are using some other version
- Format a USB drive as FAT32
- Create a directory named aGVscF9zb3Nf
- Download the version of Rinkhals you want to install from the Releases
- Copy the update.swu file in the aGVscF9zb3Nf directory
- Plug the USB drive in the printer
- You should hear a beep, meaning the printer detected the update file
- After about 20 seconds (the time for the printer to prepare the update), you will see a progress bar on the screen
- If the progress bar turns green and you ear 2 beeps, the pritner reboots and Rinkhals is installed
- If the progress bar turns red and you ear 3 beeps, the installation failed but everyhting should still work as usual. You will then find more information in the aGVscF9zb3Nf/install.log file on the USB drive
If needed, the stock firmwares are available over there: https://1drv.ms/f/s!Ag-0E4JXrqAlwbwl1zK9Le15gYv0sA?e=v2YMPT
(Exclusive to Kobra 3 for now)
After installation, Rinkhals provides a touch UI accessible from the printer screen when you tap the Settings icon, then tap Rinkhals.
This UI allows you to stop or disable Rinkhals, and to control what feature and or app is enabled. This will allow you to customize your experience and keep the printer memory as low as needed based on your situation.
An apps system is provided in Rinkhals. It allows for the users to easily add some features to their printer. Some default ones are provided and other are available on a separate repo: https://github.com/jbatonnet/Rinkhals.apps
Instructions on how to install or develop apps are on the other repo as well.
- Disable Rinkhals by disabling from the touch UI or by creating a .disable-rinkhals file on a USB drive or at this location: /useremain/rinkhals/.disable-rinkhals
- Reboot your printer, it will boot the stock firmware
- If you want, you can delete Rinkhals by deleting the /useremain/rinkhals directory
The wiki is a collection of documentation, reverse engineering and notes about the printer and development, don't forget to check it out!
If your printer shows a 11407 error, check the wiki there: See the wiki about error 11407
This repo contains some tools you can use no matter what firmware you are using. It is a set of scripts packaged in a SWU file.
They are available on this page: https://github.com/jbatonnet/Rinkhals/actions/workflows/build-swu-tools.yml
You can download the SWU file for the tool you want, copy it on a FAT32 USB drive in a aGVscF9zb3Nf directory, plug the USB drive in the Kobra and it just works. You will ear two beeps, the second one will tell you that the tool completed its work. There is no need to reboot afterwards.
Here are the tools available:
- SSH: get a SSH server running on port 2222, even on stock firmware
- Backup partitions: creates a dump of your userdata and useremain partition on the USB drive
- Debug bundle: creates a zip file with printer and configuration information on the USB drive to ease debugging
Warning
If you develop on Windows like me, don't forget to disable Git's autocrlf function, as this repo contains Linux scripts running on Linux machines.
Run git config core.autocrlf false BEFORE cloning the repo
You will need either a Linux machine or a Windows machine with Docker.
Here are the steps:
- Clone the repo or Download the zip
- Do your modifications
- Open a terminal at the root of the repo, and run:
docker run --rm -it -e KOBRA_IP=x.x.x.x -v .\build:/build -v .\files:/files --entrypoint=/bin/sh rclone/rclone:1.68.2 /build/deploy-dev.sh
This will create a "dev" version on your printer. Using the script above will synchronize your workspace with your PC. Now you can start/restart your updated "dev" version using SSH:
chmod +x /useremain/rinkhals/dev/start.sh/useremain/rinkhals/dev/start.sh
If you ever want to create a full SWU with your version, use the build-swu.sh script with Docker, and you'll get your SWU in build/dist/update.swu:
docker run --rm -it -e VERSION="yyyymmdd_nn" -v .\build:/build -v .\files:/files ghcr.io/jbatonnet/rinkhals/build /build/build-swu.sh
If you're ever stuck, reboot, use the SSH SWU tool to regain SSH if you lost it, or reflash the last version if things don't work.
Thanks to the following projects/persons:
- utkabobr (https://github.com/utkabobr/DuckPro-Kobra3)
- systemik (https://github.com/systemik/Kobra3-Firmware)
- Anycubic for the cool printer and the few OSS items (https://github.com/ANYCUBIC-3D/Kobra)
- Icon created by Freepik - Flaticon (https://www.flaticon.com/free-icons/snake)
- moosbewohner for Kobra 2 Pro support (https://github.com/moosbewohner/Rinkhals)