StreamPe v2.1.0

StreamPe v2.1.0 Release Notes

Upgraded from Previous Release: release-v2.0.0 ➔ release-v2.1.0

🚀 Key Improvements & Bug Fixes in v2.1.0

• Windows Startup Executable Path Resolution: Fixed bug where Windows Start on Boot registry entry pointed to StreamPe-Server.exe (sidecar process) instead of StreamPe.exe (main desktop GUI app). getMainAppExePath() now scans portable release paths, parent folders, and target build locations for StreamPe.exe.
• Windows AppUserModelID & System Tray Toast Notifications: Integrated native Windows AppUserModelID (com.clowneon1.streampe) initialization inside Rust setup (app.notification().init_windows_registry(...)) so Windows Action Center & Notification Manager authorize and render notifications for uninstalled portable builds.
• Autostart Auto-Ticking Fix: Fixed bug where legacy registry keys caused the "Start on Boot" checkbox to auto-check on launch. Legacy entries are now cleaned up silently without auto-enabling autostart.
• Custom AI Agent Skills: Added bump-version, build-release, and create-github-release skills for automated component versioning, artifact collection, and GitHub draft generation.

What's Changed

• feat(pages): improve mobile responsiveness, navigation, floating github cta, and update screenshot assets by @clowneon1 in #24
• fix(server): startup path resolution, Windows AUMID tray notifications & version 2.1.0 release tooling by @clowneon1 in #25

Full Changelog: release-v2.0.0...release-v2.1.0

📦 Included Release Binaries

• StreamPe-v2.1.0-Portable.zip — Windows PC Desktop Server & App (~42.20 MB)
• StreamPe-v2.0.0-Companion.apk — Android Companion App (~11.32 MB)

StreamPe v2.0.0

🚀 Release Verification & Notes - StreamPe v2.0.0

StreamPe v2.0.0 represents a major evolution of the platform — transitioning from Electron to a native Tauri v2 + Bun sidecar architecture, introducing a native Android Companion App with auto-discovery and dark mode, and launching a GitHub Pages landing page at streampe.codepenguin.in.

---

✅ Pre-Release Verification Checklist

Verification Category	Sub-system / Target	Status	Verification Details
Android Versioning	build.gradle	✅ Passed	versionCode 2, versionName "2.0.0" verified
Android Package Name	Kotlin Source Files (16)	✅ Passed	100% migrated to com.clowneon1.streampe
Android Dark Theme	Activities (5)	✅ Passed	Forced Theme.MaterialComponents.NoActionBar & AppCompatDelegate.MODE_NIGHT_YES
Connection Stability	WebSocketManager.kt	✅ Passed	Fixed connection loop with isConnecting atomic guard
Server Eviction Logic	pc-server/server.js	✅ Passed	IP-filtered socket cleanup prevents kicking active clients
Desktop Architecture	Tauri v2 + Bun	✅ Passed	Memory usage < 25 MB RAM, instant boot, system tray
Documentation & Assets	README.md	✅ Passed	All 11 new v2 asset screenshots & unified list URLs updated
Landing Page	docs/	✅ Passed	Static glassmorphism landing page with custom domain (streampe.codepenguin.in)
Git Tree & History	feature/version-2	✅ Passed	Clean, squashed commit history synced with origin

---

⚡ Key Highlights of Release v2.0.0

1. Tauri v2 + Bun Sidecar Desktop Architecture

• Ultra-Lightweight Footprint: RAM footprint reduced to < 25 MB RAM with instant startup and zero lag during stream gameplay.
• Portable Distribution: Generates zero-install portable ZIP archives (StreamPe-v2.0.0-Portable.zip, ~42 MB).
• System Tray Hosting: Runs quietly in the Windows system tray with start-on-boot and close-to-tray configuration.

2. Native Android Companion App (com.clowneon1.streampe)

• mDNS Auto-Discovery: Native NsdManager scanning automatically detects the PC server on local Wi-Fi in under 3 seconds.
• Strict Dark Theme: Locked to Dark Mode across all 5 Activities (MainActivity, PermissionsActivity, AppSelectorActivity, AlertLogActivity, NotificationTesterActivity) regardless of device system light/dark theme settings.
• Zero-Flicker Connection Manager: Atomic isConnecting state guard prevents duplicate socket creation and connection status flickering.
• Permanent Alert History: Local storage (alert_log.json) allows streamers to view history and re-trigger any alert to OBS with 1 click.

