Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

VLC Lyrics Finder

VLC Media Player lyrics extension. Supports MetroLyrics, Sonic Hits, Lyrics Mode,, AZ Lyrics, and

Lyrics Finder 0.3.0 on Linux


For version 0.3.7 and later, VLC 3.0 or higher is required. The last version compatible with VLC 2.x is 0.3.6.

  1. Download lyricsfinder.lua 0.3.7 for VLC 3 or lyricsfinder 0.3.6 for VLC 2 (Use File -> Save as if necessary).
  2. Move the file lyricsfinder.lua to lua/extensions inside your VLC folder. For example, C:\Program Files\VideoLAN\VLC\lua\extensions\lyricsfinder.lua
  3. To install the language files, put them inside your VLC folder in the subdirectory lua/extensions/lyricsfinder/locale. For example, C:\Program Files\VideoLAN\VLC\lua\extensions\lyricsfinder\locale
  4. Restart VLC or open Tools -> Plugins and extensions and hit reload extensions.

VLC folder path:

  • Windows: *C:\Program Files\VideoLAN\VLC\lua\extensions*
  • macOS: ~/Library/Application\ Support/org.videolan.vlc/lua/extensions/
  • Linux user path: /home/$USER/.local/share/vlc/lua/extensions
  • Linux system path: /usr/share/vlc/lua/extensions


  1. Go to View -> Lyrics Finder.
  2. Make sure title and artist are correct.
  3. Hit Get Lyrics.

Other buttons:

  • Search with Google: open a new browser tab to look for lyrics
  • Save lyrics: save lyrics to a TXT file in /tmp or C:\Temp
  • Switch: artist and title wrongly guessed? Click this button to switch them. The artist text becomes the title text, the title text becomes the artist text.

When you open Lyrics Finder, an attempt will be made to get the lyrics of the song. When the song changes, starting from 0.3.7, Lyrics Finder will attempt to find lyrics for the current song.

Intelligent guessing

Since version 0.3.0, this script supports intelligent guessing. This means that when you name your files properly, it will detect the artist and song title from the filename. Good examples of file names:

  • Artist - Title (year of release) -> Steve Allen - Letter From My Heart (1984)
  • Artist - Title -> Steve Allen - Letter From My Heart
  • Artist - Title (anything): the information between parenthesis is discarded
  • Artist-Title: also works without spaces before and after the hyphen

Wrong file names:

  • Title - Artist
  • File names that contain two hyphens, like "Artist - Title - Album name". There is one exception: artist names that contain a hyphen are valid. For example "A-ha - Stay On These Roads".

If your files contain metadata, Lyrics Finder uses that information. Otherwise, it uses intelligent guessing.


Lyrics Finder gets its lyrics from several websites. If Lyrics Finder is unable to find lyrics for your song, verify that you comply with the Intelligent Guessing Format (see above) or make sure that you have proper metadata tags attached to your files.

With so many sites supported, it's still imaginable that the lyrics for a specific song are not yet available. You can add them yourself using MetroLyrics or using LyricsMode.


If you would like to make a translation of Lyrics Finder to your own language, follow these steps:

  1. Make an account at Transifex
  2. Start translating

If the language you want to translate is not present, make an issue asking to add the desired language or request a language on Transifex.

See also

  • LyricsCore, a lyrics API written in PHP. It fetches the lyrics text from many lyrics websites.
You can’t perform that action at this time.