💝 Donation System

Stream-Donations mit Custom Alerts, TTS, Goals und Leaderboards. Self-hosted — kein StreamElements/StreamLabs nötig.

💡 Konzept

Wie StreamElements Tips, aber self-hosted + direkt integriert

Warum eigenes System?

StreamElements nimmt Gebühren + hat deine Daten. Unser System: 0% Gebühr (nur Stripe/PayPal Fees), volle Kontrolle, direkte Integration mit Overlay + Workflow Engine + Subathon.

Wie funktioniert's?

Öffentliche Donation Page (Link in Twitch Bio / Chat Command). Viewer wählt Betrag, schreibt Nachricht, zahlt per Stripe/PayPal. Alert erscheint im Stream Overlay. Optional TTS.

Integration

Donation = Workflow Trigger. Alert im Overlay, Subathon Timer Add, Discord Notification, Chat Message, Leaderboard Update — alles automatisch.

🔄 Donation Flow
Viewer
Öffnet Donation Page
→
Betrag + Nachricht
Optional: TTS aktivieren
→
💳 Payment
Stripe / PayPal
→
✅ Webhook
Payment confirmed
→
📡 Events
Redis → WS → Overlay
→
🔔 Alert
+ TTS + Sound
+ Subathon Add
🖥 Donation Page — Mockup

Öffentliche Seite: codenull.de/donate oder custom Domain

🎮
Support Codenull
Jede Donation erscheint live im Stream!
Betrag wählen
€1
€5
€10
€25
€50
€100
Custom Betrag...
Dein Name
Nachricht (optional)
Text-to-Speech aktivieren (+€0)
Bezahlmethode
💳 Kreditkarte
🅿️ PayPal
Powered by Codenull · Secure Payment via Stripe

⚙️ Konfigurierbar

  • Minimum Betrag (z.B. €1 Minimum)
  • TTS Minimum (z.B. ab €3 für TTS)
  • TTS Kosten (€0 extra oder aufpreis)
  • Preset Beträge (€1, €5, €10, €25 etc)
  • Max Nachricht-Länge (z.B. 300 Zeichen)
  • Banned Words Filter für Nachrichten
  • Custom Page Design (Logo, Farben, Text)
  • Custom URL (/donate oder /tip)
  • Währung (EUR default, Multi-Currency möglich)

