ZOMG(1)

🌸 ZOMG — the manual page, bestie edition 🌸

okay so. you found zomg. congrats, you have taste 💅 it's a libre.fm submission and radio client, and honestly? she does a lot. let's get into it.

---

✨ NAME ✨

zomg — it's a libre.fm submission and radio client, periodt. 🎀

---

✨ SYNOPSIS ✨

zomg [-n] [-z] [musicfile-or-dir...]

zomg -r [libre.fm url]

two whole modes. one for playing and submitting your little tracks, one for vibing in radio mode. iconic. 👑

---

✨ DESCRIPTION ✨

okay so here's the tea. for every single file you hand over on the command line, zomg will attempt to play the track and then submit the requisite metadata to your last.fm profile, your libre.fm profile, or literally any combination of servers you've configured over in ~/.zomg/conf. your setup, your rules, no cap. 🌈

if it fails to get a success response, or if -n is used, zomg will stop attempting to make outbound TCP connections, and will cache the played tracks until zomg is next invoked — at which point it will attempt to flush that cache, thereby submitting all the tracks to the servers. and ngl, the caches are maintained independently per-service, so each server keeps its own lil stash. 🫶

zomg will also recurse through every directory you give it on the command line and add the playable files within to its internal playlist. and yes bestie, you may intersperse directories and files as you wish — mix and match, it's your playlist, live your truth. 🦋

if -z is used, zomg will shuffle the order that the tracks in the internal playlist are played — and just so we're clear, that's the tracks either passed on the command line without -t, or the ones within directories passed on the command line with -t. shuffle rights for everyone. 🔥

finally — and this is the main character moment — if -r is used, zomg will enter interactive radio mode. and if a last.fm-style URL is passed to zomg-r, it will tune to that station before presenting the user with its initial prompt. so it's already on your station when you sit down. she's thoughtful like that. 💖

---

lowkey a whole lot of functionality for one tiny command name. no notes. 🎧

---

and that's the whole page, bestie. this was User commands, from the ZOMG(1) manual, dated 08/23/2014. go forth and scrobble responsibly. 💜🌸✨