Publit.Si
Dokumentation›Werkzeuge installieren

Installation

Werkzeuge installieren

Publit.Si benötigt Node.js, pnpm, ffmpeg zum Lesen deiner Videos und cloudflared für den Tunnel. Führe den Befehlsblock für dein System im Ordner publitsi aus.

Das brauchst du

  • Node.js ab Version 22.12: Prüfe mit node -v
  • Auf dem Mac: Homebrew
  • Unter Windows: winget (in Windows 10/11 integriert)
Mac

Mac

  1. Im Terminal:

    brew install ffmpeg cloudflared
    brew install whisper-cpp   # optional: analyse existing videos
    corepack enable            # provides the right pnpm version
    pnpm install
    cp .env.example .env
    pnpm local:setup
Windows

Windows

  1. In PowerShell:

    winget install OpenJS.NodeJS.LTS Gyan.FFmpeg Cloudflare.cloudflared
  2. Schließe PowerShell und öffne ein neues Fenster, damit die neuen Werkzeuge gefunden werden. Danach:

    corepack enable
    pnpm install
    Copy-Item .env.example .env
    pnpm local:setup
  3. Optional zur Analyse vorhandener Videos: Lade whisper-cli.exe aus den whisper.cpp-Veröffentlichungen herunter und füge seinen Ordner dem PATH hinzu.

Linux

Linux

  1. Unter Debian oder Ubuntu:

    sudo apt install ffmpeg libsecret-tools
    sudo apt install xdg-utils libnotify-bin zenity   # desktop only
  2. Installiere cloudflared über pkg.cloudflare.com oder das .deb aus den cloudflared-Veröffentlichungen. Unter Fedora aktiviere RPM Fusion und nutze sudo dnf install ffmpeg libsecret sowie das .rpm.

  3. Unter Arch, CachyOS und Manjaro stammt alles aus den offiziellen Paketquellen (whisper.cpp ist optional aus dem AUR verfügbar):

    sudo pacman -S --needed nodejs ffmpeg libsecret cloudflared base-devel python
    sudo pacman -S --needed xdg-utils libnotify zenity   # desktop only
  4. Anschließend:

    corepack enable
    pnpm install
    cp .env.example .env
    pnpm local:setup

Prüfliste lesen

  1. pnpm local:setup richtet Publit.Si auf diesem Computer ein: Datenordner, Datenbank, einen zufälligen Schlüssel für deine Tokens (Mac: Schlüsselbund, Windows: DPAPI, Linux: Schlüsselbund oder private Schlüsseldatei) und, falls whisper-cli installiert ist, das Sprachmodell (einmalig etwa 470 MB). Danach erscheint eine Prüfliste. .env wird nicht verändert.

  2. So sieht sie verkürzt aus, bevor eine Plattform eingerichtet ist:

    Data: ~/Library/Application Support/Publit.Si
    
    ✓ Token key in the macOS Keychain
    ✓ .env present
    ✗ PUBLITSI_PUBLIC_URL set (Instagram/Threads/TikTok only)
        → Tunnel domain, e.g. https://publish.example.com – SETUP.md step 3
    ✗ Google OAuth client set (YouTube)
        → SETUP.md step 5; redirect http://localhost:3000/api/oauth/youtube/callback
    ✓ ffprobe (video duration/format)
    ✓ cloudflared (Instagram/Threads/TikTok only)
    …
  3. Grüne ✓ bei .env, ffprobe und cloudflared reichen jetzt aus. Die Plattformschlüssel bleiben bis zu den Schritten 3 bis 6 bei ✗.

Ergebnis prüfen

pnpm local:setup zeigt ✓ für .env, ffprobe und cloudflared. Bei ausschließlicher YouTube-Nutzung dürfen cloudflared und die Tunnel-Zeilen noch ✗ zeigen.

Fehlersuche

pnpm local:setup zeigt ✗ bei cloudflared
Mac: brew install cloudflared. Windows: winget install Cloudflare.cloudflared, danach ein neues PowerShell-Fenster öffnen. Linux: .deb/.rpm von github.com/cloudflare/cloudflared/releases oder pkg.cloudflare.com.
Linux: „The master key is in the desktop keyring … but no keyring is reachable“
Der Schlüssel liegt im Schlüsselbund deiner Desktop-Sitzung. Führe Publit.Si in dieser Sitzung aus und installiere secret-tool (libsecret-tools; Fedora: libsecret).
Migration meldet eine belegte Datenbank
Stoppe pnpm dev und schließe alte Sitzungen von Claude Code, Codex, Cursor oder OpenCode. Der Befehl listet die Prozesse.

Du kommst nicht weiter? Suche in der Fehlersuche oder schreibe uns . Teile keine Zugangsdaten oder Tokens.