transkripte/LINUX_MIGRATION.md

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:

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

tar -xzf whisper-transcript-pipeline-*.tar.gz
cd whisper-transcript-pipeline

2. Konfiguration anlegen

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

python3 transcript_pipeline.py scan

5. Hintergrunddienst aktivieren

./bin/transcript install
./bin/transcript status

6. Logs prüfen

./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:

loginctl enable-linger "$USER"

• Die bisherigen macOS-spezifischen Dateien im Projekt können auf Linux ignoriert werden.