🔔 Was passiert nach Donation

  • ✅ Overlay Alert (Bild + Sound + Animation)
  • ✅ TTS liest Nachricht vor (Web Speech API)
  • ✅ Subathon Timer: +Zeit basierend auf Betrag
  • ✅ Donation Goal Widget updated
  • ✅ Leaderboard updated
  • ✅ Discord Notification (#donations Channel)
  • ✅ Twitch Chat Message ("DankDonator donated €5!")
  • ✅ OBS Event Dock zeigt Donation
  • ✅ Admin Panel Live-Update
  • ✅ Workflow Engine Trigger für Custom Actions
📦 Features

💳 Payment

  • Stripe (Kreditkarte, SEPA, Klarna)
  • PayPal
  • Min/Max Betrag konfigurierbar
  • Multi-Currency (EUR, USD, GBP)
  • Webhook-basiert (idempotent)
Must Have

🔔 Alert Varianten

  • Tier-basiert (wie im Overlay System):
  • < €5: kleines Alert
  • €5-20: + TTS
  • €20-50: + Video
  • €50+: Full-Screen Takeover
Must Have

🗣 Text-to-Speech

  • Web Speech API im OBS Browser Source
  • Optional pro Donation
  • Min Betrag für TTS konfigurierbar
  • Banned Words / Profanity Filter
  • Max Nachricht-Länge
Must Have

📊 Goals

  • Donation Goal (Session, Tag, Monat)
  • Widget im Overlay (Bar/Text/Circle)
  • Auto-Reset per Stream oder manuell
  • Multiple Goals gleichzeitig
Must Have

🏆 Leaderboards

  • Top Donators (Session/Woche/Monat/All-Time)
  • Recent Donations Liste
  • Overlay Widget + Admin Panel
  • Anonyme Donations optional
Should Have

📧 Notifications

  • Email an Streamer bei Donation
  • Discord Webhook (#donations)
  • Twitch Chat Message
  • Push Notification (future)
Should Have

🔗 Subathon Integration

  • €1 Donation = +X Minuten
  • Konfigurierbar pro Betrag
  • Automatisch via Workflow Engine
Must Have

📈 Analytics

  • Donations über Zeit (Graph)
  • Durchschnittsbetrag
  • Top Donators
  • Conversion Rate (Page Views vs Donations)
Should Have

🎨 Custom Donation Page

  • Logo, Farben, Hintergrund
  • Custom Text/Description
  • Social Links
  • Preview im Admin Panel
Should Have
🖥 Admin — Donations Dashboard
codenull.de/admin/donations
€347
Today
€2,156
This Month
89
Donations (Month)
€24.22
Avg Donation

Recent Donations

TimeDonorAmountMessageTTSPayment
19:45 DankDonator €25.00 "GG das war ein geiler Stream! 🔥" Yes Stripe
19:32 Anonymous €5.00 "Keep it up!" No PayPal
19:15 BigFan2024 €100.00 "Hier nimm mein Geld! 💰💰💰" Yes Stripe
18:58 xXGamerXx €2.00 "nice" No Stripe
🗄 Datenmodell
donation id text PK userId text? FK → user // null = anonymous / unregistered displayName text // "DankDonator" or "Anonymous" email text? // for receipt amount decimal // 25.00 currency text // "EUR" message text? // max 300 chars, filtered ttsEnabled boolean isAnonymous boolean status enum // PENDING, COMPLETED, REFUNDED, FAILED paymentProvider enum // STRIPE, PAYPAL paymentId text? // Stripe PaymentIntent / PayPal Order ID alertShown boolean // track if alert was displayed ttsPlayed boolean // track if TTS was spoken createdAt timestamp donationSettings id text PK userId text FK → user isEnabled boolean minAmount decimal // 1.00 ttsMinAmount decimal // 3.00 presetAmounts integer[] // [1, 5, 10, 25, 50, 100] currency text // "EUR" maxMessageLength integer // 300 bannedWords text[] // profanity filter pageConfig jsonb // { logo, title, description, colors, socialLinks } alertConfig jsonb // tier-based alert settings (reuses overlay alertConfig format) donationGoal id text PK userId text FK → user title text // "Stream PC Upgrade" targetAmount decimal // 500.00 currentAmount decimal // 347.50 (denormalized) resetMode enum // MANUAL, PER_STREAM, DAILY, MONTHLY isActive boolean completedAt timestamp?
🔗 Integration mit anderen Modulen

🎨 Overlay

Donation Alert im Alert Box Widget. Tier-basiert (Betrag → unterschiedliches Design). Goal Widget zeigt aktuellen Stand.

🤖 Discord

#donations Channel Notification. Optional: Donor bekommt Discord Rolle ab Betrag X.

📺 Twitch

Chat Message: "DankDonator donated €25! 'GG!'". Via Twitch Bot (butler_jamie).

⚡ Workflow

Trigger: donation.completed. Conditions: amount, donor, anonymous. Actions: beliebig.

⏱ Subathon

€1 = +X Minuten. Automatisch per Workflow Action. Konfigurierbar in Subathon Settings.

🛒 Shop

Gleiche Payment-Infrastruktur (Stripe/PayPal). Shared Webhook Handler. Gleicher User Account.

📋 OBS Dock

Donations im Event Feed (SSE). Quick Action: Alert replay, Donor Info.

📡 StreamDeck

Button: Last Donation vorlesen. Button: Donation Goal anzeigen/verstecken.

❓ Offene Fragen

1. Refund Policy

Können Donations zurückerstattet werden? Manuell per Admin? Automatisch bei Chargeback? Oder "alle Donations sind final"?

2. Recurring Donations

Soll es monatlich wiederkehrende Donations geben (wie Patreon-Style)? Oder nur einmalige? Recurring wäre eigentlich ein Subscription-Produkt im Shop.

3. Minimum TTS-Betrag

Ab welchem Betrag soll TTS verfügbar sein? €1? €3? €5? Oder immer verfügbar? Missbrauch-Risiko bei niedrigem Minimum.

4. Donation Page URL

Unter codenull.de/donate? Oder eigene Domain möglich? Oder beides (Redirect)?

Codenull Platform · Donation System Module Planning · 2026-03-18