Repository navigation
Discord app
The Discord bot (clippa bot) posts a card per item in a thread per stream and answers its
buttons, and DMs you when something needs you (Review, Reviewing). Five
things on Discord's side, once:
-
Create the app. https://discord.com/developers/applications → New Application (name it
after your channel). Under Bot: Add Bot, then Reset Token and copy the token. The bot
needs no privileged intents: leave Presence, Server Members and Message Content off (it
uses the
guildsintent only). -
Save the token as the
DISCORD_BOT_TOKENenvironment variable on the machine that runs the bot (clippa setupasks for it on a bot role and checks it against Discord), or in the file[paths] discord_token(secrets/discord_token.txt). Never in clipper.toml. -
Invite it to your server. Under OAuth2 → URL Generator tick the scopes
botandapplications.commands, and the bot permissions View Channels, Send Messages, Create Public Threads, Send Messages in Threads, Embed Links, Attach Files and Read Message History (plus Manage Channels if Clippa may make#weekly,#newsor a private#blindsfor you). Open the URL it builds and pick the server. -
Copy the ids. Discord → Settings → Advanced → Developer Mode on. Then right-click → Copy
ID on the server (
[discord] guild_id), on the review channel, a text or forum channel (review_channel_id: one thread or post per stream), and on yourself (allowed_user_ids; the first id gets the DMs unless[notify] user_idsays otherwise). In clipper.toml:[discord] enabled = true guild_id = "..." review_channel_id = "..." allowed_user_ids = ["..."]
clippa review invite <user id>adds another person later (Reviewing). -
Run it.
clippa doctor --role botchecks the token and the three ids;clippa bot(or its container, Roles and services) signs in, registers the slash commands on your server and starts answering. Cards appear at the end ofclippa review publish(the worker's last stage) while[discord] enabledis true;clippa review notify <stream>posts a stream's cards by hand, andclippa alert testDMs you a test.
Settings worth knowing, all under [discord] and [notify] in clippa/defaults.toml:
max_upload_mb (10 on a plain server, 50 or 100 with boosts) decides how previews are shrunk
to fit; thread_name names the threads; replan reruns the schedule after each decision;
refresh_minutes keeps the cards in step with decisions made in Kitsu or the war room, and with
items that approved themselves.
The bot also posts the news watcher's stories and asks you about gossip blind items, each in a channel of its own.
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