# KX-Bridge
**Control your Anycubic Kobra X with OrcaSlicer β no Klipper, no Raspberry Pi.**
A Moonraker-compatible bridge that talks directly to the printer.
π©πͺ Deutsche Version Β· πͺπΈ VersiΓ³n espaΓ±ola
[](https://ko-fi.com/viewitde)
[](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
[](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
[](https://www.youtube.com/watch?v=1Ql4wfH27fM)
Like KX-Bridge? A coffee on Ko-fi keeps the project alive. β
---
## β¨ Features
| | |
|---|---|
| π¨οΈ | **Printer control** β start, pause, resume, cancel, temperatures, print speed |
| π | **Live status** β temperature, progress, layers, remaining time, camera stream |
| π¨ | **AMS / multicolor** β filament slots, per-channel remapping, MMU emulation for OrcaSlicer filament sync |
| ποΈ | **GCode browser** β uploaded files with thumbnails, print history, search & filter |
| 𧩠| **Multi-printer** β multiple printers in **one** bridge instance, switch via dropdown |
| β | **Add a printer with one click** β just enter the IP, credentials are imported automatically |
| π | **Self-update** β install new versions directly in the browser |
| π | **OrcaSlicer** β full Moonraker protocol (HTTP + WebSocket), EN/DE UI |
---
## π Quick Start
### 1. Prepare the printer
Enable LAN mode on the Kobra X:
**Printer display β Settings β Enable LAN mode**
### 2. Start the bridge
**Docker (recommended):**
```bash
docker compose up -d
```
**Linux binary (no Docker):**
```bash
chmod +x kx-bridge && ./kx-bridge
```
**Windows EXE (no Docker):**
```
kx-bridge.exe
```
> `config\` and `data\` are created next to the EXE β portable.
> With the Linux and Windows binaries, `config/` and `data/` (settings, SQLite, GCode store)
> live next to the program. Copy the whole folder = move the installation.
**Python directly:**
```bash
pip install -r bridge/requirements.txt
python bridge/kobrax_moonraker_bridge.py
```
### 3. Set up the printer
Open the Web UI: **`http://BRIDGE-IP:7125`**
On first start the **Printers tab** shows *"+ Add printer"* β just enter the printer's IP
address, the rest (username, password, device ID) is fetched from the printer and decrypted
automatically. Done.
> More than one printer? Just click *"+ Add printer"* again β each gets its own port
> (7125, 7126, β¦) and is selectable from the header dropdown.
### 4. Connect OrcaSlicer
Printer β Connection type **Moonraker** β Host: `http://BRIDGE-IP:7125`
> β οΈ Connection type must be **Moonraker** (not "Bambu" or "Klipper").
> Enter the full URL including `http://` and port `:7125` in the host field.
---
## πΊ Video Tutorial
[](https://www.youtube.com/watch?v=1Ql4wfH27fM)
---
## π¨ Recommended Slicer
For the best KX-Bridge experience we offer a **patched OrcaSlicer build** that
bundles three open SoftFever/OrcaSlicer PRs: the Anycubic Kobra X printer
profile, a multicolor G-code fix and β most importantly β a Moonraker/Happy-Hare
filament-sync fix that keeps AMS slot positions intact even with an empty slot.
β **[OrcaSlicer-KX releases](https://gitea.it-drui.de/viewit/OrcaSlicer-KX/releases/latest)** (Linux AppImage + Windows ZIP)
Standard OrcaSlicer also works; the patched build mainly improves AMS handling.
It's a build of [OrcaSlicer](https://github.com/SoftFever/OrcaSlicer) (AGPL-3.0);
source is available via the linked PRs.
---
## π Community & Integrations
- **[Home Assistant integration](https://github.com/gangoke/kobrax-lan-hass-component)**
by [@gangoke](https://github.com/gangoke) β exposes sensors, print controls,
light, camera and the GCode thumbnail as native Home Assistant entities.
> These are **community projects**, not maintained or supported by KX-Bridge.
> For questions or issues, please use the linked repository.
---
## π§ Getting credentials manually
Normally not needed β *"+ Add printer"* does this automatically. If you do need it:
```bash
fetch_credentials --ip 192.168.x.x --write-config
```
Fetches the credentials directly from the printer via HTTP and writes them to `config/config.ini`.
Only the printer IP is required, no slicer.
Alternatively (if the IP is unknown): open AnycubicSlicerNext, connect the printer, then run
`extract_credentials` β outputs username, password, device ID and the printer IP.
> **Downloads:** [Releases](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) β `fetch_credentials` / `extract_credentials` (Linux & Windows)
---
## βοΈ Useful commands
```bash
docker compose logs -f # show logs
docker compose down # stop the bridge
docker compose pull && docker compose up -d # update to the latest published image
docker compose up -d --build # rebuild locally (instead of pulling)
```
---
## π©Ή Troubleshooting