Teach your Kobra to speak Moonraker.

Control the Anycubic Kobra X from OrcaSlicer and a full web dashboard, with no Klipper and no Raspberry Pi.

English · Português (Brasil)

_{MoonKobra is a fork of KX-Bridge by viewit.}

---

What it is

The Kobra X speaks Anycubic's own LAN protocol (MQTT). Slicers and tools from the Klipper world speak Moonraker. MoonKobra sits in the middle and translates, so the printer looks like a regular Moonraker host:

OrcaSlicer · Obico · Mobileraker · Home Assistant
            │  HTTP + WebSocket (Moonraker API)
            ▼
       MoonKobra  ── web dashboard on :7125
            │  MQTT over LAN
            ▼
     Kobra X + ACE (4 filament slots)

It runs on any machine on the same network (a PC, a NAS, a home server) as a Docker container, a single binary or plain Python. Nothing is installed on the printer.

Meet Moko. The little cobra is MoonKobra's mascot. On the dashboard, Moko comments on what the printer is doing: heating, leveling, printing, waiting for filament, done, or asleep when the printer is off.

---

Features

Printing

• Start, pause, resume and cancel; temperatures, speed, fans, movement, light.
• "Now" screen: the part in 3D is the progress bar (solid up to the current layer), plus the print phases the printer reports and temperature trends.
• Stopping a print needs a 1.4 s hold, so it never happens by accident.
• Skip objects, camera stream, Anycubic error codes shown as plain sentences.
• Day, Night and Late-night (red) display modes; works on desktop, phone, tablet and inside OrcaSlicer's Device tab.

Filament and ACE

• ACE slots with a profile picker per slot; material and colour are written back to the printer screen.
• Import your own OrcaSlicer filament profiles (ZIP) and match spools tagged with third-party RFID tools.
• Multiple daisy-chained ACE units, and the dryer of each unit.
• Spoolman: assign spools to slots, usage is tracked as you print.
• Brazilian filament profiles ready to import (see below).

Files and history

• G-code browser for uploaded files and for files stored on the printer, with thumbnails, search and bulk delete.
• Print history with a separate log for every print, downloadable as text.

Quote (beta)

• Pick a G-code and get a price: material, ACE purge, power, machine wear, labour, failure reserve, packaging, margin, tax and sales-channel fees (Shopee and Mercado Livre two-tier fees). Coupons, quantity discounts and parts per plate.
• Saved quotes and a customer receipt as an image (WhatsApp), PDF or text. No internal cost or margin appears on the receipt.

Everything else

• Several printers in one instance; add a printer with just its IP (the credentials are fetched from the printer automatically).
• Print notifications through ntfy, Discord, Telegram or any JSON webhook.
• Login with a mandatory password change on first access, API key for slicers, camera-only token for OBS.
• Smart-plug power switch, settings backup and restore.
• UI in Portuguese (Brazil) and English, plus partial German, Spanish, French, Italian and Chinese.

---

Quick start

1. Enable LAN mode on the printer. Printer screen → Settings → Enable LAN mode.

2. Start MoonKobra.

On Windows (easiest, nothing to install):

1. Download MoonKobra-…-windows.exe from the latest release.
2. Put it in a folder of its own, e.g. Documents\MoonKobra. Settings and files are kept in that folder, next to the .exe.
3. Double-click it. If Windows shows "Windows protected your PC", click More info → Run anyway. If the firewall asks, tick Private networks and click Allow.
4. The browser opens on the dashboard by itself. MoonKobra keeps running as an icon in the tray, next to the clock: click it to open the dashboard, right-click → Quit to stop it. A green dot on the icon means the printer is connected, red means it is not. The log is in moonkobra.log, next to the .exe.

With Docker (Linux, NAS, server): Docker builds it from this folder:

git clone https://github.com/clevim/MoonKobra.git
cd MoonKobra
./start.sh

docker compose up -d --build works too.

3. Open the dashboard at http://HOST-IP:7125. The first login is kx / kx123, and you will be asked to choose a new password right away.

