Initial import of transcript pipeline

LINUX_MIGRATION.md

@@ -0,0 +1,84 @@
+# Linux Migration
+
+Dieses Projekt kann auf einem Linux-Host ohne macOS-spezifische Bestandteile betrieben werden. Die Pipeline selbst ist plattformneutral; nur der Hintergrunddienst wechselt von `launchd` zu `systemd --user`.
+
+## Voraussetzungen
+
+- `python3` im `PATH`
+- `ffprobe` im `PATH`
+- `rclone` im `PATH`
+- optional `fswatch`
+  - wenn `fswatch` nicht vorhanden ist, fällt die Pipeline automatisch auf Polling zurück
+- eine funktionierende `rclone`-Remote `transkripte:/`
+
+## Bundle erstellen
+
+Auf dem Quellhost:
+
+```bash
+transcript bundle
+```
+
+Das erzeugt eine portable Datei in `dist/`, ohne:
+
+- `.env`
+- lokale Logs
+- SQLite-State
+- lokale Archive
+
+## Auf dem Zielhost
+
+1. Bundle kopieren und entpacken
+
+```bash
+tar -xzf whisper-transcript-pipeline-*.tar.gz
+cd whisper-transcript-pipeline
+```
+
+2. Konfiguration anlegen
+
+```bash
+cp .env.example .env
+```
+
+3. `.env` anpassen
+
+Mindestens diese Werte setzen:
+
+- `OPENAI_API_KEY`
+- `WATCH_DIR`
+- `OBSIDIAN_DIR`
+- optional `ARCHIVE_DIR`
+- optional `PROMPT_PATH`
+- optional `RCLONE_REMOTE`
+
+4. Funktion lokal testen
+
+```bash
+python3 transcript_pipeline.py scan
+```
+
+5. Hintergrunddienst aktivieren
+
+```bash
+./bin/transcript install
+./bin/transcript status
+```
+
+6. Logs prüfen
+
+```bash
+./bin/transcript logs pipeline
+./bin/transcript logs service
+```
+
+## Wichtige Hinweise
+
+- Der Linux-Dienst wird als `systemd --user` installiert.
+- Wenn die Pipeline auch nach Logout weiterlaufen soll:
+
+```bash
+loginctl enable-linger "$USER"
+```
+
+- Die bisherigen macOS-spezifischen Dateien im Projekt können auf Linux ignoriert werden.