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
	      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

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 ver-
	      bose output.

HARP 0.6.0			   July	2015			       HARP(1)

NAME | SYNOPSIS | OPTIONS | PLAYER CONTROLS | ADVANCED PLAYER COMMANDS | FILES | EXAMPLES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=harp&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help