Campaigns: 0 Approved: 58 Queue: 0 Posts today: 0
Cron:
Views: 0 Earnings: —

📖 Gebruiksaanwijzing

Stappenplan van A tot Z. Bookmark deze pagina — je vergeet zelf dingen na een paar weken.

1. Wat de bot automatisch doet 🤖

Op de Mac Mini draaien 3 LaunchAgents in de achtergrond. Jij hoeft niks te doen — deze cycli lopen 24/7:

elke 30 min
Post-cron
Pakt oudste queued clip → post op TikTok (via account proxy) → post-hold 40s → submit naar Whop met demographic screenshot → klaar. Safety-gate zorgt dat er niet te snel wordt gepost.
elke 3 uur
Tracker-cron
Scrape views + likes uit TikTok Studio · Update Whop submission status (pending → approved → paid) · Refresh demographic screenshots per account.
elke 12 uur
Scout-cron
Scrape nieuwe Whop campagnes → toevoegen aan DB → Telegram digest van top 5 kansen.
💡 Bot posts nooit zonder queued clips. Jouw dagelijkse werk = backlog vullen (§4) zodat de queue nooit leeg raakt.

2. Nieuwe Whop campagne toevoegen 🎯

  1. Join op Whop — ga naar whop.com, zoek de campagne, klik Join for free.
  2. Op Mac Mini (of via dashboard: klik 📊 Refresh stats): uv run crb scout run. Duurt 1-2 min.
  3. Ga naar Campaigns tab → zoek de nieuwe naam via zoekbalk.
  4. Klik op de campagne → Edit rules pagina opent.
  5. Vul in:
    • Korte naam: makkelijke label (bijv "Backyard Breaks")
    • Content type: gaming / podcast / poker / lifestyle — bepaalt welke highlight-mode Claude gebruikt
    • Layout: letterbox voor gaming/sports, face-track voor podcast
    • Map code / promo: brand-tag die HELE clip zichtbaar blijft (bijv @BACKYARDBREAKS)
    • CTA text: laatste 5 sec op scherm (bijv WATCH LIVE ON WHATNOT 👇)
  6. Save rules → vanaf nu worden deze automatisch toegepast bij elke video van deze campagne.

3. Nieuw TikTok account toevoegen 👤

  1. Maak TikTok account aan (via app of web) met een eigen email. Kies naam die past bij de campagne (bijv backyardbreaksviral023).
  2. Warm 't handmatig op — dagelijks 5-10 min gebruiken op je telefoon (scrollen, liken, kijken). Doe dit 3-7 dagen voordat je post.
  3. Ga naar Accounts tab → Add account form bovenaan:
    • Platform: TikTok
    • Username: zonder @
    • Display name: makkelijke label (bijv "BB Test 1")
    • Campaign: kies uit dropdown
    Klik Add.
  4. Multilogin flow (huidige standaard):
    • Open Multilogin X app op de Mini → maak nieuw profile aan → koppel er een verse proxy aan
    • Start het profile → in de Mimic-browser: tiktok.com/signup → phone-verify (via 5sim / TextVerified)
    • Kopieer de profile-UUID (rechtsklik → Copy ID)
    • In dashboard: Edit account → plak UUID in "🚀 Multilogin Profile ID" veld → Save
    • Klik 🚀 Verify Multilogin op de account-card → moet logged_in: true tonen
  5. Refresh /accounts → status wordt 🔓 logged in.
  6. Op de account-kaart: klik 🤖 Auto-capture uit TikTok Studio (in Edit-pagina onderaan) → bot maakt demographic screenshot. Nodig voor BB submits.
  7. Status-dropdown → verander naar active. Nu doet bot mee met auto-queue distributie.

