nightly: 0.9.27-nightly2

- Workflows: docker-publish.yml → nightly.yml + release.yml + pr-check.yml
  (nightly: Branch-Push + Cron 02:00, release: v*-Tag, pr-check: lint+tests)
- Issue-Templates: bug_report.md + feature_request.md (englisch)
- PR-Template: pull_request_template.md (englisch)
- Claude-Agenten: reviewer, changelog, test-writer, nightly-prep,
  docker-check, moonraker-debug + settings.json
- agents.md: Agenten-Übersicht im Repo-Root
- .gitignore: .runner-token + secrets/ ausgeschlossen

.claude/agents/changelog.md

@@ -0,0 +1,31 @@
+---
+name: KX-Bridge Changelog
+description: Generiert einen CHANGELOG.md Eintrag aus Git-Commits seit dem letzten Tag.
+tools:
+  - run_command
+  - read_file
+  - write_file
+---
+
+Du generierst CHANGELOG.md Einträge für KX-Bridge.
+
+Vorgehen:
+1. Führe aus: `git log $(git describe --tags --abbrev=0)..HEAD --oneline`
+2. Gruppiere Commits nach Präfix: feat → Neu, fix → Behoben, chore/refactor/docs → Geändert
+3. Frage nach der Versionsnummer (SemVer: feat→MINOR, fix→PATCH, breaking→MAJOR)
+4. Schreibe den Abschnitt im Format:
+
+```
+## [VERSION] - DATUM
+
+### Neu
+- ...
+
+### Behoben
+- ...
+
+### Geändert
+- ...
+```
+
+5. Füge den Abschnitt am Anfang der bestehenden CHANGELOG.md ein, ohne vorhandene Einträge zu ändern.

.claude/agents/docker-check.md

@@ -0,0 +1,32 @@
+---
+name: KX-Bridge Docker Check
+description: Prüft Dockerfile, docker-compose und das gebaute Image auf häufige Probleme.
+tools:
+  - read_file
+  - run_command
+  - search_files
+---
+
+Du prüfst die Docker-Konfiguration von KX-Bridge.
+
+**Dockerfile:**
+- Base-Image aktuell? (`python:3.11-slim` oder neuer)
+- `.dockerignore` vorhanden und vollständig?
+- Keine Secrets oder Zertifikate im Image (`anycubic_slicer.crt/.key` darf NICHT eingebettet sein)
+- Healthcheck vorhanden?
+- Kein `COPY . .` ohne `.dockerignore`
+
+**docker-compose.yml:**
+- Port 7125 korrekt gemappt
+- Config-Volume gemountet (`/app/config`)
+- `restart: unless-stopped` gesetzt
+- Logging-Limits konfiguriert (`max-size`, `max-file`)
+
+**Image-Check (falls lokal vorhanden):**
+```bash
+docker image inspect gitea.it-drui.de/viewit/kx-bridge:nightly
+```
+- Image-Größe sinnvoll (< 500MB)?
+- Keine privaten Keys eingebettet: `docker history --no-trunc`
+
+Berichte nach Schweregrad: Kritisch / Warnung / Hinweis.

.claude/agents/moonraker-debug.md

@@ -0,0 +1,23 @@
+---
+name: KX-Bridge Moonraker Debug
+description: Analysiert Moonraker/Klipper Logs und KX-Bridge Ausgaben auf Fehlerursachen.
+tools:
+  - read_file
+  - search_files
+---
+
+Du analysierst Logs für KX-Bridge im Kontext Moonraker/Klipper/AFC.
+
+**Bekannte Problemquellen:**
+- AFC lane_data Indizierung: korrekt ist `lane1`–`lane4` (flat), nicht Slot 0–3
+- `filament_id` muss als String übertragen werden, nicht als Integer
+- Moonraker WebSocket trennt bei Inaktivität → keep-alive prüfen
+- OrcaSlicer sendet Bambu MQTT Format → KX-Bridge muss übersetzen
+- ACE 2 Pro meldet Fehler wenn Lane leer aber als belegt markiert ist
+- MQTT mTLS: Zertifikat muss neben dem Binary liegen (`anycubic_slicer.crt/.key`)
+
+**Bei einem Log:**
+1. Identifiziere den **ersten** Fehler (nicht den letzten Symptom)
+2. Zeige den relevanten Log-Kontext (±10 Zeilen um den Fehler)
+3. Nenne die wahrscheinliche Ursache
+4. Schlage einen konkreten Fix vor (Datei + Funktion wenn möglich)

.claude/agents/nightly-prep.md

