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
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
Install ffmpeg (the tunnel tool
cloudflaredcan wait), then:corepack enable pnpm install cp .env.example .env pnpm local:setupWindows and Linux commands are in Install the tools.
cloudflaredand the tunnel lines may stay ✗; they are only for Instagram, Facebook, Threads, LinkedIn and TikTok.
Create your Google project
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.Put the client ID and secret into
.envasGOOGLE_CLIENT_IDandGOOGLE_CLIENT_SECRET, or enter them later under Settings › Platform setup › Enter credentials.
Start Publit.Si
Start it at every login, or by hand with
pnpm dev. See Start Publit.Si.pnpm ops:install
Publish a test post
Accounts → New project → Connect account → YouTube. On Google's screen choose Continue and tick all YouTube permissions.
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/httpsand 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.