Back to main page

Lyricod

Lyricod Copyright (c) 2007 hashao License: GNU GPL version 3 or later.

Lyricod is a Linux Lyric Onscreen Display server for .lrc files.

It uses mpris (dbus for media player control) to communicate with the media players. Therefore, it should work with a lot of different kind of media players. WoW!

Lyricod is written in Python.

Compatibility

Lyricod should be compatible with any MPRIS enabled players. According to MPRIS site: XMMS2 BMPx VLC Amarok Audacious should be supported.

http://wiki.xmms2.xmms.se/index.php/Media_Player_Interfaces

Lyricod was developed using Audacious as the testbed. Audacious has mpris support since version 1.4.0.

Dependency

• Lyricod depends on pyosd and dbus-python binding.
• Optionally depends on python-gnome which provide gconf to save options.
• Optionally depends on pyinotify which provide directory alternation on Linux systems.
• Optionally depends on ttplyrics package which provide search and download lyric file from the internet.

Download

Download Here.

Usage

Put your .lrc files into the song directory or ~/lyrics/ directory and start the program.

The .lrc file should have the same name as the song file except has .lrc as extension. Although lyricod can guess some but don't bet your house on its intelligence.

If you have python-gnome installed, some options will be saved into gconf. You can access the options at /apps/multimedia/lyricod/. (Hint: Use gconf-editor to access gconf settings.)

Download Lyric from the web

If you want to automatically download lyric from the web, either install ttplyrics or download ttplyrics and copy the ttplyrics.py file in to Lyricod's source directory.

If the download is successful, a copy of the lyric will be saved into users lyrics directory or current song's directory. Future play the same song will not have to re-download the lyric again.

Screenshot

Misc

• lrc.py: This is a python lrc lyric module.
• lrcosd.py: This is a demo for play lrc files with xosd (X on screen display).

Hacking

You're welcomed to fork the codebase and add your own favourite features. But please read the GNU GPL license version 3 before you do that.

Other Lyric players

Seems there are enough lyric players out there already. I won't have written this one myself if I did proper research before I started scratching the itch. :( I feel stupid and I think I should stop now.

• ttplyrics
• lyriczilla
• LrcShow-II
• rebmp
• glyric: somewhere on the net
• xlyrics: somewhere on the net
• to be added...

News

• 2007-12-26:
• Version 0.3
• Add proxy support.
• Better filename match for lyric.
• Update character encoding support.
• Handle cookie for http.
• Make offset tag really work.
• Fix bug forward/rewind stop working after the last line of lyric displayed.

• 2007-12-07:
• Version 0.2.
• Support offset tag in the lrc file.
• Fix some lrc parsing bugs.
• Match lyric file better.
• Support download lyric file from internet using ttplyrics module.

• 2007-12-02:
• Version 0.1.
• Initial release.