The first version of the Prismriver Lyrics project has been released. This project aims to develop a set of tools for searching song lyrics from various sources. The project consists of two packages that are built on a common search engine: the prismriver-lyrics console utility and the prismriver-lyrics-tui text interface, which is based on the Textual framework. The prismriver-lyrics-tui package has the ability to monitor player status via MPRIS, automatically start a search when a track changes, and highlight the current line for time-synchronized lyrics (LRC). The code is written in Python and distributed under the MIT license.
Main features of the project include:
- More than 30 plugins for searching song lyrics.
- Filtering results by plugin, language, original/translation, and synchronized/plain text. Users can also limit the number of results displayed.
- Time-synchronized texts (LRC) with highlighting of the current line in the TUI as the track is played.
- Manual search by title and artist in both the CLI and TUI.
- Navigation in the TUI in vim style.
- Ability to select a theme (standard from Textual).
- Disk results cache stored in SQLite, with a configurable lifetime and the option to disable it.
- The prismriver-lyrics package can be used as a library in Python projects.
Users can install both packages separately:
$ pip install prismriver-lyrics
$ pip install prismriver-lyrics-tui
To search for song lyrics from the command line, users can use the following command:
$ prismriver-lyrics --artist "The Clash" --title "Police and Thieves"
