Skip to content

release-beta-1.0.0

Pre-release
Pre-release

Choose a tag to compare

@clowneon1 clowneon1 released this 27 Jul 18:02
· 26 commits to main since this release
bd2dc08

πŸ’Έ 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