4. Add the printer. On first run the dashboard asks only for the printer's IP and the language. More printers are added later in Printers → Add printer. Username, password, device ID and the printer's own TLS certificate are read from the printer automatically. The certificate is saved in config/certs/; delete that folder to fetch it again.

5. Connect OrcaSlicer. Printer → Connection → type Moonraker, host http://HOST-IP:7125 (with http:// and the port). Paste the API key from Settings → API into the API key field. The dashboard shows this walkthrough with your values filled in (also under Settings → API → How to connect OrcaSlicer).

More than one printer? Add it the same way: each one gets its own port (7125, 7126, …).

Other ways to run it

Python directly

pip install -r requirements.txt
python kobrax_moonraker_bridge.py

Single binary (Linux or Windows)

pip install pyinstaller
pyinstaller moonkobra.spec      # result: dist/moonkobra (or moonkobra.exe)

config/ and data/ are created next to the binary, so copying the folder moves the whole installation.

Full stack (Spoolman + self-hosted Obico) docker-compose.stack.yml runs MoonKobra, Spoolman, Obico and moonraker-obico together. The setup steps are in the file's header.

---

Recommended slicer

Plain OrcaSlicer works for slicing and printing. For filament sync per slot (the slicer picking your brand profile instead of Generic PLA), you need an OrcaSlicer build with these pull requests:

• #13372: AMS sync keeps slot positions even with empty slots.
• #13719: vendor + name matching for Moonraker, by @LordGuenni.
• #13315: unique filament_id for user presets, by @mrnoisytiger.

The community build OrcaSlicer-KX already bundles all three.

---

Brazilian filament profiles

profiles/brasil/ has OrcaSlicer profiles for the Kobra X (0.4 nozzle) built from what each manufacturer publishes: 3DFila (132 colours, one profile per colour, with the official colour and the store price), GTMax3D and 3D Lab. Import filamentos-brasil.zip in OrcaSlicer or straight into MoonKobra (Settings → Filament → Import profiles). The Quote tab uses the 3DFila prices automatically. Details in profiles/brasil/README.md.

---

Integrations

• Home Assistant by @gangoke: sensors, controls, light, camera and thumbnail as native entities.
• Obico (self-hosted) through moonraker-obico: time-lapse and WebRTC stream. Failure detection is experimental on the Kobra X (the camera looks from the top, not what the model was trained on).
• Mainsail, Fluidd, Mobileraker: anything that speaks Moonraker can read the printer state and the temperature graph.

These are community projects, not maintained by MoonKobra.

---

Troubleshooting

"Wrong MQTT credentials" on start

Add the printer again with Add printer, or fetch the credentials by hand and restart:

python fetch_credentials.py --ip 192.168.x.x --write-config

Type only the IP, without a port (✗ 192.168.1.102:9883, ✓ 192.168.1.102).

Printer not found

LAN mode must be on (printer screen → Settings), and the printer and MoonKobra must be on the same network.

OrcaSlicer cannot connect

The connection type must be Moonraker (not Bambu or Klipper), the host must include http:// and :7125, and the API key from Settings → API must be filled in.

Docker: permission denied

sudo usermod -aG docker $USER   # then log out and back in

More in the user manual. Developers: see the API reference.

---

Security

• Keep MoonKobra on your local network. Do not expose port 7125 to the internet.
• config/config.ini holds the printer credentials: do not share it.
• These credentials do not give access to any Anycubic cloud service.

---

Credits and license

MoonKobra is released under the GNU General Public License v3.0 (LICENSE). It started as a fork of KX-Bridge by viewit and its contributors; the Anycubic error-code table comes from stribor/anycubic_kobrax (MIT).

The MQTT protocol support is the result of independent reverse engineering for interoperability. MoonKobra ships no Anycubic files: the TLS certificate used to talk to the printer is generated by the printer itself and handed over on the local network. Details in NOTICE.md.

MoonKobra is independent and not affiliated with Anycubic.

_{Moko is asleep. Go print something.}