README.md

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.

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!