Repository navigation
TikTok
Caution
Parked (2026-11-01). We post to TikTok by hand. Auto-send is off (TikTok flagged the drafts as bot activity), and direct posting is dropped: TikTok's app audit refuses tools that only post to your own accounts (issues #62, #116). The steps below still work if this is ever picked up again.
clippa tiktok sends scheduled Shorts to the TikTok app's drafts (Content Posting API,
Upload route). You open the notification on the phone, paste the caption and post. TikTok's
API takes no caption for drafts, so Clippa posts it to Discord ([tiktok] caption_channel_id,
else the [record] alert webhook or channel) and keeps it in schedule.json.
-
Developer app at developers.tiktok.com, owned by an organization: platform Desktop,
products Login Kit (redirect URI
http://localhost:3455/callback/, the port is[tiktok] redirect_port) and Content Posting API (leave Direct Post off), scopesuser.info.basicandvideo.upload. It needs a website, privacy and terms URL; ours are pages on byvfx.com (docs/tiktok-app-pages.md). Testing works in Sandbox with the TikTok account added as a target user. -
Keys: save
{"client_key": "...", "client_secret": "..."}assecrets/tiktok_client.json. -
Sign in once, as the TikTok account:
clippa tiktok --sign-in. The token lands insecrets/tiktok_token.json; it refreshes itself and the sign-in lasts 365 days (clippa doctorwarns two weeks before). -
Send:
clippa tiktok --items <stream>/v01 --dry-runshows the file and caption; without--dry-runit sends.clippa tiktoklists what was sent and marks drafts you posted as posted. The draft arrives as a notification in the TikTok app's Inbox (System notifications), not under Profile > Drafts; it becomes a draft once opened. -
Captions: create a Discord text channel (ours is #tiktok; the bot can't create channels)
and set
[tiktok] caption_channel_id. Each send posts a note and then the bare caption, so Copy Text on the phone copies just the caption.clippa tiktok --caption <item>posts it again. A draft left unposted expires in the app (TikTok's status still says it is in the inbox):clippa tiktok --items <item>,... --resendsends it again and keeps the old send underpreviousas expired, which frees its place in the 24 h count. -
Automatic (optional):
clippa tiktok --autosends the next unsent scheduled Shorts, earliest YouTube slot first, as many asmax_per_24hallows (captions saying "host(s)" are skipped). Set[tiktok] auto_send_minutes(e.g. 60) and restart serve to have it run that for you.
Limits: TikTok allows at most 5 pending drafts in 24 h; [tiktok] max_per_24h (default 3,
at most 5) stays under it. Most accounts can post up to 3 minutes. Direct posting without the phone step needs
TikTok's app audit, which requires an app meant for other creators, not your own accounts (#62).
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