cue

Listen to music in the terminal.

cue is a command-line music player for Linux.

Features

Search a music library with partial titles
Creates a playlist based on a matched directory.
Display album covers as ASCII art or as a normal image.
Control the player with previous, next and pause.
Gapless playback.
Supports 24-bit/192khz audio.

Installing

On Arch Linux, and Arch-based distributions, cue can be found in the AUR. Install with pamac or an AUR helper like yay:

yay cue-git

That's it!

Installing normally

cue dependencies are:

FFmpeg
FFTW
Chafa
FreeImage
glib2.0 and AVFormat. These should be installed with the others, if not install them.

Install FFmpeg, FFTW, Chafa and FreeImage using your distro's package manager. For instance:

apt install ffmpeg libfftw3-dev git libchafa-dev libfreeimage-dev libavformat-dev

Or:

pacman -Syu ffmpeg fftw git chafa freeimage

Then run:

git clone https://github.com/ravachol/cue.git

cd cue

make

sudo make install

A TrueColor capable terminal is recommended, like Konsole, kitty or st, to display colors properly.

For a complete list of capable terminals, see this page: Colors in Terminal (github.com).

Usage

First thing to do is to tell cue the path to your music library (you only need to do this once):

cue path "/home/joe/Music/"

Now run cue and provide a partial name of a track or directory:

cue cure great

This command plays all songs from "The Cure Greatest Hits" directory, provided it's in your music library.

cue returns the first directory or file whose name matches the string you provide.

Some Examples:

cue (starting cue with no arguments plays all songs (up to 10 000) in your library, shuffled)

cue moonlight son (finds and plays moonlight sonata)

cue moon (finds and plays moonlight sonata)

cue beet (finds and plays all music files under "beethoven" directory)

cue dir <album name> (sometimes it's neccessary to specify it's a directory you want)

cue song <song> (or a song)

cue list <playlist> (or a playlist)

cue shuffle <album name> (shuffles the playlist)

cue artistA:artistB:artistC (plays all three artists, shuffled)

cue --help, -? or -h

cue --version or -v

cue . (loads the main cue playlist, see 'Other Functions')

Other Functions:

Use ↑, ↓ keys to raise or lower volume.
Use →, ← keys to play the next or previous track in the playlist.
Space to toggle pause.
F1 to see the playlist and information about cue.
e to toggle the spectrum visualizer.
c to toggle album covers.
b to toggle album covers drawn in ascii or as a normal image.
r to repeat the current song.
s to shuffle the playlist.
a add current song to main cue playlist.
p to save the currently loaded playlist to a m3u file in your music folder.
q to quit.

License

Licensed under GPL. See LICENSE for more information.

jothi-prasath / cue

cue