PLAIT(1)

🎧 PLAIT(1) — the plait manual, bestie edition 👑

okay so first things first: this is the manual page for plait, living in section 1 (User Commands). Yes it's a real manual, yes it's rendered in your terminal, yes we're gonna read it together like it's a group chat. 💅

🌸 NAME 🌸

Plait — Command-line Jukebox. that's it. that's the whole name section. a jukebox. in your terminal. iconic behaviour honestly 🎀

✨ DESCRIPTION ✨

So the vibe is: you talk to plait, it plays music. The manual gives you the usage like this, and I'm quoting it exactly because the syntax is doing A LOT:

"plait <hint about artist or album or song> [[not] <hint>]...[as <mix>]", or "plait --stream <hint> [[not] <hint>]..."

Right?? Two whole flavours of usage in one line, it's giving overachiever. You either hit it with a hint about an artist or album or song, stack up more hints (and you can say not before a hint if you want to exclude that vibe), and optionally finish with as <mix> — or you go the streaming route with --stream <hint> and more hints after it. 🦋

💖 OPTIONS 💖

One bullet per option, no skipping, no summarising, we do not cut corners in this house. Here's every single one:

• --list, -l — show the tracks that match, but don't play them. just lookin'. 👀
• --mix, -m — play every track that matches any of your hints. we're making a mix, bestie. 🔥
• --queue, -q — add tracks to the queue instead of just firing them off.
• --random, -r — play in random order. chaos mode, but make it curated. 🎲
• --sort — play in sorted order. very organised of you. ⭐
• --stripe — play in alternating order.
• --stripe2 — play in random alternating order. stripe but make it a lil unpredictable.
• --fade — play in gaussian fade order. math girlies rise 🌈
• --group — play randomly in groups.
• --tracks, -t — play n tracks, if possible. (n is a placeholder, don't @ me.)
• --stream, -s — play Shoutcast radio streams. 📻
• --mixfile, -f — read your hints from a mixfile instead of typing them out.
• --device, -d — choose the target device.
• --platform — choose the platform.
• --coverart — cover art mode, and it takes 0 or 1.
• --guest, -g — use the guest configuration. for when someone else is on aux 🫶
• --interactive, -i — interactive mode.
• --cache, -c — rebuild the cache.
• --install — install Plait.
• --uninstall — uninstall Plait. (sad.)
• --play — the manual literally just lists it with no explanation, so all I can tell you is: it exists. 💀
• --pause — again, no description given in the original. it's there. that's the tea.
• --stop — same deal, listed with no notes. 🙈
• --next — also no description in the source. we simply do not know more than the flag itself.
• --prev — no description either. it's listed, and that's all the manual gives us.
• --help — show help. your bestie when you forget everything above. 🎀
• --version — show version.

Not me having to say "no description given" five times in a row 😭 but fr fr, I'm not making stuff up about --play, --pause, --stop, --next or --prev — the original manual lists them bare, so bare they stay. The facts do not move. periodt.

👑 AUTHOR 👑

Written by Stephen Jungels (http://stephenjungels.com/contact). we love a credited icon. 💜

🌈 COPYRIGHT 🌈

Copyright © 2005-2008 by Stephen Jungels. Released under the GPL. Latest version and more info at http://plait.sourceforge.net/ — go look, it's right there. ✨

and that's the whole page, bestie!! 🦋 this was Plait v 1.6.2, from way back in September 2008 — an elder icon serving terminal jukebox realness, and we're still reading its manual today. mwah. 💅💖