https://github.com/stutstev/pimp
Music player (fzf + mpv) designed for screen-less, numpad-controlled playback on the Raspberry Pi for car and home stereo use. 🐡🐧
https://github.com/stutstev/pimp
audio car car-stereo cars cli fzf fzf-scripts house-music linux mpv music music-player openbsd raspberry-pi
Last synced: about 1 month ago
JSON representation
Music player (fzf + mpv) designed for screen-less, numpad-controlled playback on the Raspberry Pi for car and home stereo use. 🐡🐧
- Host: GitHub
- URL: https://github.com/stutstev/pimp
- Owner: stutstev
- License: mit
- Created: 2022-12-04T02:15:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-02T13:01:33.000Z (8 months ago)
- Last Synced: 2025-03-30T10:01:41.821Z (about 1 month ago)
- Topics: audio, car, car-stereo, cars, cli, fzf, fzf-scripts, house-music, linux, mpv, music, music-player, openbsd, raspberry-pi
- Language: Shell
- Homepage:
- Size: 778 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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.
```shell
% 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).
```shell
% 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`.
```shell
% 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.
```shell
% pimp p
% pimp p -q
% pimp p -s
% pimp p -qs
% pimp play
% pimp slap
```
Documentation is in development!