3. Analytics & Overlay Customization

• Earning Overview & Analytics: Interactive revenue graphs, daily timeline charts, donor rankings, and tabular payment ledgers.
• Unified List Widget System: Modular list overlays (/overlay/list?id=top-supporters & /overlay/list?id=recent-donations) with Handlebars.js template support.
• Goal Percentage Overflow: Goal bar progress percentages can exceed 100% to celebrate stretch goals live on stream.

4. Official GitHub Pages Landing Page (docs/)

• Custom Domain: Bound to streampe.codepenguin.in via docs/CNAME.
• Interactive Screenshot Carousel: 6-slide carousel featuring high-resolution v2 screenshots with auto-play, navigation controls, and mobile touch swipe.
• Dynamic Release Link Integration: Download buttons automatically resolve to the latest release tag published on GitHub.

---

📄 License & Credits

Developed with ❤️ by clowneon1.
Distributed under the MIT License.

release-beta-v2.0.0

🚀 Release Notes - Version 2.0.0 (Beta 2)

We are proud to present Version 2.0.0 (Beta 2) of Payment Alerts for OBS! This release contains a complete structural overhaul, transitioning from Electron to a modern Tauri v2 + Bun sidecar architecture while introducing a rich suite of new features, widgets, analytics dashboards, and parser optimizations.

Below is the comprehensive list of changes implemented in the Version 2 codebase, synced directly from our project roadmap.

---

⚡ Major Architecture Overhaul (Electron ➡️ Tauri v2 + Bun)

