FreeBSD Manual Pages
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 audio/video files by matching their path and filename with regular expression 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 entries which matched a particular pattern are played back in random order, but or- der between patterns is retained. Options -F index.m9u Give the path to the master index file. It is just a dump of the in- ternal array state in Perl form, so M9U is not exactly a format 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 order. --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 extension ends in "_noindex" will be skipped. Tracklists for mixes gpsh scans all .tls files for the following pattern used to denote a sub- track in a big mix of the same basename: /^\[(?:(+):)?(+):(+)\](.*)/ Example: Audio file: "DJ Doboy - Trancequility volume 01.mp3", Tracklist: "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)
Name | Syntax | Description | Options | Index | Tracklists for mixes | Regex search | Extra options | See also
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.1.quarterly>