Files
community-plugins/lrc/README.md
T
f9dc0d4a03 lrc: add settings panel for separator (#172)
* added a basic settings panel

* fix lrc settings: nest translation keys and document settings in README

---------

Co-authored-by: shin01221 <mohamed@madin372.com>
2026-07-31 08:17:56 -04:00

1.1 KiB

LRC

thumbnail

Displays current song lyrics on the bar widget via lrc_tty. Works with MPD and Spotify.

Plugin

Field Value
ID shin/lrc
Entries Bar widget: lrc

Requirements

  • lrc_tty — fetches synchronized lyrics over the network from the configured provider.
  • playerctl — reads MPRIS player status and metadata.

Usage

Enable shin/lrc in Settings → Plugins, then add the LRC bar widget. It displays the current lyric line when a track is playing.

The widget checks MPD first, then falls back to Spotify.

Settings

Key Type Default Description
show_separator bool true Prepend a separator before the lyric text.
separator string "| " Text shown before the current lyric line.

Spawned processes

  • playerctl — enumerates MPRIS players and queries playback status and metadata.
  • lrc_tty — fetches synchronized lyrics and outputs them.

Network access

lrc_tty connects to remote lyric APIs to fetch synchronized lyrics for the currently playing track.