pimp

A music player project for unix aficionados; designed especially to facilitate a screen-free, numpad-controlled playback experience for your vehicle's audio system.

Prerequisites

As pimp is a wrapper and not a standalone program, the prerequisites are as follows:

Program	Minimum Version	Version Standing	Purpose
fzf	0.38.0	Hard Requirement	Music Selection
mpv	0.33.0	Hard Requirement	Music Playback
espeak	1.48	Tested	Text-to-Speech
sox	14.4.2	Tested	Sound Generator

Commands

Default Action

Resume music playback of cached playlist file (pimp play) and display recursive list of subdirectories to play within default music directory or $PIMP_DPATH_MUSIC (pimp dir) once playback ends.

% pimp

dir, d [-q] [query]

Display recursive list of subdirectories to play within default music directory or $PIMP_DPATH_MUSIC.

-q	Disable selection tone and text-to-speech (tts).

% pimp d
% pimp d deep house
% pimp d -q
% pimp d -q deep house

file, f [query]

Display recursive list of files to play within default music directory or $PIMP_DPATH_MUSIC.

% pimp f
% pimp f mixes 199 fm new york

play, p, slap [-qs]

Resume music playback of cached playlist file.

-q	Suppress initialization tone.
-s	Shuffle cached playlist content.

% pimp p
% pimp p -q
% pimp p -s
% pimp p -qs
% pimp play
% pimp slap

Documentation is in development!