Skip to content
Command Line Karaoke.
Go Makefile Dockerfile
Branch: master
Clone or download
jessfraz update travis
Signed-off-by: Jess Frazelle <>
Latest commit 9a4b0bb May 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
karaoke fix release Sep 14, 2018
lyrics new cli pkg Jul 17, 2018
midi update vendor Jan 2, 2018
version update generated project files Jan 1, 2018
.gitignore update makefile Sep 25, 2018
Makefile Update ToC for Dec 29, 2018
VERSION.txt toc Dec 29, 2018
go.sum update vendor Sep 25, 2018
main.go new cli pkg Jul 17, 2018
main_unix.go update vendor Jan 2, 2018


Travis CI GoDoc

Command Line Karaoke

Table of Contents



For installation instructions from binaries please visit the Releases Page.

Via Go

$ go get



  • Download fluidsynth and soundfonts on debian this was fluid-soundfont-gm.
Via Docker
$ docker run --rm -it \
    --device /dev/snd \
    jess/cliaoke hard_knock_life
DJ cliaoke on the request line.
Bringing up the track Hard Knock Life...


This assumes you have setup fluidsynth in the following way:

(grab a copy of from one of the mirrors in

$ brew install fluidsynth
$ unzip
$ mkdir -p /usr/local/share/fluidsynth
$ mv GeneralUser\ GS\ 1.44\ FluidSynth/GeneralUser\ GS\ FluidSynth\ v1.44.sf2 /usr/local/share/fluidsynth/generaluser.v.1.44.sf2

Running cliaoke with no arguments will list all the available songs. Once downloaded the songs are saved in a ~/.cliaoke/ directory.

Caveats for Mac Users

  • You must install fluidsynth according to the instructions below.
  • Sometimes the search for lyrics selects the wrong one, whomp whomp.
  • The lines being printed are not synced with the song. (maybe there is a way to parse the lyric metadata from a .mid file?)


$ cliaoke -h
cliaoke -  Command line karaoke.

Usage: cliaoke <command>


  -d  enable debug logging (default: false)


  version  Show the version information.

List all songs

NOTE: This does not mean you have all these files locally, when you choose a song (if you have no already downloaded it from this repo) it will be downloaded for you.

$ cliaoke
COMMAND                             TITLE                               ARTIST
1979                                1979                                Smashing Pumpkins
99_ways_to_die                      99 Ways To Die                      Megadeth
hard_knock_life                     Hard Knock Life                     Jay-Z
missing_you                         Missing You                         Puff Daddy
mo_money_mo_problems                Mo Money Mo Problems                Notorious BIG

Play a song

$ cliaoke mo_money_mo_problems
DJ cliaoke on the request line.
Bringing up the track Mo Money Mo Problems...


You can’t perform that action at this time.