pimpd2 - Perl Interface for the Music Player Daemon 2
pimpd2 is a command-line based MPD client that implements all the features the author was missing from the other awesome client, mpc.
Show basic song information on a single line.
Show all available song information and MPD server status.
Copy the currently playing song to destination.
If destination is omitted, uses the target_directory variable from the configuration file.
target_directory
Copy the currently playing album to destination.
Spawn the interactive pimpd2 shell.
All the regular features can be used. Commands that return data that can be added to the current playlist will do so automagically for convenience, since we can not read from standard input while being interactive.
Queue tracks. Arguments must be valid playlist position IDs as shown in the --playlist output.
--playlist
You can also use the --search-playlist command if the tracks to be queued follows a pattern.
--search-playlist
Show the current playlist.
List all playlists known by MPD.
Add files to the current playlist.
Can read from standard input:
pimpd2 --randomize 42 Nirvana | pimpd2 -af
Accepts file arguments:
pimpd2 -af ~/music/Nirvana/Bleach/*.flac
Add playlist to the current playlist.
If not given a full name, and the name partially matches existing playlists, prompts for input:
pimpd2 -a 2010 0 2010-12-indie 1 2010-12-other 2 2010-12-pop 3 2010-12-punk_rock 4 2010-12-rock 5 2010-12-undef choice:
If choice equals 'all', all matching playlists are added.
Return n random songs from the collection. The first argument is the number of songs, the second argument is an optional artist name. If an artist name is specified, will only return random songs from that particular artist.
If no arguments are specified, returns 100 random songs.
If you want to add the results to the current playlist, pipe it to --add-files:
--add-files
pimpd2 -r 12 | pimpd2 -af
Or use the interactive shell ( -sh ) which does this for you automatically.
-sh
Return n random full albums.
A pipe to --add-files will add the results to the current playlist.
Given a string, searches the current playlist for matching albums, and remove them from the playlist. The string can be a regular expression.
Delete the current album from disk.
Favorize, or love, the current song.
If called with zero arguments, the song will be saved to a playlist following this naming scheme:
%year-%month-%genre.m3u
Else, the argument is used for the playlist name, thus:
pimpd2 --love lovesongs
adds the song to lovesongs.m3u
Check if the currently playing song is already loved or not.
Unlove songs matching given PATTERN.
Lists available playlists.
Search the database with loved songs for PATTERN.
If PATTERN is omitted, returns all loved songs.
Search the current playlist for string, possibly a regular expression.
If more then one song is found, queues up the results. See --queue.
--queue
List all songs on album.
If no argument is specified, use the album tag from the currently playing song.
A pipe to --add-files will add the results to the current playlist:
pimpd2 -lsa Stripped | pimpd2 -af
List all albums where artist is featured.
If no argument is specified, use the artist tag from the currently playing song.
Search the database for string, possibly a regular expression.
Search the database for artist.
Search the database for album.
Search the database for title.
Display statistics about MPD
Display MPD status
Play the next track in the playlist.
Play the previous track in the playlist.
Clear the current playlist.
Remove all songs but the current one from the playlist.
Set crossfade.
Toggle playback status.
Toggle repeat on/off
Toggle random on/off
Start playback.
If a remote stream URL and an external player is specified in the configuration file, starts playback on the local machine as well as on the MPD server.
Stop playback, locally and remote.
Stop local playback.
-np, --now-playing basic song info on a single line -i, --info full song info -cp, --copy copy the current track optional argument: destination -cpa, --copy-album copy the current album optional argument: destination -sh, --shell spawn the interactive shell -q, --queue queue tracks
-pls, --playlist show the current playlist --playlists list all known playlists -af, --add-files add files to playlist -a, --add-playlist add playlist --randomize randomize a new playlist with n tracks. optional arguments: quantity, artist -ra, --random-album add n random full albums. optional arguments: quantity, artist -rma, --rmalbum remove album matching pattern from playlist -da, --delete-album delete the current album from disk -f, --love love song --loved check if the current song is loved -u, --unlove unlove songs matching pattern -spl, --search-playlist search the current playlist for str
-lsa, --songs list songs on album -l, --albums list albums by artist optional argument: artist -sdb, --search-db search database for pattern -sar, --search-artist search database for artist -sal, --search-album search database for album -set, --search-title search database for title --slove search the database with loved songs for pattern --stats display statistics about MPD --status display MPD status
-n, --next next track in playlist -p, --previous previous track in playlist -cl, --clear clear the playlist -cr, --crop remove all songs but the current one from playlist -x, --xfade set crossfade --pause toggle playback status --repeat toggle repeat mode --random toggle random mode -p, --play start playback (locally and remote) -s, --stop stop playback (locally and remote) -k, --kill stop playback (locally) -h, --help show the help and exit -m, --man show the manual and exit -v, --version show version info and exit
pimpd2 will look for a configuration file in the following locations, in this order:
$XDG_CONFIG_HOME/pimpd2/pimpd2.conf ~/.config/pimpd2/pimpd.conf ~/.pimpd2.conf ./pimpd2.conf /etc/pimpd2.conf
Magnus Woldrich CPAN ID: WOLDRICH m@japh.se http://japh.se
None required yet.
Report bugs and/or feature requests to <m@japh.se>, on rt.cpan.org or http://github.com/trapd00r/pimpd2/issues.
Copyright 2009, 2010, 2011 the pimpd2 "AUTHOR" and "CONTRIBUTORS" as listed above.
This application is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
mpd(1)
App::Pimpd::Collection::Album, App::Pimpd::Collection::Search, App::Pimpd::Commands, App::Pimpd::Doc, App::Pimpd::Info, App::Pimpd::Player, App::Pimpd::Playlist, App::Pimpd::Playlist::Favorite, App::Pimpd::Playlist::Randomize, App::Pimpd::Playlist::Search, App::Pimpd::Shell, App::Pimpd::Transfer, App::Pimpd::Validate
To install App::Pimpd, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::Pimpd
CPAN shell
perl -MCPAN -e shell install App::Pimpd
For more information on module installation, please visit the detailed CPAN module installation guide.