A sleek, lightweight, and customizable "Now Playing" overlay for Windows 10/11. It displays the current song's title, artist, and album art with a smooth animated waveform and fade effects.
Preview:
- Modern UI: Rounded corners with a transparent background (no jagged edges).
- Animated Waveform: A smooth, sine-wave animation that syncs with the song's progress.
- Dynamic Metadata: Automatically fetches cover art, title, and artist from Windows Media Controls (Spotify, YouTube, SoundCloud, etc.).
- Smart Visibility: - Appears automatically when the song changes or pauses/plays.
- Fades out smoothly after a few seconds of inactivity.
- Soft Rendering: Anti-aliased lines and borders for a high-quality look.
- Python 3.10+
- Windows 10 or Windows 11 (Required for
winsdk)
- Clone the repository:
git clone [https://github.com/your-username/media-overlay.git](https://github.com/your-username/media-overlay.git) cd media-overlay - Install dependencies:
start setup.bat
Simply open the start.bat file:
start start.batIf you want close the app you can open stop.bat:
start stop.bat
The overlay will appear on the top-left of your screen (customizable) whenever you play music on Spotify, Chrome, or any supported media player.
You can adjust the settings at the top of main.py:
WINDOW_W = 340 # Width of the popup
POS_X = 20 # Horizontal position
POS_Y = 80 # Vertical position
TIMEOUT_SECONDS = 4 # How long it stays visible
FADE_SPEED = 0.08 # Fade animation speedThis project is licensed under the MIT License - see the LICENSE file for details.
