Skip to content

rexept/verse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 Verse

A simple command-line tool that fetches lyrics for your music collection and prints a random lyric line — 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!

About

Display a random line from your lyrics database.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •