Skip to content

About

A vibe-coding tiny desktop companion that quietly watches your favorite streamer’s YouTube channel and pops up from the bottom corner only when they go live.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

🎮 Controller Notify

Never miss your favorite YouTube live streams again!

A charming, ultra-lightweight Windows desktop companion that quietly sits in your system tray and pops up cute, retro-styled corner notifications the exact second your favorite channels go LIVE.

Windows Support Zero API Key Required 5 Retro Themes License MIT

📥 Download Latest Installer • ✨ Key Features • 🎨 Retro Themes • 🚀 Quick Start Guide • ❓ FAQ


Note

No Google Cloud API Key Required! Controller Notify comes with built-in 0-Quota Free Monitoring, allowing you to watch as many channels as you want completely free of charge out of the box!


Key Features

⚡ 0-Quota Free Monitoring

  • Watch unlimited channels without creating Google Cloud developer projects or pasting API keys.
  • Intelligent background checking with zero impact on network pacing or quota limits.

🎨 5 Retro Color Themes

  • Personalize your experience with custom retro themes: Pastel Pink, Midnight Dark, Turquoise 8BitDo, Game Boy Classic, and Atomic Purple!

📥 1-Click Subscription CSV Import

  • Import your entire YouTube subscription list in seconds! Simply drag & drop your Google Takeout subscriptions.csv file into the app.
  • Support for individual streamer handles (@VanTung), channel URLs, or channel IDs.

🧪 Instant Test Notification Button

  • Fine-tune your setup with a single click! Use the 🧪 Test Notification button to test sliding physics, timing, sound, and custom mascot graphics.

🖼️ Custom Controller Images & Mascots

  • Replace the default gamepad icon with your own image URL or local avatar image file.

📌 4 Corner Popup Positioning & Smooth Physics

  • Pin alerts to any desktop corner: Bottom-Right, Bottom-Left, Top-Right, or Top-Left.
  • Features silky-smooth bounce-in sliding physics and configurable display timers (5s to 60s).

🔴 Live Now Hub & Smart Watchlist Search

  • Dedicated dashboard showing all currently live channels in real time.
  • Instant search filter by channel name, handle, or ID, plus one-click status filters (All, 🔴 Live, 💤 Offline, 🔔 Enabled, 🔕 Muted).

🪶 Ultra-Lightweight & Battery Friendly

  • Runs silently in your system tray using only ~35MB–45MB RAM and 0% GPU background load, keeping your games smooth and battery intact.

5 Retro Color Themes

Customize the app UI and notifications to match your gaming desk setup:

Theme Mood & Style Highlight Palette
🌸 Pastel Pink Soft, kawaii pastel pinks & deep magenta highlights (Default) Soft Pink #fff5f9 • Magenta #e91e63
🌙 Midnight Dark Cyberpunk dark space black with vibrant cyan & hot neon pink Deep Black #0f111a • Cyan #00f0ff • Neon Pink #ff007f
🩵 Turquoise 8BitDo Retro 90s handheld gamepad vibes with cool teal & orange Mint Teal #e0f2f1 • Dark Turquoise #00897b
📟 Game Boy Classic Iconic 8-bit LCD dot-matrix greens & dark olive retro accents Matrix Green #9bbc0f • LCD Olive #306230
💜 Atomic Purple 90s translucent clear purple console nostalgia Translucent Grape #f3e5f5 • Deep Purple #8e24aa

Quick Start Guide

Getting started with Controller Notify takes under 2 minutes!

Step 1: Download & Install

  1. Go to the GitHub Releases page.
  2. Download the latest Controller-Notify-Setup-1.0.0.exe installer.
  3. Double-click to install — Controller Notify will launch automatically in your Windows system tray near the clock! 🎮

Step 2: Import Your YouTube Subscriptions

You can add channels individually or import your whole YouTube watchlist at once:

💡 Option A: 1-Click Google Takeout Import (Recommended)

  1. Go to Google Takeout.
  2. Deselect all, check YouTube and YouTube Music, click All YouTube data included, select subscriptions, and export.
  3. Open Controller Notify settings, go to 👥 Channels > ➕ Add & Import.
  4. Drag & drop your exported subscriptions.csv file into the box. Done! All your favorite streamers are now monitored!

💡 Option B: Add Individual Channels

  1. Go to 👥 Channels > ➕ Add & Import.
  2. Type or paste any creator's @handle (e.g., @VanTung or @tarik) or channel URL.
  3. Click Add.

Step 3: Customize Popup Position & Retro Themes

  1. Open the ⚙️ General settings tab.
  2. Select your favorite theme from the App Color Theme dropdown (e.g., 💜 Atomic Purple or 📟 Game Boy Classic).
  3. Select your preferred desktop corner from Popup Corner (Bottom Right, Bottom Left, Top Right, or Top Left).
  4. Enter an image URL or local file path under Custom Controller Image if you'd like a personalized mascot!
  5. Click 🧪 Test Notification to preview your popup sliding onto your screen.
  6. Click 💾 Save Settings.

Tip

Stream Playback Option: You can choose whether clicking a live popup opens the stream in your default browser or directly in Controller Notify's built-in mini player window!


System Tray Controls

Controller Notify runs unobtrusively in your system tray. Right-click the 🎮 icon near your Windows clock for quick controls:

  • 🔄 Check Now: Trigger an instant check across all monitored channels.
  • 🔔 Show Notifications: Global toggle to pause or resume popup popups.
  • ⚙️ Settings: Open the spacious customization window.
  • ❌ Quit: Safely exit the application.

Frequently Asked Questions

Do I need a YouTube API key?
Nope! Controller Notify works 100% out of the box with zero setup required using our free 0-quota background monitoring engine. Providing an API key is completely optional.
How do I mute alerts for a specific streamer without removing them?
Go to 👥 Channels > 📋 Monitored Channels and click the 🔔 icon next to the channel to toggle it to 🔕 (Muted). You will still see their live status in the 🔴 Live Now Hub, but popups won't disturb you!
Does this app use a lot of RAM or lag my games?
Not at all! Controller Notify uses under 50MB RAM when minimized to tray and 0% background GPU resources. It is optimized specifically for low overhead while gaming.
Where are my channel watchlists and settings saved?
All preferences and watchlists are stored locally on your PC in encrypted system app storage. No account registration or external tracking servers required.

🧰 Developer & Building from Source

For open-source contributors and developers interested in running or building Controller Notify locally:

Prerequisites

  • Node.js 18+ on Windows.

Quick Commands

# Clone the repository
git clone https://github.com/your-repo/controller-notify.git
cd controller-notify

# Install dependencies
npm install

# Run app in development mode
npm start

# Run unit tests (60 passing tests)
npm test

# Build production Windows executable (.exe)
npm run build

📜 License

Distributed under the MIT License. Crafted with 🎮 for live stream enthusiasts!

About

A vibe-coding tiny desktop companion that quietly watches your favorite streamer’s YouTube channel and pops up from the bottom corner only when they go live.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages