Connect Ko-fi (donations & memberships)
Ko-fi donations and memberships show up automatically as an alert on stream (DonationModule). The connection runs through a webhook relay: Ko-fi sends the event to our server, and the app fetches it from there — your desktop app doesn't need an open port for this. Matching to your viewer DB works only via `!username` at the very start of the Ko-fi message (e.g. "!MaxMustermann thanks for the stream!") — that part is automatically stripped from display and text-to-speech. Without a matching username already seen in chat, the alert still shows but isn't credited to anyone in the DB. The syntax for `!username` is case-insensitive (e.g. `!MaxMustermann` or `!maxmustermann`), followed by a space. Attribution works for both Twitch and YouTube names.
Requirements
- A Ko-fi account (ko-fi.com) with a page set up.
- Logged into the account area at aaronius.com inside the app (needed so events can be matched to you).
Step by step
- In the app under Settings → Integrations → Ko-fi, select "Ko-fi" as the provider.
- On ko-fi.com/Manage/webhooks, copy the "Verification Token" and paste it into the app, then save.
- On Ko-fi, set the webhook URL to exactly the address shown in the app, and save it there.
- Click "Test connection" in the app — it reports specifically if the token or webhook don't match.
- Send a "Send Test Message" on Ko-fi — the test donation appears as an alert in the overlay.
If it doesn't work
- Alert stays silent even though "Test connection" reports green: compare the verification token in the app and on Ko-fi character by character — if it was regenerated on Ko-fi, re-enter it in the app too.
- "Not logged into Supabase": log in under the app's account area and test again.
- Membership tiers: All Ko-fi memberships are currently handled as a single uniform tier.
Last updated: 5 September 2026