Skip to content

Utility for mass-downloading LRC synced lyrics for your offline music library.

License

Notifications You must be signed in to change notification settings

tranxuanthang/lrcget

Repository files navigation

LRCGET

Utility for mass-downloading LRC synced lyrics for your offline music library.

LRCGET will scan every files in your chosen directory for music files, then and try to download lyrics to a LRC files having the same name and save them to the same directory as your music files.

LRCGET is the official client of LRCLIB service.

Download

🎉 Latest version: v0.3.2

Visit the release page to download.

OS Support:

  • Windows 10
  • Linux (Ubuntu 22.04 and AppImage build)
  • macOS

Known issues:

  • No support for macOS Apple Silicon.
  • The DEB build cannot be installed on Ubuntu 24.04. Please use the AppImage build instead for Ubuntu 24.04.

Screenshots

02.png

03.png

04.png

05.png

Donation

Toss a coin to your developer?

GitHub Sponsors (Recommended - 100% of your support goes to the developer):

https://github.com/sponsors/tranxuanthang

Buy Me a Coffee:

https://www.buymeacoffee.com/thangtran

Paypal:

https://paypal.me/tranxuanthang98

Monero (XMR):

43ZN5qDdGQhPGthFnngD8rjCHYLsEFBcyJjDC1GPZzVxWSfT8R48QCLNGyy6Z9LvatF5j8kSgv23DgJpixJg8bnmMnKm3b7

Litecoin (LTC):

ltc1q7texq5qsp59gclqlwf6asrqmhm98gruvz94a48

Troubleshooting

Audio cannot be played in Linux (Ubuntu and other distros)

Try to install pipewire-alsa package. For example, in Ubuntu or Debian-based distros:

sudo apt install pipewire-alsa

App won't open in Windows 10/11

If you are using Windows 10 LTSC, or have tried running some scripts to debloat Windows 10 (which will uninstall Microsoft Edge and its webview component), you might have issues as LRCGET depends on WebView2. Reinstalling Microsoft Edge might fix the problem (see issue #45).

Scrollbar is invisible in Linux (KDE Plasma 5/6)

The exact cause is still unknown, but it can be fixed by going to System Settings > Appearance > Global Theme > Application Style > Configure GNOME/GTK Application Style... > Change to something other than breeze (Awaita or Default) > Apply (see comment #44 (comment))

Contact

If you prefer to contact by email:

hoangtudevops@protonmail.com

TODO

  • Choose multiple directories
  • Support .ogg format
  • Embedded lyrics option (temporary alternative)
  • Optimize performance for loading large music library (#19)
  • Playlist Filter feature
  • Playlist Sort feature
  • Playlist Search feature
  • Volume control
  • Mark song as instrumental (#36)

Development

LRCGET is made with Tauri.

To start developing the application, you need to do the prerequisites steps according to your operating system.

For example, you need the following components to start the development in Windows:

  • Microsoft Visual Studio C++ Build Tools
  • Rust 1.64.0 or higher
  • NodeJS v16.18.0 or higher

Start the development window with the following command:

cd lrcget
npm install
npm run tauri dev

Building

Start the build process with the following command:

cd lrcget
npm install
npm run tauri build

Your built binaries are located at:

./src-tauri/target/release/

For more detailed instruction, follow the building guide to build the application according to your OS platform.