{"id":51150969,"url":"https://github.com/dotexe97/botexe-studio","last_synced_at":"2026-06-26T06:01:03.701Z","repository":{"id":365119893,"uuid":"1267473138","full_name":"dOtExE97/botexe-studio","owner":"dOtExE97","description":"Lokales TikTok-Live Overlay-Studio — kostenloser TikFinity-Ersatz (Windows). Geschenke, Alerts, Overlays, Sounds, Spiele, TTS — alles lokal auf deinem PC.","archived":false,"fork":false,"pushed_at":"2026-06-25T06:13:10.000Z","size":3874,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T08:09:06.339Z","etag":null,"topics":["electron","obs","overlay","streamer-tools","streaming","tikfinity","tiktok","tiktok-live","tts"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dOtExE97.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-12T15:12:59.000Z","updated_at":"2026-06-25T06:13:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dOtExE97/botexe-studio","commit_stats":null,"previous_names":["dotexe97/botexe-studio"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/dOtExE97/botexe-studio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dOtExE97%2Fbotexe-studio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dOtExE97%2Fbotexe-studio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dOtExE97%2Fbotexe-studio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dOtExE97%2Fbotexe-studio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dOtExE97","download_url":"https://codeload.github.com/dOtExE97/botexe-studio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dOtExE97%2Fbotexe-studio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34805072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","obs","overlay","streamer-tools","streaming","tikfinity","tiktok","tiktok-live","tts"],"created_at":"2026-06-26T06:00:56.678Z","updated_at":"2026-06-26T06:01:03.685Z","avatar_url":"https://github.com/dOtExE97.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# bOtExE Studio\n\n**Dein eigenes TikTok-Live Overlay-Studio — kostenlos, lokal, auf deinem PC.**\nEin freier **TikFinity-Ersatz** für Windows: Geschenke, Alerts, Overlays, Sounds, Spiele, TTS, Punkte \u0026 Store — alles auf deinem Stream-PC, keine Cloud, keine Abo-Gebühr.\n\n[![Download](https://img.shields.io/badge/⬇️_Download-Windows_Setup.exe-ff4d2e?style=for-the-badge)](https://github.com/dOtExE97/botexe-studio/releases/latest)\n\u0026nbsp;\n[![Status: Alpha](https://img.shields.io/badge/Status-ALPHA_(früher_Test)-f59e0b?style=for-the-badge)](#)\n\n![bOtExE Studio Overlay](docs/e2e-overlay.png)\n\n\u003e ⚠️ **ALPHA — das ist KEINE fertige Software!** bOtExE Studio ist eine **frühe Testversion**: Vieles läuft schon, aber es können Fehler auftreten, Sachen sich ändern oder mal abstürzen. Wer's ausprobiert, ist quasi **Test-Pilot** 🧑‍✈️ — und genau dafür gibt's den Knopf *Einstellungen → Fehler melden / Funktion wünschen*. Jedes Feedback \u0026 jede Widget-Idee hilft enorm. 🙏 Nutze es vorerst auf eigene Verantwortung, gerne parallel zu deinem bisherigen Setup.\n\u003e\n\u003e 🤖 **Transparenz:** Gebaut von **dOtExE (Alex)**, gemeinsam „gevibe-coded\" mit **Claude (Anthropic)** als KI-Pair-Programmer — Ideen, Richtung \u0026 Tests von Alex.\n\n\u003c/div\u003e\n\n---\n\n## Was ist das?\n\nEin Streamer-Tool, das auf dein **TikTok-Live** hört (Geschenke, Follows, Likes, Chat) und daraus schöne **Overlays** für deinen Stream macht — plus Sounds, Spiele, Bestenlisten und mehr. Du baust dir dein Overlay zusammen, kopierst **einen Link** und fügst ihn in **TikTok Live Studio** oder **OBS** als Browser-Quelle ein. Fertig.\n\n### So läuft es (im Groben)\n```\nDein TikTok-Live  →  bOtExE Studio (auf deinem PC)  →  ein Overlay-Link  →  TikTok Live Studio / OBS\n   Gifts, Follows,      Trigger-Regeln, Widgets,          (transparenter\n   Likes, Chat          Sounds, Punkte, Spiele             Overlay-Canvas)\n```\n\n## Was kann es?\n- 🎁 **Geschenk-Alerts \u0026 -Feeds** mit echten TikTok-Gift-Bildern + Profilfotos\n- 🏆 **Bestenlisten** (Top-Gifter, Top-Likes, Punkte) im TikFinity-Look\n- 🎯 **Trigger**: „Wenn Gift X → spiele Sound / zeig Alert / dreh Glücksrad / …\"\n- 🎡 **Spiele**: Glücksrad, Bingo, Zahlen-Raten, Geschenk-Schlacht, Live-Umfrage, Giveaway\n- 🔥 **Effekte**: Feuerwerk, Herz-Regen, Konfetti, Geschenk-Kanone, Hype-Train\n- 🗳️ **Punkte \u0026 Store** wie Twitch-Kanalpunkte (Zuschauer sammeln \u0026 lösen ein)\n- 🗣️ **TTS** — Chat vorlesen \u0026 Ansagen (Gratis-Stimme sofort, Premium per eigenem Key)\n- 🎨 **30+ Premium-Widgets**, 17 Designs, alles einstellbar — und in der Liste schon **live als Vorschau** sichtbar\n- 🔌 **OBS-Steuerung, Stream-Deck, Streamer.bot, Befehle, Sport-Liveticker** u. v. m.\n\n\u003cdiv align=\"center\"\u003e\n\n**Die App (Live-Cockpit):**\n\n![App](docs/e2e-app-live.png)\n\n**Ein paar schöne Features:**\n\n| Glücksrad | Widget-Designs | Coin-Glas |\n|:---:|:---:|:---:|\n| ![Glücksrad](docs/wheel.png) | ![Designs](docs/widget-styles.png) | ![Coin-Glas](docs/overlay-gift-jar.png) |\n\n\u003c/div\u003e\n\n---\n\n## 📥 Installation\n1. **[Neueste Version herunterladen](https://github.com/dOtExE97/botexe-studio/releases/latest)** → `bOtExE Studio Setup.exe`.\n2. Starten → installieren. Windows warnt evtl. (unsignierte App) — **das ist normal \u0026 safe**, siehe **[Windows-Warnung? 👇](#️-windows-warnt-normal--und-so-gehts)**.\n3. **Updates kommen automatisch** (im Hintergrund, beim nächsten Start aktiv). Manuell: *Einstellungen → Auf Update prüfen*.\n\n**Systemanforderungen:** Windows 10 (22H2) oder 11, 64-bit · ~2 GB RAM frei · TikTok Live Studio *oder* OBS. *(Aktuell nur Windows-Build — kein Mac/Linux-Download.)*\n\n## ⚠️ Windows warnt? Normal — und so geht's\nWeil die App (noch) kein teures **Signatur-Zertifikat** hat, ist Windows bei einer brandneuen, unbekannten `.exe` erstmal misstrauisch. Das bedeutet **NICHT, dass etwas gefährlich ist** — nur „Windows kennt diesen Herausgeber noch nicht\". 🔒 **Warum es safe ist:** der komplette **Code ist hier öffentlich einsehbar** (jeder kann ihn prüfen), die App läuft **lokal** ohne komische Server, und du kannst die `.exe` vor dem Start auf [virustotal.com](https://www.virustotal.com) hochladen und scannen lassen.\n\nJe nach Windows-Einstellung taucht eins davon auf:\n\n**1) „Der Computer wurde durch Windows geschützt\" (SmartScreen, blaues Fenster)**\n→ Klick **„Weitere Informationen\"** → dann erscheint **„Trotzdem ausführen\"** → draufklicken. ✅\n\n**2) Datei nach dem Download blockiert**\n→ Rechtsklick auf die `Setup.exe` → **Eigenschaften** → ganz unten **„Zulassen\"** (engl. „Unblock\") anhaken → **OK** → normal starten.\n\n**3) „Smart App Control\" blockiert ganz (nur neuere Windows-11-PCs)**\nDie strenge neue Funktion lässt unsignierte Apps gar nicht zu. Prüfen/abschalten: **Windows-Sicherheit → App- \u0026 Browsersteuerung → Einstellungen für Smart App Control → „Aus\"**.\n\u003e ℹ️ Auf **aktuellem Windows 11 (24H2/25H2)** kannst du Smart App Control danach **jederzeit wieder einschalten**. Nur auf **älteren** Win-11-Builds ging das Wieder-Einschalten erst nach einer Windows-Neuinstallation — falls du so einen alten Stand hast, vorher kurz überlegen. Bei den meisten PCs ist die Funktion eh aus oder im „Bewerten\"-Modus, dann brauchst du das gar nicht.\n\n*Sobald die App ein Signatur-Zertifikat hat (kommt später), verschwinden diese Warnungen automatisch.*\n\n## 🚀 Erste Schritte\nBeim ersten Start führt dich eine kurze **Tour** durch alles (jederzeit wiederholbar: *Einstellungen → Tour erneut zeigen*). Kurzfassung:\n1. **Gratis-Key holen (einmalig)** → *Einstellungen → TikTok-Verbindung → **„Gratis-Key holen\"***. Damit die App dein Live lesen darf, braucht sie einen **kostenlosen** Schlüssel von [eulerstream.com](https://www.eulerstream.com/register) (mit Google/GitHub/E-Mail registrieren → Key kopieren → in der App einfügen). Modus **„Cloud (gratis)\"** lassen — kein Bezahl-Plan nötig. *(Auch ohne Key kannst du sofort „Testen ohne Live\" für Demo-Events nutzen.)*\n2. **Live** → TikTok-Namen eingeben → *Verbinden*.\n3. **Overlay** → Widgets aus der Palette wählen (du siehst sie live!), aufs Bild legen, einstellen.\n4. **Link kopieren** → in TikTok Live Studio (einmalig einrichten) oder OBS als Browser-Quelle.\n\n\u003e **Warum ein Key?** TikTok hat keine offene Schnittstelle für Live-Events — ein Signier-Dienst (eulerstream) stellt die Verbindung her. Die App nutzt dessen **gratis Cloud-Stufe**, deshalb der kostenlose Schlüssel. Er bleibt lokal auf deinem PC.\n\n---\n\n## 🐞 Fehler \u0026 💡 Ideen\nDas ist die **Test-Phase** — Feedback ist Gold wert! In der App: *Einstellungen → **Fehler melden** / **Funktion wünschen*** (öffnet ein vorausgefülltes Formular, Version \u0026 System sind schon drin). Oder direkt: [Issues](https://github.com/dOtExE97/botexe-studio/issues).\n\n## 💜 Unterstützen\nDas Tool ist **kostenlos**. Wenn's dir gefällt: schau in meinem **TikTok-Live** vorbei und gönn mir was 🤝 → [@dotexe_97](https://www.tiktok.com/@dotexe_97). Das hilft mir, weiter dran zu bauen.\n\n## 🔒 Datenschutz \u0026 Sicherheit\n**Lokal-first:** Deine Daten (TikTok-Session fürs Chat-Senden, OBS-/TTS-Zugänge, Punkte, Overlays) bleiben **auf deinem PC**. Ausnahmen: **Cloud-TTS** schickt den vorzulesenden Text an den Stimmen-Anbieter, und das **Auto-Update** fragt bei GitHub nach neuen Versionen. Sicherheitslücken bitte **privat** melden → [`SECURITY.md`](SECURITY.md).\n\n---\n\n## 🛠️ Für Entwickler\nMonorepo (npm workspaces), Electron + Vite + TypeScript, React-Renderer, Vanilla-ES-Module-Widgets.\n\n```bash\nnpm install            # einmalig\nnpm run dev:desktop    # Dev-Modus\nnpm test               # alle Tests (node:test + tsx)\nnpm run lint           # eslint   ·   npm run typecheck   ·   npm run build:desktop\n```\n\n```\napps/desktop/src/{main,renderer,shared}   ← Electron-App (Logik · UI · Typen)\npackages/{overlay-engine,widget-kit,trigger-engine}   ← Overlay-Runtime · Widgets · Regel-Logik\n```\n\n**Release:** Version in beiden `package.json` bumpen, committen, dann `git tag v0.X.0 \u0026\u0026 git push origin v0.X.0` → CI baut \u0026 veröffentlicht die Setup.exe (Auto-Update-Feed via GitHub-Releases). Mehr: [`CHANGELOG.md`](CHANGELOG.md).\n\n## 🙏 Open-Source-Bausteine\nbOtExE Studio steht auf den Schultern großartiger Open-Source-Projekte — **Electron**, **React**, **Vite**, **Express**, **ws**, **ajv**, **lucide** (Icons), **obs-websocket-js**, **node-edge-tts** und nicht zuletzt **[TikTok-Live-Connector](https://github.com/zerodytrash/TikTok-Live-Connector)** (zerodytrash), das die TikTok-Live-Anbindung möglich macht. 💜 Danke an alle Maintainer!\n\nAlle mitgelieferten Bibliotheken stehen unter permissiven Lizenzen (MIT/ISC/BSD/Apache-2.0) — vollständige Liste \u0026 Attribution: [`THIRD-PARTY-LICENSES.md`](THIRD-PARTY-LICENSES.md).\n\n## Lizenz\n**Source-available, kein Open Source.** Der Code ist öffentlich einsehbar (Transparenz + Audit), und du darfst die offiziellen Builds fürs eigene Streaming nutzen — aber **nicht** kopieren, weiterverbreiten oder ein eigenes/kommerzielles Produkt daraus bauen. Alle Rechte bei dOtExE. Kommerzielle/Agentur-Lizenzen auf Anfrage. Details: [`LICENSE`](LICENSE).\n\n_Hinweis: Die Eigenlizenz oben gilt für **bOtExE-Studio-eigenen Code**. Die Drittanbieter-Bibliotheken behalten ihre jeweiligen (permissiven) Lizenzen — siehe oben._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdotexe97%2Fbotexe-studio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdotexe97%2Fbotexe-studio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdotexe97%2Fbotexe-studio/lists"}