diff --git a/README.de.md b/README.de.md
index ac5d6d3..3b56335 100644
--- a/README.de.md
+++ b/README.de.md
@@ -8,6 +8,8 @@
Eine Moonraker-kompatible Bridge, die direkt mit dem Drucker spricht.
+π¬π§ English version
+
[](https://ko-fi.com/viewitde)
@@ -177,4 +179,4 @@ InteroperabilitΓ€tsforschung gem. Β§69e UrhG β private, nicht-kommerzielle Nut
[](https://ko-fi.com/viewitde)
-
\ No newline at end of file
+
diff --git a/README.md b/README.md
index 9e52026..1c25afc 100644
--- a/README.md
+++ b/README.md
@@ -1,47 +1,94 @@
-

+
-# KX-Bridge β Anycubic Kobra X
+

-**Version:** 0.9.8
+# KX-Bridge
-Control your **Anycubic Kobra X** with OrcaSlicer β no Klipper, no Raspberry Pi.
-KX-Bridge is a Moonraker-compatible bridge that communicates directly with the printer.
+**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. β
+
+
---
-## Quick Start in 3 Steps
+## β¨ Features
-### Step 1 β Prepare the printer
+| | |
+|---|---|
+| π¨οΈ | **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 |
-Enable LAN mode on the Kobra X:
+---
+
+## π Quick Start
+
+### 1. Prepare the printer
+
+Enable LAN mode on the Kobra X:
**Printer display β Settings β Enable LAN mode**
-### Step 2 β Get credentials
-
-The MQTT credentials are printer-specific. Here's how to get them:
-
-1. Open **AnycubicSlicerNext** and connect the printer (wait until status is shown)
-2. Run **`extract_credentials.exe`** (Windows) or **`extract_credentials`** (Linux) β outputs Username, Password, Device ID and printer IP
-3. Note / copy the values
-
-> **Download:** [gitea.it-drui.de/viewit/KX-Bridge-Release/releases](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) β `extract_credentials.exe` (Windows) / `extract_credentials` (Linux) in the release assets
-
-### Step 3 β Start the bridge
+### 2. Start the bridge
+**Docker (recommended):**
```bash
-./start.sh
+docker compose up -d
```
-The script builds the Docker image automatically on first run.
+**Linux binary (no Docker):**
+```bash
+chmod +x kx-bridge && ./kx-bridge
+```
-**Open Web-UI:** `http://BRIDGE-IP:7125`
-β The β menu opens automatically on first start
-β Enter credentials from Step 2 β **Save & Restart**
+**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
-**Connect OrcaSlicer:**
Printer β Connection type **Moonraker** β Host: `http://BRIDGE-IP:7125`
-> **Important:** Connection type must be **Moonraker** (not "Bambu" or "Klipper").
+> β οΈ Connection type must be **Moonraker** (not "Bambu" or "Klipper").
> Enter the full URL including `http://` and port `:7125` in the host field.
---
@@ -52,98 +99,84 @@ Printer β Connection type **Moonraker** β Host: `http://BRIDGE-IP:7125`
---
-## β οΈ Upgrading from 0.9.1 or earlier
+## π§ Getting credentials manually
-Starting with **0.9.2**, KX-Bridge stores settings in `config/config.ini` instead of `.env`.
+Normally not needed β *"+ Add printer"* does this automatically. If you do need it:
-**Migration is automatic** β no manual action required:
-- On first start after upgrade, the bridge reads your existing `.env` and creates `config/config.ini` automatically
-- Settings now survive `docker-compose restart` and future updates
-- The `.env` file stays mounted read-only as a migration source β you can keep it in place
-- If you want to create a `config.ini` manually: copy `config/config.ini.example`
-
----
-
-## What's supported?
-
-| Feature | Details |
-|---------|---------|
-| Printer status | Temperature, progress, state, remaining time |
-| Print control | Start, pause, resume, cancel |
-| Temperature control | Nozzle and bed during print |
-| Print speed | Silent / Normal / Sport |
-| AMS filament change | Load / unload filament |
-| Light & fan | Print light and fan speed |
-| Web-UI | Dashboard, motion control, camera view |
-| Self-update | Install new versions directly in the browser |
-| OrcaSlicer | Moonraker protocol (HTTP + WebSocket) |
-
----
-
-## Alternatives to Docker
-
-**Linux binary** (no Docker needed):
```bash
-chmod +x kx-bridge
-./kx-bridge
+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.
-**Python directly:**
-```bash
-pip install aiohttp
-python bridge/kobrax_moonraker_bridge.py
-```
+Alternatively (if the IP is unknown): open AnycubicSlicerNext, connect the printer, then run
+`extract_credentials` β outputs username, password, device ID and the printer IP.
-Web-UI available at `http://localhost:7125` β the β menu guides through initial setup.
+> **Downloads:** [Releases](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) β `fetch_credentials` / `extract_credentials` (Linux & Windows)
---
-## Useful commands
+## βοΈ Useful commands
```bash
-# Show logs
-docker-compose logs -f
-
-# Stop bridge
-docker-compose down
-
-# Restart bridge (after update)
-./start.sh
+docker compose logs -f # show logs
+docker compose down # stop the bridge
+docker compose up -d --build # rebuild & start (after an update)
```
---
-## Troubleshooting
+## π©Ή Troubleshooting
-**"Wrong MQTT credentials"** on start:
-- Restart AnycubicSlicerNext, reconnect the printer, run `extract_credentials` again
+
+"Wrong MQTT credentials" on start
+
+- Re-add the printer via *"+ Add printer"*, or run
+ `fetch_credentials --ip --write-config` and restart the bridge
- Enter only the IP address, no port (β `192.168.1.102:9883` β β `192.168.1.102`)
+
+
+
+Printer not found / no LAN mode
-**Printer not found / no LAN mode:**
- On the printer display: Settings β Enable LAN mode
- Printer and bridge must be on the same network
+
+
+
+Docker: Permission denied
-**Docker: Permission denied:**
```bash
-sudo usermod -aG docker $USER # then log out and back in
+sudo usermod -aG docker $USER # then log out and back in
```
+
+
+
+Upgrading from 0.9.1 or earlier
+
+Starting with 0.9.2, KX-Bridge stores settings in `config/config.ini` instead of `.env`.
+Migration runs automatically on first start after the upgrade β no action required.
+
---
-## Security
+## π Security
-- The bridge is accessible on the local network at `http://:7125` β do not expose to the internet
+- The bridge is reachable on the local network at `http://:7125` β **do not** expose it to the internet
- `config/config.ini` contains printer credentials β do not share publicly
-- Credentials do not grant access to Anycubic cloud services
+- The credentials do **not** grant access to Anycubic cloud services
---
-## License
+## π License
Interoperability research under Β§69e UrhG β private, non-commercial use only.
-
-
-
-
-
+
+
+
+**If KX-Bridge helps you, the project appreciates your support:**
+
+[](https://ko-fi.com/viewitde)
+
+