rpld-tools(1)

✨ rpld-tools(1) ✨

okay bestie, welcome to rpld-tools, straight out of the System User's Manual 💖 this is the lil family of control programs for the RoarAudio PlayList Daemon, and yes we're gonna go through literally every single one. grab a snack 🍓

---

🌸 NAME 🌸

rpld-tools — RoarAudio PlayList Daemon control programs

---

🎀 SYNOPSIS 🎀

rpld-next --ifcurple PLE

rpld-ctl [COMMON OPTIONS] COMMAND [arg]

rpld-queueple [COMMON OPTIONS] [--pos {first|last|POS]] PLE [PLI]

rpld-listq [COMMON OPTIONS] [PLI]

rpld-setpointer [COMMON OPTIONS] POINTER PLE [PLI]

rpld-listplaylists [COMMON OPTIONS] [{--tree|--flat}]

rpld-import [COMMON OPTIONS] PLI TYPE FILE

---

💅 DESCRIPTION 💅

so the RoarAudio PlayList Daemon is, like, a daemon that manages playlists — and it can play files or streams from those lists using a RoarAudio Sound Server. very main character behavior honestly 👑

and this is a set of Perl based tools to do simple control of the server. no cap, that's the whole vibe.

here's every tool that's supported:

• rpld-next --ifcurple PLE — skips the current song. and here's the lil twist: if --ifcurple is given along with a PLE, the song only gets skipped if the currently played song matches that given PLE. conditional queen 💅
• rpld-ctl [COMMON OPTIONS] COMMAND [arg] — this one can alter different parts of the current rpld state. that includes the playback state and some playlist manipulation. she does it all fr fr.

the possible commands are:

• pause — pause playback.
• unpause — unpause playback.
• togglepause — if playback is paused, unpause; if it's not, pause.
• volume VOL — set volume to VOL. VOL has to be in the range 0%..100% or 0..65535.
• play — start playback.
• stop — stop playback.
• next — play next track.
• prev — play previous track.
• store — save current state to store.
• addplaylist PLAYLIST — add a new playlist.
• delplaylist PLAYLIST — delete a playlist.

• rpld-queueple [COMMON OPTIONS] [--pos {first|last|POS]] PLE [PLI] — queue the song PLE from playlist PLI. if no playlist is given, all playlists get searched 🔍 and a position for where to queue to can optionally be given.
• rpld-listq [COMMON OPTIONS] [PLI] — list the content of the queue, or of the given playlist PLI.
• rpld-setpointer [COMMON OPTIONS] POINTER PLE [PLI] — set pointer POINTER to a given target PLE. if no playlist (PLI) is given, the Main Queue is used.
• rpld-listplaylists [COMMON OPTIONS] [{--tree|--flat}] — list all known playlists. the listing is done in the correct tree view (that's the default) or as a flat view.
• rpld-import [COMMON OPTIONS] PLI TYPE FILE — import a playlist file FILE into a playlist PLI. the type of the file is given as TYPE.

---

🦋 COMMON OPTIONS 🦋

the following common options are supported, and yes they're supported by the tools above, that's the whole point bestie:

• --help — this option shows a brief help. we love a helpful icon 💖
• --server SERVER — this option sets the server to connect to. it overrides the defaults, so it's the one calling the shots.
• --queue QUEUE — this sets the default queue for the current process.

heads up: these are the common options. the per-tool flags like --ifcurple, --pos, --tree and --flat live with their own tools up in the synopsis, so don't go mixing them up 🙈

---

🌈 SEE ALSO 🌈

• rpld-deprecated(1)
• rpld(7)
• RoarAudio(7)

---

and that's the whole page, bestie!! 🫶 this was rpld-tools from the System User's Manual, dated May 2012, and it's giving vintage-but-timeless ngl. go forth and queue responsibly ✨🎀💜