Skip to content

Latest commit

 

History

39 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lyrics Viewer for macOS

A beautiful, ultra-smooth, full-screen terminal UI for viewing synced lyrics of the currently playing Apple Music or Spotify song. Built with Go, Bubble Tea, and Lip Gloss.

Features

  • Live Syncing: Lyrics automatically scroll along with Apple Music or Spotify.
  • Ultra-Smooth Progress Bar: Interpolates time and utilizes fractional Unicode blocks (8x resolution) for a continuously gliding progress bar.
  • Responsive Design: The album artwork, lyrics view, and layout automatically adapt dynamically to your terminal window size.
  • Album Artwork: Fetches and renders high-quality album art directly in your terminal using ANSI block characters.

Install

Homebrew

brew install moKshagna-p/tap/lrc

This installs both lrc and its lyrics alias. brew install lrc becomes available once the formula is accepted into Homebrew/core.

From source

go install github.com/moKshagna-p/lrc/cmd/lrc@latest
ln -sf "$(go env GOPATH)/bin/lrc" "$(go env GOPATH)/bin/lyrics"

Usage

Simply run lyrics in your terminal while Apple Music or Spotify is playing a song. If both are playing, Apple Music is shown. Press Q or Ctrl+C to quit.

Acknowledgements

  • The original version was prototyped with Python and rich.
  • Lyrics provided via the excellent lrclib.net API.
  • Artwork provided via the iTunes Search API.

About

Full-screen terminal UI for synced Apple Music lyrics with album art

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages