frank/streamertool

Watch

Fork

You've already forked streamertool

Code Issues 62 Pull requests 6 Projects Releases Packages Wiki Activity Actions

Patreon Integration: Supporter Wall, Tier-Display & Goal-Widgets #64

New issue

Open

opened 2026-07-15 20:02:25 +02:00 by frank · 0 comments

frank commented

2026-07-15 20:02:25 +02:00

Owner

Copy link

Kontext

Patreon bietet über die API v2 detaillierte Informationen zu Goals (Fortschrittsziele) und Tiers (Mitgliedschaftsstufen). Streamer nutzen Patreon-Goals als zentrales Engagement-Instrument und möchten ihre Patrons öffentlich würdigen.

Patreon Goal API:

Goals sind kampagnen-basiert mit Titel, Beschreibung, Zielbetrag und aktuellem Betrag
Automatisch aktualisiert wenn neue Patrons beitreten
Webhook-Events: goal:create, goal:update, goal:delete

Patreon Tier API:

Jedes Tier hat: Name, Beschreibung, Preis (Cents), Bild, veröffentlicht/versteckt
Patrons sind über members mit Tiers verknüpft
Webhook-Events: tier:create, tier:update, tier:delete

Member Data (für Supporter Wall):

full_name, patron_status, currently_entitled_amount_cents
lifetime_support_cents, pledge_relationship_start
tier (Name, Bild, Preis)
last_charge_date, last_charge_status

Ziel

Patreon Supporter Wall, Tier-Display & Goal Widgets für streamertool:

1. Patreon Goal Widget (OBS Overlay)

Live-Goal-Fortschritt aus Patreon API (Goal-Titel, Zielbetrag, aktueller Betrag)
Automatische Synchronisation via API-Polling + Webhook-Updates
Multi-Goal Support (mehrere Ziele parallel darstellbar)
Fortschrittsbalken mit Prozent und Betrag
Animation bei Zielerreichung (Celebration Overlay + Sound)
Konfigurierbares Design (Farben, Position, Größe, Schriftart)
Auto-Switch zwischen Goals (zirkulierend)

2. Patreon Supporter Wall (OBS Overlay)

Scrollende/statische Liste aller aktiven Patrons
Gruppiert nach Tier-Stufen (höchstes Tier zuerst)
Anzeige: Name, Tier-Badge, Support-Dauer, Lifetime-Betrag optional
Konfigurierbar: Max-Anzahl, Sortierung (neueste/älteste/höchstes Tier)
"Shoutout"-Modus: Einzelner Patron wird hervorgehoben (Trigger via Chat-Command)
Supporter Wall Bildschirmfüllend (für BRB/Endscreen)
Respektiert Patreon's Privacy-Einstellungen

3. Tier-Display Widget

Alle verfügbaren Tiers der Kampagne anzeigen
Name, Preis, Beschreibung, Vorteile
Wie viele Patrons aktuell pro Tier
Konfigurierbare Darstellung (horizontal, vertikal, Raster)
"Next Tier Up" — zeigt nächste erreichbare Stufe für den Streamer
Highlight des beliebtesten Tiers

4. Patreon Recognition Overlay

Monthly Top Patrons — Top 3 des Monats (nach Lifetime-Wachstum)
Milestone Celebration — Bei Erreichen bestimmter Patron-Anzahlen (10, 25, 50, 100)
Patreon-versus-Ko-fi Vergleich — Gesamteinnahmen aus beiden Plattformen
Loyalty Badge — Patrons mit >6 Monaten erhalten spezielles Badge

5. Feature Gating (Patreon-Exklusiv)

Overlays/Widgets können auf bestimmte Patreon-Tiers beschränkt werden
Patreon-Only Overlays (nur sichtbar wenn Patron aktiv)
Exklusive Chat-Befehle für Patrons
API-Abfrage: Prüfung des Patron-Status via OAuth (für Viewer-Login)

6. Dashboard

