Skip to content

A cross-platform application that let's you sing along to your favorite songs regardless the player by displaying the lyrics of the currently playing song on your desktop wallpaper, notification pane or in a locally hosted webpage.

Notifications You must be signed in to change notification settings

AnshulJ999/SyncLyrics

 
 

Repository files navigation

SyncLyrics

Description

A cross-platform application (focused on Windows) that let's you sing along to your favorite songs regardless the player by displaying the lyrics of the currently playing song on your desktop wallpaper, notification pane, terminal or in a locally hosted webpage.

Notes: Forked by me for personal use. It focuses on Windows 10 and Spotify desktop client. I can't guarantee it will work on other OS or other music players.

Main UI

Main UI

Minimal Mode

Minimal Mode can be accessed by adding ?minimal=true to the URL

Features

  • Real-time lyrics synchronization
  • Multiple display methods
  • Customizable appearance
  • Minimal mode for embedded view
  • Dark/Light theme support
  • Cross-platform support (Windows/Linux)

More are being worked on slowly.

For more information check the SyncLyrics' website! (Konstantinos' original project)

For linux playerctl is required

Run from source

python -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt
python sync_lyrics.py

If you don't want to create a virtual environment, you can install requirements and use run.bat to run the script in a hidden window.

Build

python build.py 

Known Issues from Original Project

  • Tray is partially broken (only default button works) on Linux in the compiled versions. (Works fine when running from source)
  • Notification library has an issue on windows, I believe it will be fixed soon, see open issue: samschott/desktop-notifier#95

Special Notes:

  • I'm not a dev, just an enthusiast. I had a special niche need for this, so I used AI (Claude) to help me understand the code and modify it to my needs.
  • All of the code edits are made by AI, so it's prone to bugs right now.

The license is the same as the original project.

Credits:

About

A cross-platform application that let's you sing along to your favorite songs regardless the player by displaying the lyrics of the currently playing song on your desktop wallpaper, notification pane or in a locally hosted webpage.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 58.7%
  • HTML 21.0%
  • JavaScript 10.3%
  • CSS 9.9%
  • Batchfile 0.1%