loskutov / deadbeef-lyricbar

A simple plugin for DeaDBeeF audio player that fetches and shows the song’s lyrics
MIT License
29 stars 8 forks source link
cpp deadbeef lyrics plugin

Build Status

DeaDBeeF Lyricbar Plugin

A simple plugin for DeaDBeeF audio player that fetches and shows the song’s lyrics using track metadata and user-provided lyric fetchers.

Screenshot

Inspired by Infobar Plugin. If you need more functionality, check my fork of it, containing a few bug-fixes and minor improvements.

Dependencies

To use this plugin, you need to have gtkmm installed. It is available in the repositories of most modern distributions (e.g. in Ubuntu you'll have to install libgtkmm-3.0-dev for the gtk3 version of lyricbar).

You need deadbeef.h file to build this plugin. The file /usr/include/deadbeef/deadbeef.h should've been installed with the player itself. If not -- look for deadbeef-plugin-dev package, or something like this. Or get the file from a source tarball.

Installation

Clone this repository and perform the following:

make [gtk2 or gtk3]
sudo cp *.so /usr/lib/deadbeef # depends on where deadbeef is installed
# OR, to install for the current user only
mkdir -p ~/.local/lib/deadbeef && cp *.so ~/.local/lib/deadbeef

Usage

Activate Design Mode (View → Design mode) and add Lyricbar somewhere. Disable Design Mode back and enjoy the music :)

In addition, if your tracks don't contain enough metadata, external lyrics providers can be used (see plugin preferences, the script launch command can use the whole DeaDBeeF title formatting power, it's supposed to output the lyrics to stdout). However, I recommend tools like beets to have the lyrics inside the tracks' metadata.

Development Status

The plugin is now abandoned, as DeaDBeeF developers act agressively towards Russian-speaking users (see the related commit). Besides, I haven't been actively developing it lately anyways. Hopefully, the archived version of the plugin is usable enough, though.