Publit.Si
Docs›Install the tools

Installation

Install the tools

Publit.Si needs Node.js, pnpm, ffmpeg (to read your videos) and cloudflared (for the tunnel). One block of commands per system, run inside the publitsi folder.

You need

  • Node.js 22.12 or newer: check with node -v
  • On the Mac: Homebrew
  • On Windows: winget (built into Windows 10/11)
Mac

Mac

  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
Windows

Windows

  1. In PowerShell:

    winget install OpenJS.NodeJS.LTS Gyan.FFmpeg Cloudflare.cloudflared
  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. Optional, to analyse existing videos: download whisper-cli.exe from the whisper.cpp releases and put its folder on PATH.

Linux

Linux

  1. On Debian or Ubuntu:

    sudo apt install ffmpeg libsecret-tools
    sudo apt install xdg-utils libnotify-bin zenity   # desktop only
  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. On Arch, CachyOS or Manjaro, everything comes from the official repositories (whisper.cpp is optional, from the AUR):

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

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

Read the checklist

  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. 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/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. Green ✓ for .env, ffprobe and cloudflared is what you need now. The platform keys stay ✗ until steps 3 to 6.

Check

pnpm local:setup shows ✓ for .env, ffprobe and cloudflared. YouTube only: cloudflared and the tunnel lines may stay ✗.

Troubleshooting

pnpm local:setup shows ✗ for cloudflared
Mac: brew install cloudflared. Windows: winget install Cloudflare.cloudflared, then open a new PowerShell window. Linux: the .deb/.rpm from github.com/cloudflare/cloudflared/releases or pkg.cloudflare.com.
Linux: "The master key is in the desktop keyring … but no keyring is reachable"
The key was stored in the keyring of your desktop session. Run Publit.Si in that session, and install secret-tool (libsecret-tools; Fedora: libsecret).
Migration says the database is busy
Stop pnpm dev and close old Claude Code, Codex, Cursor or OpenCode sessions; the command lists the processes.

Stuck? Search the troubleshooting list or write to us . Leave out secrets and tokens.