@@ -0,0 +1,25 @@
+---
+name: KX-Bridge Nightly Prep
+description: Bereitet den PR von nightly nach main vor. Prüft ob alle Voraussetzungen für ein Stable Release erfüllt sind.
+tools:
+  - run_command
+  - read_file
+---
+
+Du bereitest einen nightly → main Merge für KX-Bridge vor.
+
+Führe folgende Checks aus und berichte:
+
+1. `git log main..nightly --oneline` → alle Commits die noch nicht in main sind
+2. `git diff main..nightly -- CHANGELOG.md` → ist CHANGELOG.md für alle Änderungen aktualisiert?
+3. Prüfe ob `tests/` alle geänderten Module abdeckt
+4. Prüfe ob Dockerfile ein aktuelles Base-Image verwendet
+5. Schlage eine SemVer-Versionsnummer vor:
+   - `feat:` Commits → MINOR erhöhen
+   - `fix:` Commits → PATCH erhöhen
+   - Breaking Change im Commit-Body → MAJOR erhöhen
+
+Abschlussbericht:
+- ✅ Bereit für Release
+- ⚠️ Offen: [Liste]
+- ❌ Blockiert durch: [Grund]

.claude/agents/reviewer.md

@@ -0,0 +1,24 @@
+---
+name: KX-Bridge Reviewer
+description: Reviewt geänderte Dateien vor einem PR auf nightly. Prüft Logik, Fehlerbehandlung, Moonraker-Kompatibilität und Stil.
+tools:
+  - read_file
+  - list_directory
+  - search_files
+---
+
+Du bist Code-Reviewer für KX-Bridge — eine Python-Bridge zwischen OrcaSlicer und Moonraker/Klipper für den Anycubic Kobra X.
+
+Beim Review prüfst du:
+- Korrekte Fehlerbehandlung bei Moonraker HTTP/MQTT Calls (keine unbehandelten Exceptions)
+- Keine hardcodierten IPs oder Ports (müssen aus config.ini kommen)
+- Thread-Sicherheit bei parallelen Moonraker-Abfragen (asyncio korrekt verwendet)
+- AFC lane_data Struktur: flache Indizierung lane1–lane4, kein Slot-Mapping 0–3
+- Kein `print()` statt `logging` (außer in CLI-Hilfsfunktionen)
+- Typ-Annotationen vorhanden, Python 3.8+ kompatibel (kein `X | Y` Syntax)
+- Tests für neue öffentliche Funktionen vorhanden
+
+Ausgabeformat:
+1. **Kritische Fehler** — blockieren den Merge
+2. **Warnungen** — sollten vor Merge behoben werden
+3. **Hinweise** — optional, für zukünftige Verbesserungen

.claude/agents/test-writer.md

@@ -0,0 +1,26 @@
+---
+name: KX-Bridge Test Writer
+description: Leitet pytest-Tests aus geänderten oder neuen Python-Dateien ab.
+tools:
+  - read_file
+  - write_file
+  - list_directory
+  - search_files
+---
+
+Du schreibst pytest-Tests für KX-Bridge.
+
+Kontext:
+- Moonraker API läuft auf Port 7125 (HTTP + WebSocket)
+- AFC lane_data: flache Indizierung lane1–lane4
+- Externe HTTP-Calls zu Moonraker werden mit `unittest.mock` gemockt
+- Python 3.8+ Kompatibilität (kein `X | Y` Union-Syntax)
+
+Für jede zu testende Funktion schreibst du:
+1. Happy Path (Normalfall mit validen Eingaben)
+2. Fehlerfall (Moonraker nicht erreichbar, Timeout, falsche Antwort)
+3. Grenzwerte (leere lane_data, ungültige filament_id, None-Werte)
+
+Dateiname: `tests/test_<modulname>.py`
+Verwende pytest-Fixtures für Moonraker-Mock-Responses.
+Keine echten Netzwerkaufrufe in Tests.

.claude/settings.json

@@ -0,0 +1,12 @@
+{
+  "project": "KX-Bridge",
+  "language": "de",
+  "defaultAgent": "reviewer",
+  "context": {
+    "repoBase": "gitea.it-drui.de/viewit/KX-Bridge-Release",
+    "defaultBranch": "nightly",
+    "stableBranch": "main",
+    "registry": "gitea.it-drui.de/viewit/kx-bridge",
+    "moonrakerPort": 7125
+  }
+}

.gitea/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Report a bug in KX-Bridge
+labels: bug
+---
+
+## Description
+<!-- What is happening? -->
+
+## Steps to Reproduce
+1.
+2.
+3.
+
+## Expected Behavior
+
+## Actual Behavior
+
+## Environment
+- KX-Bridge Version:
+- OrcaSlicer Version:
+- Moonraker/Klipper Version:
+- Operating System:
+- Installation: Docker / Binary
+
+## Logs
+```
+<!-- docker logs kx-bridge --tail 50 -->
+```

.gitea/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,14 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+labels: enhancement
+---
+
+## Description
+<!-- What should be added or improved? -->
+
+## Motivation
+<!-- Why is this useful? What problem does it solve? -->
+
+## Proposed Implementation
+<!-- Optional: How could this be implemented technically? -->

