rinkhals-community/Rinkhals.Apps 20260527_01

Rinkhals.Apps 20260527_01

on GitHub

Rinkhals Community Apps

This is the first release from the rinkhals-community fork of Rinkhals.Apps. All apps have been built and tested against the community build infrastructure.

Rinkhals is a custom firmware for the Anycubic Kobra 3 family of 3D printers. It allows side-loading apps to extend your printer with remote access, improved network discovery, alternative slicing interfaces, and more.

Installation

SWU Package (recommended)

1. Download the .swu file matching your printer model:
   • K2 Plus / K3 variants: *-k2p-k3.swu
   • KS1 variants: *-ks1.swu
   • K3 Max variants: *-k3m.swu
2. Rename the file to update.swu
3. Copy it to a FAT32-formatted USB drive inside a folder named aGVscF9zb3Nf
4. Plug the USB drive into your printer
5. Wait for two beeps (the second beep confirms installation is complete)
6. Enable the app via the Rinkhals touch UI, or create the file /useremain/home/rinkhals/apps/<APP_NAME>.enabled
7. Reboot if needed

Manual Installation

1. Connect to your printer via SSH/SFTP
2. Copy the app folder into /useremain/home/rinkhals/apps/
3. Enable the app as described above

Apps Included

Remote Access & Networking

Tailscale (app-tailscale)

Secure, private remote access to your printer via the Tailscale VPN mesh network. Access your printer's web interface, SSH, and other services from anywhere without opening ports on your router. Uses end-to-end encryption and works across NAT and firewalls. After installation, authenticate via the Rinkhals touch UI (QR code) or SSH command line.

Cloudflare Tunnel (app-cloudflare-tunnel)

Exposes your printer's web interface (Mainsail/Fluidd) to the internet through a Cloudflare Tunnel. Requires a free Cloudflare account and your own domain. Strongly recommended to pair with Cloudflare Zero Trust access policies for authentication. You must configure your tunnel token after installation.

OctoEverywhere (app-octoeverywhere)

OctoEverywhere provides free remote access, AI-powered failure detection, real-time print notifications, and live streaming for your printer. After installation, link your printer to your OctoEverywhere account via the QR code shown in the Rinkhals touch UI.

OctoApp Companion (app-octoapp)

Companion service for the OctoApp mobile application, enabling push notifications, remote monitoring, and control of your printer from your phone.

Printer Functionality

Cloud to LAN Bridge (app-cloud2lan-bridge)

Bridges Anycubic cloud messages to LAN mode, allowing you to use most Anycubic cloud features (app control, monitoring) while keeping your printer in LAN mode. Only works when LAN mode is enabled on the printer.

Discovery Helper (app-discovery-helper)

Fixes printer discovery in Anycubic Slicer Next when your network uses IGMP snooping. Some routers/switches filter multicast packets, preventing the slicer from finding your printer on the network. This app sends the necessary IGMP report to join the SSDP multicast group so discovery works reliably.

Klipper - Vanilla (app-vanilla-klipper)

Replaces the Anycubic GoKlipper reimplementation with upstream Klipper. This is experimental and intended for advanced users who want to run stock Klipper firmware on their printer.

NFS Mount (app-nfs-mount)

Replaces local gcode storage with a network NFS share, offloading file I/O from the printer's internal storage. Configurable NFS server IP, port, and share path via the app properties. Useful for users with large gcode libraries or who want centralized file management.

Security & Infrastructure

TLS Add-on / stunnel (app-stunnel)

Adds HTTPS (TLS) endpoints to Rinkhals services using self-signed certificates. Wraps existing HTTP services so you can access them securely:

Note: Your browser will show a certificate warning for self-signed certificates. Review the warning and accept if appropriate.

Remote Debugging (app-remote-debugging)

Provides remote SSH-like access for debugging purposes via ngrok tunneling. Use with extreme caution -- this exposes your printer to the internet. Intended only for developers and troubleshooting. Do not share any connection links or codes unless you fully understand the security implications.

Development

Example App (app-example)

A reference implementation demonstrating the Rinkhals app system. Shows how to implement app.sh (start/stop/status), app.json (manifest with properties), and the various UI property types (text, number, enum, report, QR code). Use this as a starting point when developing your own apps.

Supported Printers

All apps are built for three printer families:

• Anycubic Kobra 2 Plus / Kobra 3 (k2p-k3)
• Anycubic Kobra S1 (ks1)
• Anycubic Kobra 3 Max (k3m)

Prerequisites

• Rinkhals firmware must be installed on your printer before installing any apps
• A FAT32-formatted USB drive for SWU installation

Links

• Rinkhals Firmware
• App Development Guide