mvc

Minimal MPD music visualizer, based on curses. Works by reading the fifo output of an MPD instance.

Requirements

No external dependencies other than GCC (or another C99 compatible compiler).

Optional: libmpdclient to display current status (song / elapsed time / etc).

The fifo output of MPD needs to be enabled. To do so, simply place this in your mpd.conf:

audio_output {
    type                    "fifo"
    name                    "my_fifo"
    path                    "/tmp/mpd.fifo"
    format                  "44100:16:1"
}

Building

Clone the repo:

git clone https://fragal.eu/git/fra/mvc
cd mvc/

Build with status display (requires libmpdclient):

make all

Note: without libmpdclient installed, this is equivalent to 'make nostatus'.

Build without status display (no external dependencies):

make nostatus

Install (to /usr/local/bin/):

sudo make install

Usage

An instance of MPD must be running for mvc to work.

From a console / terminal emulator:

mvc

Quitting: Press q.

Configuration

Editing settings.h allows the configuration of:

• Host, Port, Timeout and DB location of the mpd instance
• Timeout for the connection to mpd to fail
• Number of samples taken each read
• Location of the MPD named pipe (fifo) from which mvc reads.
• Seconds in between each status refresh
• Niceness: number of reads to be skipped cyclically (reduces load on the cpu)
• Y_Correction: integer value to be subtracted to the components in case the height of the screen wasn't sufficient
• X_Correction: lateral shift in case the visualized spectrum is not perfectly aligned with the center of the screen.