.gitea/pull_request_template.md

@@ -0,0 +1,21 @@
+## Description
+<!-- What does this PR change? -->
+
+## Related Issue
+Closes #
+
+## Type
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Documentation
+- [ ] Refactoring
+
+## Tested with
+- OrcaSlicer Version:
+- Printer:
+- Moonraker/Klipper Version:
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] CHANGELOG.md updated
+- [ ] No debug code included

.gitea/workflows/nightly.yml

@@ -0,0 +1,61 @@
+name: Nightly Build
+
+on:
+  push:
+    branches:
+      - nightly
+    paths:
+      - '**.py'
+      - 'Dockerfile'
+      - 'requirements.txt'
+      - 'web/**'
+      - 'data/**'
+  schedule:
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: self-hosted
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          clean: true
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Gitea registry
+        uses: docker/login-action@v3
+        with:
+          registry: gitea.it-drui.de
+          username: ${{ secrets.REGISTRY_USER }}
+          password: ${{ secrets.REGISTRY_TOKEN }}
+
+      - name: Build & push (amd64 + arm64)
+        run: |
+          DATE=$(date +%Y%m%d)
+          TAGS="gitea.it-drui.de/viewit/kx-bridge:nightly"
+          TAGS="$TAGS,gitea.it-drui.de/viewit/kx-bridge:nightly-$DATE"
+          docker buildx build \
+            --platform linux/amd64,linux/arm64 \
+            --push \
+            --provenance=false \
+            --no-cache \
+            $(echo "$TAGS" | tr ',' '\n' | sed 's/^/-t /') \
+            .
+
+      - name: Set nightly tag
+        env:
+          GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+        run: |
+          DATE=$(date +%Y%m%d)
+          TAG="nightly-$DATE"
+          git config user.name "gitea-actions"
+          git config user.email "actions@it-drui.de"
+          git tag -f "$TAG"
+          git push origin "$TAG" --force

.gitea/workflows/pr-check.yml

@@ -0,0 +1,26 @@
+name: PR Check
+
+on:
+  pull_request:
+    branches:
+      - nightly
+
+jobs:
+  lint-and-test:
+    runs-on: self-hosted
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Dependencies installieren
+        run: pip3 install -r requirements.txt
+
+      - name: Lint
+        run: |
+          pip3 install flake8
+          flake8 *.py --max-line-length=120 --extend-ignore=E501
+
+      - name: Tests
+        run: |
+          pip3 install pytest
+          pytest tests/ -v
+        if: ${{ hashFiles('tests/') != '' }}

.gitea/workflows/release.yml

@@ -0,0 +1,58 @@
+name: Stable Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  release:
+    runs-on: self-hosted
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          clean: true
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Gitea registry
+        uses: docker/login-action@v3
+        with:
+          registry: gitea.it-drui.de
+          username: ${{ secrets.REGISTRY_USER }}
+          password: ${{ secrets.REGISTRY_TOKEN }}
+
+      - name: Build & push (amd64 + arm64)
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/}"
+          docker buildx build \
+            --platform linux/amd64,linux/arm64 \
+            --push \
+            --provenance=false \
+            --no-cache \
+            -t "gitea.it-drui.de/viewit/kx-bridge:latest" \
+            -t "gitea.it-drui.de/viewit/kx-bridge:${VERSION}" \
+            .
+
+      - name: Create Gitea Release
+        env:
+          GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+        run: |
+          VERSION="${GITHUB_REF#refs/tags/}"
+          CHANGELOG=$(awk "/^## \[${VERSION}\]/{found=1; next} found && /^## \[/{exit} found{print}" CHANGELOG.md || echo "")
+          curl -s -X POST \
+            -H "Authorization: token ${GITEA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases" \
+            -d "{
+              \"tag_name\": \"${VERSION}\",
+              \"name\": \"KX-Bridge ${VERSION}\",
+              \"body\": $(echo "$CHANGELOG" | python3 -c 'import sys,json; print(json.dumps(sys.stdin.read()))'),
+              \"draft\": false,
+              \"prerelease\": false
+            }"

.gitignore

