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

FreeBSD Manual Pages

  
 
  

home | help
gpsh(1)				    hxtools			       gpsh(1)

Name
       gpsh -- select audio files by name and play them

Syntax
       gpsh [-F	index.m9u] [-OM,opt] [-blvxz] patterns...

Description
       gpsh  is	 a  utility  that  will	 search	 the current directory for au-
       dio/video files by matching their path and filename  with  regular  ex-
       pression	 patterns presented on the command line, and feeding them to a
       multimedia player. gpsh is capable of reading special  tracklist	 files
       which contain subtrack names and	their associated time positions.

       When no pattern is given, all entries are selected. By default, all en-
       tries  which matched a particular pattern are played back in random or-
       der, but	order between patterns is retained.

Options
       -F index.m9u
	      Give the path to the master index	file. It is just a dump	of the
	      internal array state in Perl form, so M9U	is not exactly a  for-
	      mat  of  its  own.  This index contains: filename, and title and
	      offset (for subtracks inside mixes).

       -OM,mplayer_opt
	      Pass an extra argument to	mplayer.

       -b     Do index rebuild in foreground.

       -l     Only grep	the database.

       -v     Do print the playlist (can be very long).

       -x     Ignore subtracks in a mix, and  also  avoid  reindexing  of  VBR
	      files.

       -z     Do  not  shuffle the play	queue /	play back in lexicographic or-
	      der.

       --loop n
	      Passes the -loop option to mplayer. Note that the	option has two
	      dashes for gpsh.

Index
       gpsh keeps an index cache, and refreshes	it in the background  when  it
       is  older  than	a day. If there	is no index yet, playing files will be
       delayed until it	exists.	Directories and	files whose name  without  ex-
       tension ends in "_noindex" will be skipped.

Tracklists for mixes
       gpsh  scans  all	 .tls files for	the following pattern used to denote a
       subtrack	in a big mix of	the same basename:

       /^\[(?:(+):)?(+):(+)\](.*)/

       Example:	Audio file: "DJ	Doboy -	Trancequility volume  01.mp3",	Track-
       list:  "DJ  Doboy  - Trancequility volume 01.tls", TL content: "[48:29]
       Paul van	Dyk - For an angel".

Regex search
       gpsh uses a Perl	regular	expression search across file name (mix	 name,
       if any) and subtrack name.

       Example:	gpsh 'doboy.*trancequility.*paul.van.dyk'

       Would  cause gpsh to search for all PVD tracks in Doboy's Trancequility
       mixes. mplayer will be invoked on  "DJ  Doboy  -	 Trancequility	volume
       01.mp3" with automatic seeking to position 48:29, for example.

Extra options
       gpsh -OM,-af-clr	chillout

       Will invoke mplayer instances with the "-af-clr"	option.

See also
       hxtools(7)

hxtools				  2015-03-11			       gpsh(1)

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

home | help