Übersicht: Aktive Patrons, Revenue (Current/Month), Lifetime Revenue
Goal-Management: Welche Goals im Overlay angezeigt werden
Tier-Konfiguration: Welche Tiers öffentlich angezeigt werden
Supporter Wall Vorschau (wie sieht's im Stream aus?)
Patreon-vs-Ko-fi kombinierte Revenue-Ansicht
Manueller Force-Sync

Technische Leitplanken

Setzt #63 voraus — OAuth, API-Zugriff und Webhooks von #63 sind erforderlich
Datenquelle: Patreon API v2 (Goals, Tiers, Members) + Webhook-Updates
Goals: Direkt über campaign/{id}?include=goals,tiers abrufbar
Supporter: Aus Member-Sync (#63) mit Tier-Zuordnung
Overlays: HTML/CSS/JS Browser Sources via lokalen Server
Konfiguration: In settings.json unter integrations.patreon.goals
Feature-Gating: Kein externer Auth-Server — nur lokale Tier-Prüfung (für exklusive Overlays im eigenen Stream)

Akzeptanz

Goal Widget zeigt Fortschritt aus Patreon API und aktualisiert live
Supporter Wall zeigt alle aktiven Patrons gruppiert nach Tier
Tier-Display zeigt alle verfügbaren Stufen mit Preisen und Patron-Zahlen
Milestone Celebration triggert bei bestimmten Patron-Zahlen
Feature Gating blendet Overlays basierend auf Tier aus/ein
Dashboard zeigt kombinierte Patreon-Übersicht
Supporter Wall funktioniert als OBS Browser Source Overlay

Verwandte Issues

#30 Donation/Tip-System
#61/#62 Ko-fi Integration
#63 Patreon OAuth & Alert-Overlay (VORAUSSETZUNG)

## Kontext Patreon bietet über die API v2 detaillierte Informationen zu **Goals** (Fortschrittsziele) und **Tiers** (Mitgliedschaftsstufen). Streamer nutzen Patreon-Goals als zentrales Engagement-Instrument und möchten ihre Patrons öffentlich würdigen. **Patreon Goal API:** - Goals sind kampagnen-basiert mit Titel, Beschreibung, Zielbetrag und aktuellem Betrag - Automatisch aktualisiert wenn neue Patrons beitreten - Webhook-Events: `goal:create`, `goal:update`, `goal:delete` **Patreon Tier API:** - Jedes Tier hat: Name, Beschreibung, Preis (Cents), Bild, veröffentlicht/versteckt - Patrons sind über `members` mit Tiers verknüpft - Webhook-Events: `tier:create`, `tier:update`, `tier:delete` **Member Data (für Supporter Wall):** - `full_name`, `patron_status`, `currently_entitled_amount_cents` - `lifetime_support_cents`, `pledge_relationship_start` - `tier` (Name, Bild, Preis) - `last_charge_date`, `last_charge_status` ## Ziel **Patreon Supporter Wall, Tier-Display & Goal Widgets** für streamertool: ### 1. Patreon Goal Widget (OBS Overlay) - [ ] Live-Goal-Fortschritt aus Patreon API (Goal-Titel, Zielbetrag, aktueller Betrag) - [ ] Automatische Synchronisation via API-Polling + Webhook-Updates - [ ] Multi-Goal Support (mehrere Ziele parallel darstellbar) - [ ] Fortschrittsbalken mit Prozent und Betrag - [ ] Animation bei Zielerreichung (Celebration Overlay + Sound) - [ ] Konfigurierbares Design (Farben, Position, Größe, Schriftart) - [ ] Auto-Switch zwischen Goals (zirkulierend) ### 2. Patreon Supporter Wall (OBS Overlay) - [ ] Scrollende/statische Liste aller aktiven Patrons - [ ] Gruppiert nach Tier-Stufen (höchstes Tier zuerst) - [ ] Anzeige: Name, Tier-Badge, Support-Dauer, Lifetime-Betrag optional - [ ] Konfigurierbar: Max-Anzahl, Sortierung (neueste/älteste/höchstes Tier) - [ ] "Shoutout"-Modus: Einzelner Patron wird hervorgehoben (Trigger via Chat-Command) - [ ] Supporter Wall Bildschirmfüllend (für BRB/Endscreen) - [ ] Respektiert Patreon's Privacy-Einstellungen ### 3. Tier-Display Widget - [ ] Alle verfügbaren Tiers der Kampagne anzeigen - [ ] Name, Preis, Beschreibung, Vorteile - [ ] Wie viele Patrons aktuell pro Tier - [ ] Konfigurierbare Darstellung (horizontal, vertikal, Raster) - [ ] "Next Tier Up" — zeigt nächste erreichbare Stufe für den Streamer - [ ] Highlight des beliebtesten Tiers ### 4. Patreon Recognition Overlay - [ ] **Monthly Top Patrons** — Top 3 des Monats (nach Lifetime-Wachstum) - [ ] **Milestone Celebration** — Bei Erreichen bestimmter Patron-Anzahlen (10, 25, 50, 100) - [ ] **Patreon-versus-Ko-fi Vergleich** — Gesamteinnahmen aus beiden Plattformen - [ ] **Loyalty Badge** — Patrons mit >6 Monaten erhalten spezielles Badge ### 5. Feature Gating (Patreon-Exklusiv) - [ ] Overlays/Widgets können auf bestimmte Patreon-Tiers beschränkt werden - [ ] Patreon-Only Overlays (nur sichtbar wenn Patron aktiv) - [ ] Exklusive Chat-Befehle für Patrons - [ ] API-Abfrage: Prüfung des Patron-Status via OAuth (für Viewer-Login) ### 6. Dashboard - [ ] Übersicht: Aktive Patrons, Revenue (Current/Month), Lifetime Revenue - [ ] Goal-Management: Welche Goals im Overlay angezeigt werden - [ ] Tier-Konfiguration: Welche Tiers öffentlich angezeigt werden - [ ] Supporter Wall Vorschau (wie sieht's im Stream aus?) - [ ] Patreon-vs-Ko-fi kombinierte Revenue-Ansicht - [ ] Manueller Force-Sync ## Technische Leitplanken - **Setzt #63 voraus** — OAuth, API-Zugriff und Webhooks von #63 sind erforderlich - **Datenquelle**: Patreon API v2 (Goals, Tiers, Members) + Webhook-Updates - **Goals**: Direkt über `campaign/{id}?include=goals,tiers` abrufbar - **Supporter**: Aus Member-Sync (#63) mit Tier-Zuordnung - **Overlays**: HTML/CSS/JS Browser Sources via lokalen Server - **Konfiguration**: In `settings.json` unter `integrations.patreon.goals` - **Feature-Gating**: Kein externer Auth-Server — nur lokale Tier-Prüfung (für exklusive Overlays im eigenen Stream) ## Akzeptanz - [ ] Goal Widget zeigt Fortschritt aus Patreon API und aktualisiert live - [ ] Supporter Wall zeigt alle aktiven Patrons gruppiert nach Tier - [ ] Tier-Display zeigt alle verfügbaren Stufen mit Preisen und Patron-Zahlen - [ ] Milestone Celebration triggert bei bestimmten Patron-Zahlen - [ ] Feature Gating blendet Overlays basierend auf Tier aus/ein - [ ] Dashboard zeigt kombinierte Patreon-Übersicht - [ ] Supporter Wall funktioniert als OBS Browser Source Overlay ## Verwandte Issues - #30 Donation/Tip-System - #61/#62 Ko-fi Integration - #63 Patreon OAuth & Alert-Overlay **(VORAUSSETZUNG)**

frank added the

area:monetization

priority:medium

effort:medium

labels

2026-07-15 20:03:05 +02:00

frank added this to the Ko-fi & Patreon Integration milestone

2026-07-15 21:08:17 +02:00

No Branch/Tag specified

main

agent/issue-83-sub-alert-mit-prime-sub-gift-sub-bomb-va

agent/issue-81-follow-alert-konfiguration-mit-text-medi

agent/issue-86-alert-enable-disable-toggle-volume-steue

agent/issue-80-alert-medien-verwaltung-upload-zuweisung

agent/issue-79-alert-text-vorlagen-system-mit-variablen

agent/issue-87-standard-textvorlagen-bibliothek-für-tw

agent/issue-20-assistent-links-öffnen-keinen-browser

feat/twitch-eventsub-1

No results found.

Labels

Clear labels

agent:done

Managed by forge agent

agent:ready

Managed by forge agent

agent:working

Managed by forge agent

area:analytics

Analytics, Goals, Sentiment, Reports, Chat Analytics

area:chatbot

Chatbot, Moderation, Minispiele, AI-Integration

area:community

Community, Loyalty, Multi-Chat, Polls, Guest Streams

area:content

Clips, Video, AI Clip Creation, Social Media Posting

area:hardware

Stream Deck, MIDI, Beleuchtung, Kameras, Capture Cards

area:health

Bio-Sensor, Health & Wellness, Accessibility, Captions

area:media

Audio, Musik, SFX, TTS, Voice Changer, Song Requests

area:monetization

Monetarisierung, Donations, Tips, Interactive Cards

area:overlays

Widgets, Overlays, Media Loop, Custom Widgets

area:productivity

Stream Planning, Content Calendar, Show Runner

area:streaming

Multi-Platform, Streaming-Infrastruktur, Restream

bug

Something is not working

duplicate

This issue or pull request already exists

effort:large

Großer Aufwand – mehrere Tage bis Wochen

effort:medium

Mittlerer Aufwand – wenige Tage

effort:small

Geringer Aufwand – wenige Stunden

enhancement

New feature

good-first-issue

Guter Einstieg – für neue Mitwirkende geeignet

Backlog – kann warten, keine zeitliche Dringlichkeit

priority:critical

Kritisch – muss sofort bearbeitet werden

priority:high

Hohe Priorität – sollte bald bearbeitet werden

More information is needed

quick-win

Schnell umsetzbar, hoher Nutzen – lohnt sich sofort

No labels

Milestone

Clear milestone

No items

No milestone

Ko-fi & Patreon Integration

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

frank/streamertool#64

Reference in a new issue

Repository

frank/streamertool

Title

Body

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

Rows
Columns