Table of Contents

Name

harp - play and manage music

Synopsis

harp [options]

Options

-t, --type=[type]
Specify the type of object to perform an action on. Required for insert, edit, list, or play. Valid types are: [s]ong, [p]laylist, a[r]tist, [a]lbum, [g]enre.
-i, --insert={song path | directory}
Insert song(s) into the database. By passing a directory as an argument, HARP will recursively scan the directory and insert all valid files. Use with no argument to enter information at a prompt.
-e, --edit
Edit information stored in the database.
-l, --list={unique name | id}
List information from the database. Use with no argument to display all entries.
-s, --shuffle{s | a | r}
When combined with the play option, shuffle the selected songs. The given argument will determine whether songs, albums, or artists are shuffled.
-z, --zshuffle
When combined with the play option, shuffle the selected songs with statistical modifiers.
-p, --play=[unique name | id]
Play the songs listed under the name or id in the specified type
-a, --admin
Enter the admin utility to manage plugins and song statistics.
-v, --verbose
Print debug messages. Call more than once for more messages.

Player Controls

q
Quit
n
Next
N
Next without updating play statistics
p
Restart song
9
Volume down
0
Volume up
m
Mute
,
Seek backward
.
Seek Forward
[space]
Pause
r
Decrease rating
R
Increase rating
:
Enter advanced player command prompt.

Advanced Player Commands

l
List the contents of the current playlist. Provide a numerical argument (e.g., :l25) to specify the maximum number of songs printed. The default value is 30.
lh
List from the head of the playlist.
lt
List from the tail of the playlist.
lr
List from the current position the playlist. (default)
j
Jump to a new position in the playlist. Provide a numerical argument (e.g., :j34) to specify the location. The jump has an effect similar to next (i.e., increased skip count). To jump without updating the play statistics for the skipped song, substitute ’j’ with ’J’.
js
Jump to a location based on SongID.
jo
Jump to a location based on Order. (default)
,
Seek backward a specified number of seconds. (e.g., :,50)
.
Seek forward a specified number of seconds. (e.g., :.50)

Files

~/.harp/defaults.conf
HARP user configuration file
/usr/local/share/harp/defaults.conf
Default HARP configuration file

Examples

harp -ts -s -p1,43,SongName,2
Plays the four selected songs in shuffled order.

harp -v -i ~/music/
Inserts the songs located under the ~/music/ directory with verbose output.


Table of Contents

Links


Project hosted by:
Get HARP at SourceForge.net. Fast, secure and Free Open Source software downloads