HARP(1) User Commands HARP(1)NAMEharp - play and manage music
SYNOPSISharp [options]
OPTIONS-t, --type=[type]
Specify the type of object to perform an action on. Required for
insert, list, or play. Valid types are: [s]ong, [p]laylist,
a[r]tist, [a]lbum, [g]enre, [t]ag.
-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 commands}
Edit information stored in the database.
-e, --edit-stdin
Edit information stored in the database. Commands will be
accepted over stdin.
--old-edit
Edit information stored in the database using the deprecated
portal interface.
-l, --list=[unique name | id]
List information from the database. Use with no argument to dis‐
play 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.
-r, --repeat[number of repeats]
When combined with the play option, repeat the generated
playlist indefinitely or the specified number of times.
-D, --device={device name}
When combined with the play option, output audio to the speci‐
fied device.
-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 song statistics.
-v, --verbose
Print debug messages. Call more than once for more messages.
--version
Print version information.
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, sub‐
stitute '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)
a Add song(s) to the temporary playlist currently playing. By
default, the songs will be added to the location directly fol‐
lowing the current song. Songs can be specified by name, ID, or
all songs by particular artists, albums, or genres may be added
using a similar syntax to the edit menu. :a [s | a | r | g]
[unique name | id]. (e.g., :a r special_artist)
ao Specify the destination of the added songs. (e.g. To add
special_song at order 12, :ao 12 s special_song)
r Remove song(s) from the temporary playlist currently playing.
Syntax is the same as the add command.
ro Remove a single song at the specified order.
w Save the current playlist. This command will overwrite any
playlist previously saved with this command.
FILES
~/.harp/defaults.conf
HARP user configuration file
/usr/local/share/harp/defaults.conf
Default HARP configuration file
EXAMPLESharp-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 ver‐
bose output.
HARP 0.6.0 July 2015 HARP(1)
