Name
harp - play and manage musicSynopsis
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,2Plays the four selected songs in shuffled order.
harp -v -i ~/music/
Inserts the songs located under the ~/music/ directory with verbose output.