Publit.Si
Docs›Quickstart

Get started

Quickstart: YouTube in 20 minutes

The fastest way to see Publit.Si post something: YouTube only, no domain and no tunnel. You add Instagram, TikTok or the tunnel later; their steps work the same on a running installation.

You need

  • A Mac, Windows 10/11 PC or Linux computer with Node.js 22.12 or newer
  • Your license key and a GitHub account
  • A Google account that owns your YouTube channel

Get the code

  1. Claim access at publit.si/claim with your license key and GitHub username, accept the GitHub invitation and clone the repository. Details: Get the code.

    git clone https://github.com/publit-si/publitsi.git
    cd publitsi

Install and set up

  1. Install ffmpeg (the tunnel tool cloudflared can wait), then:

    corepack enable
    pnpm install
    cp .env.example .env
    pnpm local:setup
  2. Windows and Linux commands are in Install the tools. cloudflared and the tunnel lines may stay ✗; they are only for Instagram, Facebook, Threads, LinkedIn and TikTok.

Create your Google project

  1. Follow Connect YouTube up to and including client: enable the YouTube Data API, fill in branding, add yourself as a test user and create a Web application client with the redirect URI http://localhost:3000/api/oauth/youtube/callback.

  2. Put the client ID and secret into .env as GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET, or enter them later under Settings › Platform setup › Enter credentials.

Start Publit.Si

  1. Start it at every login, or by hand with pnpm dev. See Start Publit.Si.

    pnpm ops:install

Publish a test post

  1. Accounts → New project → Connect account → YouTube. On Google's screen choose Continue and tick all YouTube permissions.

  2. Create a post with a short video, set it to Private or Unlisted and schedule it five minutes ahead. More in Your first post.

Check

The post shows as published in the queue, and the video is on your channel.

Troubleshooting

redirect_uri_mismatch
The redirect URI in the dashboard must match exactly, including http/https and port.
YouTube: "Access blocked: Google's review of … was not completed" (403 access_denied)
Your Google project is in test mode and your account isn't on the list yet. In your own Google project: Audience → Test users → + Add users, add the Google account you connect with, save and connect again (step 5.2). No Branding, domain or publishing is needed for this. The sign-in then lasts 7 days; to skip the weekly reconnect see step 5, "YouTube without the weekly reconnect".
YouTube: "Google hasn't verified this app"
In test mode Google shows “You've been given access to an app that's currently being tested”: choose Continue. In production the unverified app shows Advanced → Go to … (unsafe). Both are fine for the project you created yourself. This warning differs from the blocked 403 screen, which needs a test-user entry in Testing.

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