Skip to content

README.md

Latest commit

 

History

History
69 lines (47 loc) · 1.48 KB

README.md

File metadata and controls

69 lines (47 loc) · 1.48 KB

🎵 Verse

A simple command-line tool that fetches lyrics for your music collection and prints a random lyric line. Just like the classic fortune command, but for your songs.

Options

✨ Features

  • 🔍 Automatically fetches lyrics for your local music directory (optional).
  • 🎲 Picks a random lyric line and prints it to the console.
  • 🎤 Optional flags to show artist and/or song title (currently parses filename, metadata support coming soon).

📦 Installation

Clone the repository

git clone https://github.com/rexept/verse.git
cd verse

Dependencies required:

Taglib (C), Mutagen(Python)

Install with your local package manager.

To use the lyrics downloader:

Edit these lines in the python script to your desired directories (defaults shown):

MUSIC_DIR = os.path.expanduser("~/music")
LYRICS_DIR = os.path.expanduser("~/.lyrics")

Compile verse locally

make LYRICS_DIR=<your lyrics directory here, defaults to $HOME/.lyrics>

Or install globally

sudo make LYRICS_DIR=<your lyrics directory here, defaults to $HOME/.lyrics> install

🚀 Usage

verse [FLAGS]

Basic Example

verse --show-artist

Output:

The Beatles
And in the end, the love you take is equal to the love you make.

Thanks to termshot for the amazing command screenshot!