4. Nieuwe video door de pipeline 🎬

  1. Ga naar Sources tab.
  2. In Add source via URL:
    • YouTube (of andere) URL van de video
    • Kies Campagne uit dropdown (via de auto-complete, typ 't in) — belangrijk voor rules
    Klik Download. Duurt ~1-5 min afhankelijk van lengte.
  3. Op de nieuwe source card: 1. Transcribe → wacht ~2-5 min (Whisper draait op Mac Mini).
  4. 2. Find Highlights → Claude picks viral moments (30 sec).
  5. 3. Render All ↓ → open form (velden LEEG laten = campagne defaults gebruiken) → klik Render All. Duurt ~30 sec per clip.
  6. Ga naar Clips tab → filter op source.
  7. Preview elke clip (klik op video). Approve top 3-6, reject de rest.
  8. Voor approved clips: klik Gen caption → Claude maakt caption (BB krijgt SOP-format automatisch).
  9. 🎯 Auto-queue → scheduler kiest zelf welk account 'm krijgt.

5. Backyard Breaks specifieke workflow 💰

BB vereist prijs op scherm per clip + specifieke SOP-caption. Bot doet 80% auto, jij vult 20% in per clip.

  1. Doe standaard pipeline (§4) tot je approved clips hebt.
  2. Per approved clip: klik 💰 Custom overlay → vul in:
    • custom_map_code: prijs uit BB tracker (bijv $100K+ 1/1 PULLED LIVE)
    • custom_cta_text: leeg = campagne default (Watch Live on Whatnot)
    Klik Save overlay.
  3. Klik 🎬 Render preview → clip krijgt de prijs als grote gele sticker top-right, hele clip zichtbaar.
  4. Preview de video (check dat prijs klopt + leesbaar is).
  5. Klik Gen caption → Claude gebruikt jouw prijs + SOP-formule automatisch → hashtags = alleen #BackyardBreaks #BBPulls #Whatnot.
  6. 🎯 Auto-queue. Klaar.
💡 Voor BB moet je account 'n demographic screenshot hebben (via Auto-capture in account Edit). Anders faalt submit.

6. Dagelijkse check-in (5 min) ☕️

  1. Overview tab → zie views, earnings, top posts vandaag.
  2. Accounts tab → check queue → nog genoeg? Zo niet: nieuwe source downloaden.
  3. Check dat status van alle accounts active is (niet paused/banned).
  4. Klik 📋 Logs knop rechtsonder → scan voor rode fouten. Meestal alles groen.
  5. Als top-post enorm scoort (>2000 views): overweeg meer van dat type source te downloaden.

7. Als er iets misgaat 🛠

🔴 Submit faalt (bot komt niet door Whop)
Check data/submit_debug/*_FAILURE_*.png — bot dumpt screenshot van waar 't fout ging. Deel met Mick/Claude, wordt binnen 10 min gefixt.
🔴 Post faalt (bot komt niet door TikTok)
Check logs/post-cron.err.log. Meestal: TikTok captcha, sessie expired, of proxy dood. Fix: open het Multilogin profile handmatig, log opnieuw in op tiktok.com in Mimic, sluit netjes via Multilogin's Stop-knop zodat cookies sync'en.
🔴 Views blijven 0 op een clip
Mogelijk shadow-ban. Kijk of TikTok Studio de video toont. Als hij bestaat maar geen views: temper posting (pause account 24u), overweeg nieuw account.
🔴 Queue leeg
Doe nieuwe source (§4). Target: altijd 5+ queued clips per account.
🔴 Dashboard laadt niet meer
Op Mac Mini terminal: Ctrl+C in dashboard-terminal + uv run crb dashboard --host 0.0.0.0 opnieuw.
🔴 Nieuwe code van laptop niet zichtbaar
Op Mac Mini: cd ~/Documents/GitHub/whop-content-reward-bot- && git pull && uv sync + dashboard herstart.

8. Terminal commands (referentie) 💻

Alles kan via dashboard, maar deze CLI-commands zijn soms handig voor debugging.

CRB — bot commands
uv run crb dashboard --host 0.0.0.0 — start web-dashboard
uv run crb scout run — refresh Whop campagnes
uv run crb tracker run — refresh views + earnings + demographics
uv run crb post run --submit-mode manual-publish — test-post 1 clip live
uv run crb post list-queue — zie queue + wanneer volgende post
uv run crb account test-proxy <id> — test of proxy werkt (returns US IP)
uv run crb account refresh-demographic <id> — auto-capture demographic screenshot
uv run crb post login <account_id> — login op TikTok voor account
uv run crb submit debug <campaign_id> — dump Whop pages voor selector-tuning
uv run crb caption gen <clip_id> — genereer caption handmatig
tail -f logs/post-cron.log — live logs volgen
macOS — Mac Mini beheer
caffeinate -i & — voorkom idle sleep (op achtergrond)
nohup caffeinate -i > /dev/null 2>&1 & — fully detached (terminal mag dicht)
disown — na de vorige, om proces los te maken van shell
pgrep -x caffeinate — check of caffeinate draait
killall caffeinate — stop alle caffeinate processen
ipconfig getifaddr en0 — vind lokaal WiFi IP (voor dashboard access)
launchctl list | grep crb — check of LaunchAgents draaien
launchctl bootout gui/$(id -u)/com.mickgerritsen.crb-post — stop post-cron
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.mickgerritsen.crb-post.plist — start post-cron
Git — updates van laptop naar Mac Mini
git pull — haal nieuwste code van GitHub
uv sync — installeer nieuwe dependencies (als er zijn)
./update.sh — shortcut: git pull + uv sync in 1
SQLite — quick DB checks
sqlite3 data/bot.db "SELECT id, username FROM accounts" — lijst alle accounts
sqlite3 data/bot.db "SELECT id, name FROM campaigns WHERE name LIKE '%backyard%'" — zoek campagne
sqlite3 data/bot.db "SELECT clip_id, caption_text FROM captions WHERE clip_id=X" — bekijk caption van clip

9. Bekende issues & workarounds ⚠️

🟡 TikTok Studio layout verschilt per account
Sommige accounts krijgen A/B test versies van upload-UI. Bot post wel op account X maar faalt op account Y met "Caption editor niet gevonden".
Debug: Log in handmatig op falend account in Chrome → check hoe upload-pagina eruit ziet vs een werkend account. Screenshot verschillen delen, dan tunen we selectors of voegen extra fallback varianten toe.
🟡 "Something went wrong / Retry" mid-upload
TikTok-server hiccup. Bot detecteert nu en klikt Retry automatisch. Als 't blijft crashen op zelfde clip: content is mogelijk geflagd (te lang, watermark, herhaalde upload).
🟡 Terminals raar bij dashboard + login in dezelfde window
Dashboard-logs overspoelen de input prompt van login. Gebruik altijd 2 terminal windows: 1 voor dashboard, 1 voor interactieve commands.
Vragen? App-je Mick, of update deze guide zelf via src/content_reward_bot/dashboard/templates/guide.html.