Prismriver Lyrics 1.0.0: CLI и TUI для поиска текстов песен

1000px.jpg

Вышла первая версия 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

>>> Репозиторий на GitHub

Linux.org.ru прочитано 887 раз