gpsh(1)

📦
this version · 2 versions
  • nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking (latest)
  • opensuse-leap 16.0
, in nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 gpsh(1) — the hxtools girlie's guide to vibing your music library 💖

okay bestie, so this is gpsh, part of hxtools, and it's literally the main character of "find my songs and play them". Let's get into it 🎀

✨ NAME ✨

gpsh — select audio files by name and play them 💅

🦋 SYNTAX 🦋

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

🌸 DESCRIPTION 🌸

so gpsh is a utility that will search the current directory for audio/video files by matching their path and filename with regular expression patterns you drop on the command line, and then it feeds them to a multimedia player. that's the whole vibe. it's giving "grep but make it a DJ" 🎧✨

and it's not just basic — gpsh is capable of reading special tracklist files which contain subtrack names and their associated time positions. so like, mixes? handled. no cap. 👑

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 order between patterns is retained. so it shuffles inside each pattern, not across them. lowkey smart fr fr 🧚

💅 OPTIONS 💅

  • -F index.m9u — give the path to the master index file. and bestie, it's just a dump of the internal 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). iconic minimalism honestly 🌈
  • -OM,mplayer_opt — pass an extra argument to mplayer. yes, one extra arg, that's the deal ✨
  • -b — do index rebuild in foreground. no waiting in the shadows, we're doing this live 💀
  • -l — only grep the database. look, don't touch 🙈
  • -v — do print the playlist (can be very long). like, genuinely. very long. be warned bestie 😭
  • -x — ignore subtracks in a mix, and also avoid reindexing of VBR files. two-for-one ✂️
  • -z — do not shuffle the play queue / play back in lexicographic order. for the organized girlies 🎀
  • --loop n — passes the -loop option to mplayer. ⚠️ note that the option has two dashes for gpsh — that's the tea, don't get it twisted ☕

🎀 INDEX 🎀

gpsh keeps an index cache, and refreshes it in the background when it is older than a day. very self-care of it honestly 🌸

if there is no index yet, playing files will be delayed until it exists. so like, be patient, it's building the vibe 🫶

directories and files whose name without extension ends in "_noindex" will be skipped. periodt. 💅

🌈 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", tracklist: "DJ Doboy - Trancequility volume 01.tls", TL content: "[48:29] Paul van Dyk - For an angel".

the way that .tls file is literally just holding the timestamps for you... chef's kiss 👑✨

gpsh uses a Perl regular expression search across file name (mix name, if any) and subtrack name. so you can just describe the vibe and it finds it 🦋

Example:

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

would cause gpsh to search for all PVD tracks in Doboy's Trancequility mixes. and then mplayer will be invoked on "DJ Doboy - Trancequility volume 01.mp3" with automatic seeking to position 48:29, for example. like. it just knows. 🔥

🍓 EXTRA OPTIONS 🍓

gpsh -OM,-af-clr chillout

will invoke mplayer instances with the "-af-clr" option. that's it, that's the trick 💜

🫶 SEE ALSO 🫶

hxtools(7)

okay that's the whole page bestie, go forth and play your music 💖✨

this one came from hxtools, dated 2015-03-11, and yeah it's gpsh(1) — take care of her, she's iconic 🎀🌈💅

📦 where this page comes from