Repository navigation
YouTube sign in
github-actions[bot] edited this page Nov 21, 2026
·
2 revisions
clippa upload talks to YouTube as your channel through Google's Data API, with an OAuth
"Desktop app" client you make once in Google Cloud. None of this costs money; the API has a
daily quota (YouTube channel, point 8).
- A Cloud project. https://console.cloud.google.com → New project (any name).
- Enable the API. APIs & Services → Library → YouTube Data API v3 → Enable.
-
The consent screen. APIs & Services → OAuth consent screen (Google Auth Platform):
External, your app's name and your email; no scopes to add here. Then publish it
(Audience → Publish app, "In production"): while it stays in Testing, Google expires the
sign-in every 7 days and uploads stop with
invalid_grant. You click past the "unverified app" warning once; no verification is needed to upload to your own channel. -
The client. Credentials → Create credentials → OAuth client ID → Desktop app.
Download the JSON and save it as
secrets/youtube_client_secret.json([paths] youtube_client_secret) on the machine you will sign in from (step 5). -
Sign in on a machine with a browser (your laptop):
clippa upload --sign-inopens one. Pick the Google account and, when it asks, the channel: a Brand Account channel shows as its own choice, and the personal identity has no channel to upload to. It asks for the upload andyoutube.force-sslscopes (captions, playlists), and the token lands insecrets/youtube_token.json. The sign-in needs the browser on the same machine (Google calls back to localhost), so a headless serve, the containers here, never signs in itself: copy both files into thesecrets/folder serve reads (on the NAS share here), as private as the Discord token. The token refreshes itself wherever it is used;clippa doctor --role serve(online) checks it, and when it stops working, sign in again the same way and copy the token over.
Only serve uploads: clippa doctor --role serve warns when the two files are missing, and other
roles don't need them. What a new channel does to the first uploads (verification, the daily
cap, Studio as the fallback) is YouTube channel.
Home · Getting started · clippa doctor · These pages are built from docs/wiki/ in the repo, so edits made here are overwritten: how to edit them
Run it
- Overview
- Getting started
- Roles and services
- Configuration
- Pipeline
- Review
- Reviewing
- War room
- Clippa messenger
- Scheduling and uploads
- Costs
- Checkup
- Audit
- Backups
Install
- Install
- Install checklist
- Kitsu
- Discord app
- YouTube sign-in
- Windows
- macOS
- Transcribe on Modal
- NAS recorder
- NAS hub
- Claude on the NAS
- Phone access
- Model providers
- Adding a show
- YouTube channel
Features
- Pre-shows
- Fetching VODs
- Speakers
- Faces
- Covers
- Cast library
- B-roll
- Clip art
- Weekly issue
- X posts
- TikTok
- News watcher
- Character pieces
- Documentaries
Research
Working on Clippa