@@ -17,3 +17,8 @@ config/*.ini
 data/
 
 !data/orca_filaments.json
+
+# Sensitive files — never commit
+.runner-token
+secrets/
+*.token

.runner-token

@@ -1 +0,0 @@
-GITEA_RUNNER_TOKEN=YF9I7H3BI5ovPnMC7iU2I86Hga8dcWUakqH9qT85

CONTRIBUTING.md

@@ -0,0 +1,102 @@
+# Contributing to KX-Bridge
+
+Thanks for taking the time to contribute! Here's everything you need to know.
+
+---
+
+## How to report a bug or request a feature
+
+Use the issue tracker:
+
+- **Bug:** [New Bug Report](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues/new?template=bug_report.md)
+- **Feature:** [New Feature Request](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues/new?template=feature_request.md)
+
+Please fill in the template — especially the **KX-Bridge version** and **logs**.  
+Issues without version info are hard to debug.
+
+---
+
+## How to submit a Pull Request
+
+### 1. Fork the repository
+
+Click **Fork** at the top of this page.  
+You now have your own copy at `gitea.it-drui.de/your-username/KX-Bridge-Release`.
+
+### 2. Clone your fork
+
+```bash
+git clone https://gitea.it-drui.de/your-username/KX-Bridge-Release.git
+cd KX-Bridge-Release
+```
+
+### 3. Create a branch
+
+Always branch off `nightly`:
+
+```bash
+git checkout nightly
+git checkout -b feature/my-feature   # or fix/my-fix
+```
+
+### 4. Make your changes
+
+- Test your changes locally with Docker:
+  ```bash
+  docker build -t kx-bridge:dev .
+  docker run -p 7125:7125 -v ./config:/app/config kx-bridge:dev
+  ```
+- No debug `print()` statements — use `logging`
+- Keep commits focused; one thing per commit
+
+### 5. Push and open a PR
+
+```bash
+git push origin feature/my-feature
+```
+
+Gitea will show a banner — click **"Create Pull Request"**.  
+The PR template will be pre-filled. Set the target branch to **`nightly`**.
+
+---
+
+## Branch model
+
+```
+main      ← stable releases only (merged by maintainer)
+nightly   ← integration branch — PRs go here
+feature/* ← your feature branch (in your fork)
+fix/*     ← your bugfix branch (in your fork)
+```
+
+Your PR always targets `nightly`. The maintainer periodically merges `nightly → main` for a new stable release.
+
+---
+
+## Commit style
+
+Use conventional commit prefixes:
+
+| Prefix | When |
+|---|---|
+| `feat:` | new feature |
+| `fix:` | bug fix |
+| `docs:` | documentation only |
+| `chore:` | maintenance, dependencies |
+| `refactor:` | code change without new feature or fix |
+
+Example: `fix: prevent crash when printer is offline during startup`
+
+---
+
+## Language
+
+- **Code and comments:** English
+- **Issue comments:** match the language of the issue (if someone writes in German, reply in German)
+- **Commit messages:** English
+
+---
+
+## Questions?
+
+Open a [Discussion](https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues) or leave a comment on the relevant issue.

README.es.md

@@ -14,6 +14,15 @@ ninguna está oficialmente probada ni soportada. Se agradece el feedback.</sub>
 
 <sub>🇬🇧 <a href="README.md">English version</a>  ·  🇩🇪 <a href="README.de.md">Deutsche Version</a></sub>
 
+</div>
+
+> [!CAUTION]
+> **Trabajos de mantenimiento en curso esta semana** — Estamos reestructurando el repositorio (modelo de ramas, flujos CI, proceso de contribución). Es posible que notes cambios en los nombres de ramas, plantillas de PR y la forma en que se publican las versiones. Pedimos disculpas por los inconvenientes. El manejo, el flujo de trabajo y la mantenibilidad a largo plazo mejorarán significativamente como resultado.
+>
+> 👉 ¿Quieres contribuir? Por favor lee primero [CONTRIBUTING.md](CONTRIBUTING.md).
+
+<div align="center">
+
 <br>
 
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-Apoya%20este%20proyecto-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/viewitde)
@@ -130,11 +139,6 @@ Impresora → Tipo de conexión **Moonraker** → Host: `http://IP-DEL-PUENTE:71
 
 ---
 
-## 📺 Vídeo tutorial
-
-[![Configuración y uso de KX-Bridge](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
-
----
 
 ## 🎨 Slicer recomendado
 

VERSION

@@ -1 +1 @@
-0.9.27-nightly3
+0.9.27-nightly2

agents.md

@@ -0,0 +1,31 @@
+# KX-Bridge Claude Agents
+
+## Available Agents
+
+| Agent | File | When to use |
+|---|---|---|
+| Reviewer | `.claude/agents/reviewer.md` | Before every PR — checks logic, error handling, Moonraker compatibility |
+| Changelog | `.claude/agents/changelog.md` | After merge to nightly — generates CHANGELOG.md entry from commits |
+| Test Writer | `.claude/agents/test-writer.md` | When adding new functions — derives pytest tests |
+| Nightly Prep | `.claude/agents/nightly-prep.md` | Before a release — checks readiness of nightly → main merge |
+| Docker Check | `.claude/agents/docker-check.md` | Before image push — validates Dockerfile and compose config |
+| Moonraker Debug | `.claude/agents/moonraker-debug.md` | On runtime errors — analyzes Moonraker/Klipper logs |
+
+## Usage
+
+In VS Code with Claude Code extension:
+```
+@reviewer     → code review of current changes
+@changelog    → generate CHANGELOG entry
+@test-writer  → write tests for changed files
+@nightly-prep → check release readiness
+@docker-check → validate Docker config
+@moonraker-debug → analyze logs
+```
+
+## Context
+
+- Moonraker API: Port 7125
+- AFC lane_data: flat indexing lane1–lane4
+- Registry: `gitea.it-drui.de/viewit/kx-bridge`
+- Default PR target: `nightly`

docker-compose-KX.yml

@@ -0,0 +1,210 @@
+# KobraX Full Stack — KX-Bridge + Obico Self-Hosted + Spoolman
+#
+# Für Portainer: Stack → Add Stack → Upload → diese Datei wählen
+#
+# Voraussetzung: Obico-Images einmalig in Gitea-Registry pushen:
+#   docker tag obico-server-web:latest    gitea.it-drui.de/viewit/obico-web:latest
+#   docker tag obico-server-ml_api:latest gitea.it-drui.de/viewit/obico-ml:latest
+#   docker tag obico-server-tasks:latest  gitea.it-drui.de/viewit/obico-tasks:latest
+#   docker push gitea.it-drui.de/viewit/obico-web:latest
+#   docker push gitea.it-drui.de/viewit/obico-ml:latest
+#   docker push gitea.it-drui.de/viewit/obico-tasks:latest
+#
+# Persistente Daten: /mnt/dockerdata/KobraXStack/<service>/
+#
+# Ports:
+#   7125  — KX-Bridge  (Moonraker-API)
+#   3334  — Obico      (Web-UI)
+#   7912  — Spoolman   (Web-UI)
+#
+# Obico Admin-Account nach dem ersten Start:
+#   docker exec obico-web python manage.py createsuperuser
+
+x-obico-base: &obico-base
+  restart: unless-stopped
+  volumes:
+    - /mnt/dockerdata/KobraXStack/obico/data:/data
+    - /mnt/dockerdata/KobraXStack/obico/frontend:/frontend
+  depends_on:
+    - obico-redis
+  environment:
+    DEBUG: "False"
+    REDIS_URL: "redis://obico-redis:6379"
+    DATABASE_URL: "sqlite:////data/db.sqlite3"
+    INTERNAL_MEDIA_HOST: "http://obico-web:3334"
+    ML_API_HOST: "http://obico-ml:3333"
+    ACCOUNT_ALLOW_SIGN_UP: "False"
+    SITE_USES_HTTPS: "False"
+    SITE_IS_PUBLIC: "False"
+    DJANGO_SECRET_KEY: "change-me-to-a-random-secret-key-before-use"
+    WEBPACK_LOADER_ENABLED: "False"
+  networks:
+    - kobrax-stack
+
+services:
+
+  # ── KX-Bridge ───────────────────────────────────────────────
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:latest
+    container_name: kx-bridge
+    restart: unless-stopped
+    ports:
+      - "7125:7125"
+    volumes:
+      - /mnt/dockerdata/KobraXStack/kx-bridge/config:/app/config
+      - /mnt/dockerdata/KobraXStack/kx-bridge/data:/app/data
+    networks:
+      - kobrax-stack
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Spoolman ────────────────────────────────────────────────
+  spoolman:
+    image: ghcr.io/donkie/spoolman:latest
+    container_name: spoolman
+    restart: unless-stopped
+    ports:
+      - "7912:8000"
+    volumes:
+      - /mnt/dockerdata/KobraXStack/spoolman:/home/app/.local/share/spoolman
+    networks:
+      - kobrax-stack
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Obico Redis ─────────────────────────────────────────────
+  obico-redis:
+    image: redis:7.2-alpine
+    container_name: obico-redis
+    restart: unless-stopped
+    volumes:
+      - /mnt/dockerdata/KobraXStack/obico/redis:/data
+    networks:
+      - kobrax-stack
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      start_period: 10s
+      interval: 15s
+      timeout: 5s
+      retries: 10
+    logging:
+      driver: json-file
+      options:
+        max-size: "5m"
+        max-file: "2"
+
+  # ── Obico ML API ────────────────────────────────────────────
+  obico-ml:
+    image: gitea.it-drui.de/viewit/obico-ml:latest
+    container_name: obico-ml
+    restart: unless-stopped
+    command: bash -c "gunicorn --bind 0.0.0.0:3333 --workers 1 wsgi"
+    working_dir: /app
+    environment:
+      DEBUG: "False"
+      FLASK_APP: "server.py"
+    networks:
+      - kobrax-stack
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q --spider http://127.0.0.1:3333/hc/ || exit 1"]
+      start_period: 30s
+      interval: 30s
+      timeout: 10s
+      retries: 3
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Obico Web ───────────────────────────────────────────────
+  obico-web:
+    <<: *obico-base
+    image: gitea.it-drui.de/viewit/obico-web:latest
+    container_name: obico-web
+    ports:
+      - "3334:3334"
+    depends_on:
+      - obico-ml
+      - obico-redis
+    command: >
+      sh -c 'python manage.py migrate &&
+             python manage.py shell -c "from django.contrib.sites.models import Site; s=Site.objects.first(); s.domain=\"192.168.178.204:3334\"; s.name=\"Obico\"; s.save()" &&
+             python manage.py collectstatic --noinput &&
+             daphne -b 0.0.0.0 -p 3334 config.routing:application'
+    healthcheck:
+      test: ["CMD-SHELL", "wget -q --spider http://127.0.0.1:3334/hc/ || exit 1"]
+      start_period: 60s
+      interval: 90s
+      timeout: 20s
+      retries: 3
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── Obico Tasks (Celery) ────────────────────────────────────
+  obico-tasks:
+    <<: *obico-base
+    image: gitea.it-drui.de/viewit/obico-tasks:latest
+    container_name: obico-tasks
+    command: sh -c "celery -A config worker --beat -l info -c 2 -Q realtime,celery"
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+  # ── moonraker-obico Plugin ──────────────────────────────────
+  # Verbindet KX-Bridge mit dem Obico-Server (Spaghetti-Detektion, Remote-UI)
+  # Voraussetzung: /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg
+  # muss existieren und einen gültigen auth_token enthalten.
+  #
+  # Token holen (nach erstem obico-web Start):
+  #   docker exec obico-web python manage.py shell -c "
+  #   from app.models import OneTimeVerificationCode, User
+  #   from django.utils import timezone; from datetime import timedelta; import random
+  #   u = User.objects.first()
+  #   c = OneTimeVerificationCode.objects.create(user=u, code='%06d' % random.randint(100000,999999), expired_at=timezone.now()+timedelta(hours=2))
+  #   print('CODE:', c.code)"
+  #   curl -X POST 'http://localhost:3334/api/v1/octo/verify/?code=<CODE>'
+  #   → printer.auth_token aus der Antwort in die cfg eintragen
+  moonraker-obico:
+    image: gitea.it-drui.de/viewit/moonraker-obico:latest
+    container_name: moonraker-obico
+    restart: unless-stopped
+    network_mode: host
+    volumes:
+      - /mnt/dockerdata/KobraXStack/moonraker-obico:/opt/printer_data/config
+      - /mnt/dockerdata/KobraXStack/moonraker-obico/logs:/opt/printer_data/logs
+    command: ["-c", "/opt/printer_data/config/moonraker-obico.cfg"]
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+networks:
+  kobrax-stack:
+    driver: bridge
+
+# Verzeichnisse müssen auf dem Host existieren:
+# mkdir -p /mnt/dockerdata/KobraXStack/kx-bridge/config \
+#           /mnt/dockerdata/KobraXStack/kx-bridge/data \
+#           /mnt/dockerdata/KobraXStack/spoolman \
+#           /mnt/dockerdata/KobraXStack/obico/data \
+#           /mnt/dockerdata/KobraXStack/obico/frontend \
+#           /mnt/dockerdata/KobraXStack/obico/redis \
+#           /mnt/dockerdata/KobraXStack/moonraker-obico/logs
+# Spoolman benötigt UID/GID 1000:
+# sudo chown -R 1000:1000 /mnt/dockerdata/KobraXStack/spoolman
+#
+# moonraker-obico Config anlegen (auth_token nach Obico-Setup eintragen):
+# cp /path/to/moonraker-obico.cfg.example /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg

docker-compose.nightly.yml

@@ -0,0 +1,3 @@
+services:
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:nightly

docker-compose.portainer-nightly.yml

@@ -0,0 +1,25 @@
+# KX-Bridge Nightly — Portainer Stack
+#
+# Paste this into Portainer → Stacks → Add stack → Web editor
+#
+# Uses the nightly build — may be unstable, for testing new features early.
+# For production use, see docker-compose.portainer.yml (:latest).
+
+services:
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:nightly
+    volumes:
+      - /mnt/dockerdata/kx-nightly/config:/app/config
+      - /mnt/dockerdata/kx-nightly/data:/app/data
+    ports:
+      # Port 7125 = first printer. Add 7126, 7127, … for each additional printer.
+      - "7125:7125"
+    restart: unless-stopped
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+# Verzeichnisse müssen auf dem Host existieren:
+# mkdir -p /mnt/dockerdata/kx-nightly/config /mnt/dockerdata/kx-nightly/data

kobrax_moonraker_bridge.py

@@ -602,23 +602,10 @@ class CameraCache:
         self._task_jpeg: "asyncio.Task | None" = None
         self._task_h264: "asyncio.Task | None" = None
         self._lock = asyncio.Lock()
-        self._fail_count_jpeg: int = 0
-        self._fail_count_h264: int = 0
 
     def set_url(self, url: str):
         self._url = url
 
-    def reset(self):
-        """Backoff-Zähler zurücksetzen und laufende ffmpeg-Prozesse killen."""
-        self._fail_count_jpeg = 0
-        self._fail_count_h264 = 0
-        for proc in (self._proc_jpeg, self._proc_h264):
-            if proc is not None:
-                try:
-                    proc.kill()
-                except Exception:
-                    pass
-
     async def ensure_running(self):
         if self._proc_jpeg is None or self._proc_jpeg.returncode is not None:
             self._task_jpeg = asyncio.create_task(self._run_jpeg_loop())
@@ -642,13 +629,13 @@ class CameraCache:
                 continue
             try:
                 self._proc_jpeg = await asyncio.create_subprocess_exec(
-                    _find_ffmpeg(), "-loglevel", "warning",
+                    _find_ffmpeg(), "-loglevel", "quiet",
                     *self._input_args(url), "-i", url,
                     "-vf", "fps=2",
                     "-f", "image2pipe", "-vcodec", "mjpeg", "-q:v", "3",
                     "-flush_packets", "1", "pipe:1",
                     stdout=asyncio.subprocess.PIPE,
-                    stderr=asyncio.subprocess.PIPE,
+                    stderr=asyncio.subprocess.DEVNULL,
                 )
             except Exception as e:
                 log.warning(f"CameraCache: ffmpeg-jpeg start fehlgeschlagen: {e}")
@@ -656,7 +643,6 @@ class CameraCache:
                 continue
 
             buf = b""
-            rc = None
             try:
                 while True:
                     chunk = await self._proc_jpeg.stdout.read(self.TS_CHUNK)
@@ -690,23 +676,8 @@ class CameraCache:
                         await self._proc_jpeg.wait()
                     except Exception:
                         pass
-                    rc = self._proc_jpeg.returncode
-                    if rc:
-                        try:
-                            err = await self._proc_jpeg.stderr.read(500)
-                            if err:
-                                log.warning(f"CameraCache: ffmpeg-jpeg stderr: {err.decode(errors='replace').strip()}")
-                        except Exception:
-                            pass
                 self._proc_jpeg = None
-            if rc:
-                self._fail_count_jpeg += 1
-                delay = min(2.0 * (2 ** self._fail_count_jpeg), 300.0)
-                log.warning(f"CameraCache: ffmpeg-jpeg exit {rc}, retry in {delay:.0f}s (Versuch {self._fail_count_jpeg})")
-                await asyncio.sleep(delay)
-            else:
-                self._fail_count_jpeg = 0
-                await asyncio.sleep(2.0)
+            await asyncio.sleep(2.0)  # restart delay
 
     async def _run_h264_loop(self):
         """Hält einen ffmpeg-Prozess am Leben der MPEG-TS an alle Subscriber fanoutet."""
@@ -717,19 +688,18 @@ class CameraCache:
                 continue
             try:
                 self._proc_h264 = await asyncio.create_subprocess_exec(
-                    _find_ffmpeg(), "-loglevel", "warning",
+                    _find_ffmpeg(), "-loglevel", "quiet",
                     *self._input_args(url), "-i", url,
                     "-c:v", "copy", "-an",
                     "-f", "mpegts", "pipe:1",
                     stdout=asyncio.subprocess.PIPE,
-                    stderr=asyncio.subprocess.PIPE,
+                    stderr=asyncio.subprocess.DEVNULL,
                 )
             except Exception as e:
                 log.warning(f"CameraCache: ffmpeg-h264 start fehlgeschlagen: {e}")
                 await asyncio.sleep(3.0)
                 continue
 
-            rc = None
             try:
                 while True:
                     chunk = await self._proc_h264.stdout.read(self.TS_CHUNK)
@@ -759,23 +729,8 @@ class CameraCache:
                         await self._proc_h264.wait()
                     except Exception:
                         pass
-                    rc = self._proc_h264.returncode
-                    if rc:
-                        try:
-                            err = await self._proc_h264.stderr.read(500)
-                            if err:
-                                log.warning(f"CameraCache: ffmpeg-h264 stderr: {err.decode(errors='replace').strip()}")
-                        except Exception:
-                            pass
                 self._proc_h264 = None
-            if rc:
-                self._fail_count_h264 += 1
-                delay = min(2.0 * (2 ** self._fail_count_h264), 300.0)
-                log.warning(f"CameraCache: ffmpeg-h264 exit {rc}, retry in {delay:.0f}s (Versuch {self._fail_count_h264})")
-                await asyncio.sleep(delay)
-            else:
-                self._fail_count_h264 = 0
-                await asyncio.sleep(2.0)
+            await asyncio.sleep(2.0)
 
 
 class SpoolmanClient:
@@ -3908,16 +3863,6 @@ class KobraXBridge:
         self._camera_user_stopped = True
         return web.json_response({"result": "ok"})
 
-    async def handle_api_camera_reset(self, request):
-        """Backoff-Zähler zurücksetzen und ffmpeg sofort neu starten.
-        Nützlich nach 429-Sperre (Retry-After abgelaufen) oder nach Drucker-Neustart."""
-        self.camera_cache.reset()
-        url = self._state.get("camera_url", "")
-        if url:
-            self.camera_cache.set_url(url)
-            await self.camera_cache.ensure_running()
-        return web.json_response({"result": "ok"})
-
     async def handle_api_camera_snapshot(self, request):
         """Letzter JPEG-Frame aus dem CameraCache — instant aus dem RAM,
         keine eigene ffmpeg-Instanz mehr (verhindert Single-Client-429 am
@@ -5187,7 +5132,6 @@ def build_app(bridge: KobraXBridge) -> web.Application:
     r.add_get("/api/camera/snapshot",      bridge.handle_api_camera_snapshot)
     r.add_post("/api/camera/start",        bridge.handle_api_camera_start)
     r.add_post("/api/camera/stop",         bridge.handle_api_camera_stop)
-    r.add_post("/api/camera/reset",        bridge.handle_api_camera_reset)
     r.add_get("/api/state",                bridge.handle_api_state)
     r.add_get("/api/settings",             bridge.handle_api_settings_get)
     r.add_post("/api/settings",            bridge.handle_api_settings_post)

moonraker-obico.cfg.example

@@ -0,0 +1,18 @@
+[server]
+url = http://127.0.0.1:3334
+auth_token = REPLACE_ME
+sentry_opt = out
+
+[moonraker]
+host = 127.0.0.1
+port = 7125
+
+[webcam]
+disable_video_streaming = False
+snapshot_url = http://127.0.0.1:7125/api/camera/snapshot
+stream_url   = http://127.0.0.1:7125/api/camera/stream
+target_fps   = 5
+
+[logging]
+path  = /opt/printer_data/logs/moonraker-obico.log
+level = INFO

pull_request_template.md

@@ -0,0 +1,21 @@
+## Description
+<!-- What does this PR change? -->
+
+## Related Issue
+Closes #
+
+## Type
+- [ ] Bug fix
+- [ ] Feature
+- [ ] Documentation
+- [ ] Refactoring
+
+## Tested with
+- OrcaSlicer Version:
+- Printer:
+- Moonraker/Klipper Version:
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] CHANGELOG.md updated
+- [ ] No debug code included

web/themes/default/app.js

@@ -1871,7 +1871,6 @@ function camStart(){
   post('/api/camera/start',{}).then(function(){
     camOn=true;
     document.getElementById('cam-toggle-btn').textContent=tr('btn_cam_stop');
-    var rb=document.getElementById('cam-reset-btn');if(rb)rb.style.display='';
     clog(tr('log_cam_start'),'msg-ok');
     setTimeout(function(){ sp.style.display='none'; img.style.display='block'; },1200);
     if(/Android/i.test(navigator.userAgent)){
@@ -1906,7 +1905,6 @@ function camStop(){
   camOn=false;
   camUserStopped=true; // suppress auto-restart for remainder of this print
   document.getElementById('cam-toggle-btn').textContent=tr('btn_cam_start');
-  var rb=document.getElementById('cam-reset-btn');if(rb)rb.style.display='none';
   clog(tr('log_cam_stop'),'msg-ok');
 }
 
@@ -2157,13 +2155,6 @@ function aceDryToggle(aceId,on){
 
 function toggleCam(){if(camOn)camStop();else camStart()}
 
-function resetCamera(){
-  post('/api/camera/reset',{}).then(function(){
-    var btn=document.getElementById('cam-reset-btn');
-    if(btn){btn.textContent='↻';setTimeout(function(){btn.textContent='↺';},1000);}
-  }).catch(function(){});
-}
-
 function aceDryStop(aceId){
   aceId=(typeof aceId==='number'&&aceId>=0)?aceId:0;
   return post('/api/ace/dry',{action:'stop',ace_id:aceId})

web/themes/default/index.html

@@ -157,7 +157,6 @@
               <div style="font-size:12px;color:#fff" id="cam-fname"></div>
             </div>
             <button class="cam-toggle" onclick="toggleCam()" id="cam-toggle-btn">▶ Kamera</button>
-            <button class="cam-toggle" onclick="resetCamera()" id="cam-reset-btn" style="display:none;margin-left:4px" title="Kamera-Stream neu verbinden (nach 429-Sperre)">↺</button>
           </div>
         </div>