cli-music-player-cthulhu 0.5.0

A lightweight terminal music player with mpv engine and auto-setup

CLI Music Player

A lightweight, terminal-based music player written in Python, featuring a pulsing Cthulhu and online lyrics support.

Features

• Terminal User Interface (TUI): Clean interface built with curses.
• Online & Synced Lyrics: Automatic lyrics fetching from LRCLIB, Letras.mus.br, and Lyrics.ovh.
• File Browser: Navigate directories to find your music.
• Recursive Library Mode: Scan all subdirectories and play your entire collection at once.
• Shuffle Mode: Randomized playback with a history-aware "Previous" function.
• Audio Formats: Supports mp3, wav, flac, ogg, m4a, wma, aac, opus.
• Playback Controls:
  • Play / Pause / Stop
  • Next / Previous Track
  • Volume Control
  • Progress Bar with Synced Lyrics highlighting.
• Now Playing View: Dedicated screen showing track info, progress, and Cthulhu/Lyrics.

Requirements

• Python 3.8+
• Audio output device.

Installation

Via PIP (Recommended)

Install directly from PyPI:

pip install cli-music-player-cthulhu

From Source

1. Clone the repository:

   git clone https://github.com/thiagofmendonca/cli-music-player.git
   cd cli-music-player
   

2. Install dependencies:

   pip install pygame mutagen
   

3. Run the script:

   python musicplayer.py
   

Usage

Run the command from your terminal:

musicplayer

Controls

Key	Action
Arrow Up/Down	Navigate files / Scroll Lyrics
Enter	Play file / Open directory
Space	Play / Pause
l	Toggle Lyrics View
n	Next Track
p	Previous Track (History-aware)
z	Toggle Shuffle Mode
R	Load Recursive Library (all subfolders)
B	Return to Browser Mode
+ / -	Volume Up / Down
Tab	Toggle "Now Playing" View
s	Stop
q	Quit (or go back from Player View)

License

MIT