Lyrify

Lyrify is a lightweight server that fetches and serves real-time song lyrics for tracks playing on Spotify using playerctl.

Additional scripts to fetch lyrics.

How It works

• Fetches song lyrics (plain or synchronized) from the Lrclib API.
• Displays the current line of lyrics via a local HTTP endpoint.
• Caches API results to reduce redundant requests (~/.cache/lyrify).

Requirements

• Go (1.23+)
• Spotify desktop client running

Installation

Build Artifacts in releases/tags.

1. Clone this repository:

   git clone https://github.com/yourusername/lyrify
   cd lyrify

2. Build the binary:

   go build -o lyrify

3. Run the program:

   ./lyrify

Usage

1. Start Lyrify:

   ./lyrify

   The server starts on port 8888 by default.

2. Access the current line of lyrics via:

   curl -s http://localhost:8888/line

3. Ensure Spotify is playing a track. The /line endpoint will return:

   • Plain lyrics: Current line based on playback duration.
   • Synchronized lyrics: Accurate line based on timestamps.
   • 🎼 if no lyrics are found or the track is instrumental or podcast.

Configuration

• The server listens on port 8888 by default. You can change this by setting the LYRIFY_ADDR environment variable:

  export LYRIFY_ADDR=":8080"
  ./lyrify