• Tauri v2 Desktop Shell: Fully migrated the desktop app wrapper from Electron to Tauri v2. This reduces the application's RAM usage to less than 25 MB and significantly improves start times.
• Bun Sidecar Server: Replaced the Node.js runner with a compiled Bun background sidecar. The Node.js Express server (server.js) is bundled into a lightweight, self-contained binary running natively without external dependencies.
• Compact Portable Releases: The workspace now generates a standalone, zero-install Portable ZIP (Payment-Alerts-for-OBS-v2.0.0-Portable.zip — ~42 MB, down from Electron's ~150+ MB), centrally collected in the dist/ directory via npm run app:dist.
• System Tray & Window Controls: Added native system tray integration. Minimizing the application hides it in the tray for uninterrupted background hosting. Includes start-minimized and launch-on-boot configuration flags.
• Unified Version Syncing: Built a version sync utility (npm version <patch|minor|major>) to automatically align versions across package.json, Cargo.toml, and tauri.conf.json.

---

📱 Rebuilt Android Companion App (Native Kotlin)

• Server Auto-Discovery (mDNS/Bonjour):
  • The PC server now integrates bonjour-service to broadcast _payment-alerts._tcp over the local network (with automatic port collision recovery to fallbacks like 58024).
  • The Android app uses native NsdManager for on-demand local network scanning (automatically stopping after 5 seconds to conserve battery) and displays connection history chips for quick re-entry.
• Dedicated Onboarding Carousel: A new 3-slide swipable onboarding setup (PermissionsActivity.kt) guides streamers through necessary permissions:
  • Slide 1: Notification Access (required for PhonePe / Google Pay alerts) with quick tips for Android 13+ Restricted Settings.
  • Slide 2: Battery Keepalive (disables battery optimization to prevent streams from falling asleep).
  • Slide 3: Accessibility Reader (explains when to use it as a fallback for apps like Amazon Pay).
• Zero-Restart Auto-Recovery: Re-engineered real-time WebSocket connection state listeners. The app instantly detects PC server restarts or network drops, updating the UI state dynamically (🔴 Server Closed / Reconnecting...) and restoring connections in under 3 seconds without freezing or requiring an app restart.
• Alert History & Retriggering: Implemented permanent local atomic storage (alert_log.json). Streamers can view a historical list of all mobile payments received and re-trigger any alert to OBS with a single click.

---

📊 Analytics & Income Dashboard (Earning Overview)

• Separated Data Architecture: Split configuration parameters (JSON format for lossless profile backup and sharing) from transaction ledgers (stored in a single tabular donations.csv for easy analysis in Google Sheets/Excel).
• Interactive Earning Overview: A new dashboard tab featuring:
  • A central total Donut Chart with branded payment method breakdowns.
  • Daily income timeline graphs.
  • Top Supporters Hall of Fame.
  • A paginated transaction log with a resizeable interface.
  • Monthly CSV partitioning to split data by month.
• Isolated Simulation Mode: Added a dedicated simulation toggle in the control panel. Streamers can trigger simulated test notifications without corrupting actual ledger stats, subgoals, leaderboards, or top supporter metrics.

---

🎨 Overlay Widgets & Styling Customizations

• Handlebars.js Template Engine Migration: Replaced the legacy, hand-rolled regex substitution with Handlebars.js v4.7.8 (using a fully self-hosted offline browser bundle). Streamers can now use loops ({{#each}}), conditional logic ({{#if}}, {{#unless}}), and custom helper operations (formatAmount, formatDate, eq, gt, lt) with default XSS protection.
• Unified List Widget System: Combined the legacy Recent Donations and Top Supporters systems into a modular List Widget format (/overlay/list?id=top-supporters and /overlay/list?id=recent-donations). Streamers can customize filters, minAmount thresholds, typography, dimensions, and layout cards using custom Handlebars HTML templates. Legacy endpoints are automatically backward-compatible.
• Goal Percentage Overflow: Added a checkbox config setting to allow the Stream Goal progress bar and percentages (e.g. {{percent}}) to exceed 100% to help celebrate stretch goals.
• Streamlined Settings Sidebars:
  • Moved the Earning Overview to the top navigation landing position.
  • Consolidated the "Animations" and "Alert Style & Colors" tabs into a single unified tab called "Alert Style & Animations".
  • Collapsed advanced secondary settings panels by default to provide an uncluttered design.
  • Removed the redundant base "Alert Widget Base" tab (Alert templates are now the single source of truth for alerts).
  • Fixed templating variables rendering inside Cycling Widget configurations.

---

⚙️ Core Engine, Parsers & Security

• Dedicated Google Pay (GPay) Parser: Parses transaction lines matching <Name> paid you ₹<Amount> and <Name> paid you <Amount> rupees, with advanced extraction of custom donor messages from the sub-text.
• Spam & Non-Payment Filter: Automatically filters out bank balance notifications, system OTP alerts, cashbacks, scratch cards, and bill reminders via regex checks.
• App List Cleanup: Officially narrowed payment app support to PhonePe, Google Pay, Amazon Pay, and Cash/Manual Entry to simplify operations and testing.
• Fast WebSocket Heartbeat: Implemented a 5-second WebSocket ping/pong heartbeat and client IP deduplication to prevent phantom connections from building up in the client counter.
• Winston Daily Rotate File Logger: Migrated to a daily rolling logger (application_YYYY-MM-DD.log) with an automated 7-day retention cleanup rule.
• Boot Synchronization Fix: Resolved a critical race condition where the web dashboard would load the default profile's CSV data on boot before the active profile context API resolved. Added helper context hooks to ensure active profiles load instantly.

release-v1.0.0

Release 1.0.0

I have fixed several bugs and made improvements to help make the project more stable.

This project is still in an early stage, so you may encounter issues.

Found a bug?

If you find a bug, please open an issue with as much detail as possible. I’ll do my best to fix it.

Want to contribute?

Contributions are welcome:

1. Fork the repository.
2. Fix a bug or improve the project.
3. Open a pull request.

Let’s build a great, reliable project for all OBS streamers together.

What's Changed

• fix(canvas-positioning): update layout schema fallbacks and improve W… by @clowneon1 in #3
• Fix/apk theme by @clowneon1 in #4
• docs: replace fake AI screenshots with real application screenshots c… by @clowneon1 in #5

Full Changelog: release-beta-1.0.0...release-v1.0.0

release-beta-1.0.0

💸 Payment Alerts for OBS — v1.0.0-beta.1 (Beta 1 Release)

We are excited to announce the first public beta release of Payment Alerts for OBS (v1.0.0-beta.1)! 🧪🚀

Payment Alerts for OBS is a free, open-source, ultra-fast, and 100% self-hosted solution that forwards real-time mobile payment notifications (PhonePe, GPay, Paytm, BHIM UPI) directly to OBS Studio or Streamlabs as customizable stream overlays.

Note

Beta Software Notice: This is a Beta release intended for testing and early feedback. If you encounter any bugs, connectivity issues, or notification parsing glitches, please report them on GitHub Issues or reach out on our Discord server!

---

🌟 Highlights & Key Features

⚡ Ultra-Lightweight Desktop Client (Windows)

• Minimal System Resource Usage: Built on Electron with a memory footprint under 20 MB RAM and zero impact on streaming/gaming FPS.
• System Tray Minimization: Keeps the server running silently in the background.
• Auto-Start on Boot: Optional toggle to launch automatically when Windows boots.
• Automatic Network Discovery: Automatically detects your PC's local IP address and displays connection details for easy mobile setup.
• One-Click Web Control Panel: Open the full dashboard instantly in your default web browser at http://127.0.0.1:2907/config.

---

📱 Companion Android App

• Real-Time Alert Forwarding: Instant alert transmission over local WebSocket TCP connection (< 100ms latency).
• Supports Popular Indian Payment Apps: PhonePe, Google Pay (GPay), Paytm, BHIM UPI, and more.
• Privacy First (No Accessibility Service Required): PhonePe requires only basic Notification Access permission — no invasive Accessibility Services needed.
• Reliable Background Execution: Auto-reconnect engine with boot startup support (RECEIVE_BOOT_COMPLETED) and battery optimization handlers.

---

🎨 Live Web Control Panel & Overlay Customizer

• Real-Time Transparent Grid Preview: View layout adjustments instantly with a transparent checkerboard preview mode.
• Dynamic Backdrop Blur & Opacity: Fine-tune background opacity (0% to 100%) and automatic backdrop blur effects.
• Lucide Icon Library: Choose from 60+ vector icons for overlays and cycling widgets.
• Custom Sound Effects & Audio: Upload custom alert sounds and configure Text-to-Speech (TTS) announcements.
• Manual Alert Trigger & Testing: Send test alerts directly from the dashboard to verify OBS sources before going live.

---

📡 5 Customizable OBS Stream Overlays

Add any of the following HTTP endpoints as Browser Sources in OBS Studio:

Overlay Source	Endpoint	Description
📡 Payment Alert Box	/overlay/alerts	Animated alert banner with sound effects and donor details when a payment is received.
🎯 Donation Goal Bar	/overlay/goal	Visual progress bar tracking payments towards a customizable financial goal.
🏆 Top Supporter Leaderboard	/overlay/leaderboard	Leaderboard showcasing top donors ranked by cumulative contribution.
📜 Recent Donations List	/overlay/recent	Real-time scrolling feed of recent supporter payments.
🔄 Auto-Cycling Widget	/overlay/cycling-widget	Dynamic widget that automatically cycles between Top Supporter and Recent Donors with smooth animation transitions.

---

🔒 100% Private, Self-Hosted & Free Forever

• Runs Entirely on Your Local Network: No third-party servers, intermediate cloud services, or data tracking.
• Zero Subscription Fees: Completely free and open-source under the MIT License.
• Financial Data Privacy: Your transaction data, payment amounts, and notifications never leave your local network.

---

📦 Downloads & Assets (Beta 1)

File	Operating System	Description
📦 Payment Alerts for OBS-1.0.0-beta.1-win.zip	Windows 10 / 11	Windows Desktop Application (Portable ZIP)
📱 payment-alerts-obs-1.0.0-beta.1.apk	Android 8.0+	Companion Android App APK
📄 Source code (zip / tar.gz)	All Platforms	Full Open-Source Code

---

🧪 Beta Testing & Feedback

Since this is a Beta release, user testing and feedback are greatly appreciated!

• 🐛 Found a bug? Open an issue on GitHub Issues.
• ❓ Setup Questions: Read FAQ.md for help with Android Play Protect, Android 13+ Restricted Settings, battery saver, and Windows Firewall.
• 💬 Live Help: Chat with us on our Discord Community.

---

🚀 Quick Setup Instructions

1. Desktop App:
   • Extract Payment Alerts for OBS-1.0.0-beta.1-win.zip and run Payment Alerts for OBS.exe.
   • Allow network access through Windows Defender Firewall if prompted.
2. Android App:
   • Install payment-alerts-obs-1.0.0-beta.1.apk on your mobile device.
   • Enter your PC’s local IP address (shown in the Desktop App window).
   • Grant Notification Access permission.
3. OBS Studio:
   • Add a new Browser Source in OBS Studio using your local overlay URL (e.g., http://<YOUR-PC-IP>:2907/overlay/alerts).
   • Set background opacity to 0% in the Control Panel for a crisp transparent overlay.

---

Full Changelog: https://github.com/clowneon1/payment-alerts-for-obs/commits/v1.0.0-beta.1