Yeelight System Tray Controller

A lightweight Windows system tray app to control Yeelight smart bulbs, plus an advanced music sync feature.

Features

System Tray Controller

• 💡 System tray icon - Lives quietly in your taskbar
• 🔄 Quick toggle - Double-click to toggle light on/off
• 🎚️ Brightness control - 10%, 25%, 50%, 75%, 100%
• 🌡️ Color temperature - Warm (2700K) to Daylight (6500K)
• ⚡ Fast & lightweight - No heavy dependencies

Music Sync (NEW!)

• 🎵 Real-time audio visualization - Syncs with any audio (YouTube, Spotify, games)
• 🎧 Headphone support - Works with any output device via WASAPI loopback
• 🎨 Smart color mapping - Bass=warm colors, Treble=cool colors
• 🥁 Beat detection - Pulses on beats with adaptive threshold
• 🌊 Smooth transitions - Exponential smoothing for natural flow
• 🔄 Auto mode switching - EnergyPulse (reactive) ↔ SpectrumFlow (ambient)

Requirements

• Windows 10/11
• Python 3.8+
• Yeelight bulb with LAN Control enabled

Installation

1. Clone the repository:

   git clone https://github.com/user/yeelight-tray.git
   cd yeelight-tray

2. Install dependencies:

   pip install -r requirements.txt

3. Configure your bulb IP:

   copy config.ini.example config.ini

   Edit config.ini and set your Yeelight bulb's IP address.

4. Generate the icon:

   python generate_icon.py

5. Run:

   pythonw yeelight_tray.pyw

Finding Your Bulb's IP

1. Open the Yeelight app
2. Tap on your bulb → Settings (gear icon)
3. Look for "Device Info" → IP Address

Or check your router's connected devices list.

Enabling LAN Control

LAN Control must be enabled on your Yeelight bulb:

1. Open Yeelight app
2. Tap your bulb → Settings (gear icon)
3. Enable LAN Control

Usage

System Tray Controller

Action	Result
Double-click tray icon	Toggle light on/off
Right-click tray icon	Open menu with all options

Music Sync

1. First-time setup - Allow through firewall:

   Run this command in an elevated PowerShell (Run as Administrator):

   netsh advfirewall firewall add rule name="Yeelight Music Sync" dir=in action=allow protocol=TCP localport=54321

2. Run the music sync:

   python yeelight_music_sync.py

3. Play music from any source (YouTube, Spotify, games, etc.)

4. Press Ctrl+C to stop

The light will automatically sync colors and brightness to your audio!

Auto-start with Windows

Option 1: Use the installer script (recommended)

# Run the install script (double-click or run in terminal)
install_startup.bat

To remove from startup:

uninstall_startup.bat

Option 2: Manual

1. Press Win + R, type shell:startup, press Enter
2. Create a shortcut to yeelight_tray.pyw in that folder

License

MIT License - feel free to use and modify.

Contributing

Pull requests welcome! Please keep it simple and focused.