Spotify
OAuth credentials and the active account routing. Multi-account: each playlist gets routed to its owner's token.
Must match exactly the redirect_uri registered in your Spotify dashboard app.
Google Drive
Asset discovery for content pipeline. Service account OR OAuth — service account is recommended for headless runs.
Drive folder whose subfolders are scanned for finished_reel/video assets.
Gmail / Submissions
How pitch emails are pulled and labelled, and how submissions are matched to artists.
JSON: source name → artist. Used when the email lacks an explicit artist.
Standard Gmail search syntax. Leave blank to use the "Tracked" label.
Buffer
Where reels and stories are queued for cross-posting. Channel IDs are Buffer's, not Instagram's.
Instagram / Meta
Instagram Business Login (preferred over Facebook Page flow) and per-account username preference.
When multiple IG accounts are linked, picks this one for publishing.
Only needed if Story Highlights archival is enabled below.
SEO Defaults
Global defaults used by every playlist unless overridden in its Rules tab.
These artists are never shuffled out of the top slots, across all playlists. Per-playlist overrides set in Publish → Rules.
Gemini Text (copy generation)
Used to generate post copy and SEO descriptions. Fallback to deterministic templates if disabled or quota exhausted.
Gemini Image (story image fallback)
When Drive doesn't have artwork for a track, Gemini can generate a 1080×1920 image. Requires billing enabled in AI Studio.
Veo (video generation)
Generate reels from a single image + audio via Google's Veo model. Long-running — poll interval and timeout are important.
API Quotas
Per-day caps and fallback behavior. Current usage shows below.
Content Pipeline
How daily/weekly content automation behaves — discovery, planning, queueing, trials.
Stories & Highlights
Story queue cadence and the Instagram Highlights archive job.
Scheduler
Background tick that runs due playlists. See Schedule for per-playlist cadence.
Public URL
HTTPS URL used for OAuth redirects and serving media to Buffer. Auto-detected from ngrok/Caddy, but you can pin it here.
Performance
Low-level Spotify-API tuning. Most users should leave these at defaults.
Pinned playlists
Playlists that always show in Today's home, even when they're not owned. Edit by toggling rows below.
Reset / Danger zone
Clear local overrides and revert to .env defaults. Will not delete OAuth tokens.
Deletes data/settings.json. The app re-reads from .env on next request. Click twice to confirm.
Logs you out and clears the session token. You'll need to reconnect to use the app.