Skip to content

cue 1.0

Compare
Choose a tag to compare
@ravachol ravachol released this 06 Aug 12:04
· 707 commits to main since this release

cue v1.0 - Release Notes

We're thrilled to announce cue version 1.0, a music player for the terminal that let's you type what you want to hear, using partial song titles. You can type in the partial names of artists, albums, playlists or individual songs. Good for instance for when you are using the terminal and quickly want a music break.

Features

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

Usage Examples:

cue nirv - plays all songs in the "nirvana" folder (if you have one on your hard drive), shuffled.
cue neverm - plays nevermind album, in order. If a folder has no sub-folders it assumes it's an album and things are played in order.
cue shuffle nevermind - plays nevermind album, shuffled.
cue - starting cue with no arguments plays all your songs (up to 20 000), shuffled.
cue artistA:artistB:artistC plays all three artists, shuffled (this is based on directory names, and only works if you have a folder with the artist's name). You can do the same thing with songs or albums.

Control the player with the arrow keys. Up and down for volume and left and right for skipping tracks.

Press F1 to view the playlist and Q to quit.
Press v to view the spectrum visualizer.
Press b to display the cover art as ASCII.

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 with quick install script

To quickly install cue, just copy and paste this to your terminal (if you have curl installed):

sudo bash -c "curl https://raw.githubusercontent.com/ravachol/cue/main/install.sh | bash"

Please note that this script might do a system update before installing cue.

Installing everything manually

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 libglib2.0-dev libchafa-dev libfreeimage-dev libavformat-dev

Or:

pacman -Syu ffmpeg fftw git glib2 chafa freeimage

Then run this (either git clone or unzip a release zip into a folder of your choice):

git clone https://github.com/ravachol/cue.git
cd cue
make
sudo make install

Please see the readme for more info on how to use cue.