Вышла первая версия v1.0.0 проекта Prismriver Lyrics — набора инструментов для поиска текстов песен из различных источников.
prismriver-lyrics-tui отслеживает состояние плеера через MPRIS, автоматически
запускает поиск при смене трека и подсвечивает текущую строку для
синхронизированных по времени (LRC) текстов.
Основные возможности:
- 30+ плагинов для поиска текстов песен (
prismriver_lyrics.plugins); - фильтрация результатов по плагину, языку, оригинал/перевод и
синхронизированный/обычный текст, а также ограничение числа результатов
(
--limit/-l); - синхронизированные по времени (LRC) тексты с подсветкой текущей строки в TUI; по мере воспроизведения трека;
- ручной поиск по названию и исполнителю в CLI и TUI;
- Vim-style навигация в TUI;
- выбор темы оформления (стандартные из Textual);
- дисковый кэш результатов на SQLite с настраиваемым временем жизни
(
--cache-ttl) и возможностью его отключить (--no-cache); - пакет
prismriver-lyricsможно использовать как библиотеку в своих Python-проектах (search_lyrics,LyricsResult,LyricsPlugin).
Проект написан на Python и
состоит из двух пакетов на общем движке поиска: консольной утилиты
prismriver-lyrics и TUI prismriver-lyrics-tui на базе фреймворка Textual.
Лицензия: MIT.
Установка (доступны оба пакета, можно ставить по отдельности):
$ pipx install prismriver-lyrics
$ pipx install prismriver-lyrics-tui
$ pip install prismriver-lyrics
$ pip install prismriver-lyrics-tui
$ uv tool install prismriver-lyrics
$ uv tool install prismriver-lyrics-tui
Поиск текста песни из командной строки:
$ prismriver-lyrics --artist "The Clash" --title "Police and Thieves"
Или запуск TUI, который сам следит за проигрывателем:
$ prismriver-lyrics-tui
