# 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
[](https://ko-fi.com/viewitde)
[](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)
---
## ๐ง 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 up -d --build # rebuild & start (after an update)
```
---
## ๐ฉน Troubleshooting