Install the tools

MacMac

1. 1

   In the 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

WindowsWindows

1. 1

   In PowerShell:

   winget install OpenJS.NodeJS.LTS Gyan.FFmpeg Cloudflare.cloudflared

2. 2

   Close PowerShell and open a new window, so the new tools are found. Then:

   corepack enable
   pnpm install
   Copy-Item .env.example .env
   pnpm local:setup

3. 3

   Optional, to analyse existing videos: download whisper-cli.exe from the whisper.cpp releases and put its folder on PATH.

LinuxLinux

1. 1

   On Debian or Ubuntu:

   sudo apt install ffmpeg libsecret-tools
   sudo apt install xdg-utils libnotify-bin zenity   # desktop only

2. 2

   Install cloudflared from pkg.cloudflare.com or the .deb from the cloudflared releases. On Fedora, enable RPM Fusion and use sudo dnf install ffmpeg libsecret plus the .rpm.

3. 3

   Then:

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

If pnpm install fails while building better-sqlite3, run sudo apt install build-essential python3 and try again.

Read the checklist

1. 1

   pnpm local:setup sets Publit.Si up on this computer: the data folder, the database, a random key for your tokens (Mac: Keychain, Windows: DPAPI, Linux: keyring or a private key file) and, if whisper-cli is installed, the speech model (about 470 MB, once). Then it prints a checklist. It never writes to .env.

2. 2

   What you'll see (shortened, before any platform is set up):

   Data: ~/Library/Application Support/Publit.Si
   
   ✓ Token key in the macOS Keychain
   ✓ .env present
   ✗ PUBLITSI_PUBLIC_URL set (Instagram/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/TikTok only)
   …

3. 3

   Green ✓ for .env, ffprobe and cloudflared is what you need now. The platform keys stay ✗ until steps 3 to 6.

You can run pnpm local:setup again at any time. It only adds what's missing, keeps your data and shows what's still to do.