Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HARP(1) 			  User Commands 			 HARP(1)

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 in-
	    sert,  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 argu-
	    ment, 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 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.

     -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  specified
	    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 argu-
	    ment  (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)

     a	    Add song(s) to the temporary playlist currently playing. By default,
	    the  songs will be added to the location directly following the cur-
	    rent song. Songs can be specified by name, ID, or all songs by  par-
	    ticular artists, albums, or genres may be added using a similar syn-
	    tax  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 spe-
		   cial_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

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.

HARP 0.6.0			    July 2015				 HARP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=harp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help