roarlight(1)

📦 version 1.0~beta12, in ubuntu jammy

💡 roarlight — the manual page bestie 💡

okay so this is roarlight(1), a page from the System User's Manual, and it's genuinely iconic. it lives in the same family as the other RoarAudio tools and it's here to let you boss around the Light Control subsystem of RoarAudio. lights. actual lights. we're controlling hardware vibes from a terminal. periodt. ✨

🌸 NAME 🌸

roarlight — controls the Light Control subsystem of RoarAudio 🎀

like, the name literally tells you what it does. no notes. she's honest. she's direct. she's a light controller. 💅

✨ SYNOPSIS ✨

roarlight [OPTIONS]... command [command...]

so yeah, you give her some [OPTIONS]... then a command, and then, plot twist, you can keep stacking more commands after it. she'll do them in order. it's giving to-do list but the tasks are LIGHTS. 🦋

💖 DESCRIPTION 💖

okay so real talk: this command works simular to roarctl, except instead of messing with the normal audio controls, it controls actual data on the Light Control subsystem. 🪩

so if roarctl is your volume bestie, roarlight is your lighting bestie. different department. same energy. she's not here to talk about your mixer levels (well—okay, she has a --mixer option, but you know what I mean), she's here to make the lights go brrr. 🔥

🎀 OPTIONS 🎀

one bullet per option, bestie, I would never skip one:

  • --server SERVER — set the server hostname. tell her which server to talk to. 🖥️
  • --mixer MIXERID — the ID of the light mixer you wanna use. pick your mixer, girl. 🎚️
  • --help — show this help. the classic. the comfort blanket. 🫶

👑 COMMANDS 👑

these are the things she'll actually do. you can chain them, remember? command, command, command, like a little playlist. 💜

  • help — show this help. yes, again. she's not judging. 😌
  • sleep TIME — sleeps for TIME seconds. literal nap break. she's resting, you're resting, the lights are resting. self-care fr fr. 😴
  • sset chan=val — set a DMX channel. give her chan=val and she's on it. 🌈
  • set chan=val — same as the sset command. literally the same thing, just a shorter name. pick whichever one your fingers like better. 💅
  • event EVENT — send event EVENT to the server. go tell the server something. she's the messenger. 💌
  • @FILE — read commands from FILE, or from stdin in the case of @-. yesss, script it. write a whole list of commands in a file and let her run them all. and if you pass @-, she reads from stdin instead. cinematic. 🎬

🦋 SEE ALSO 🦋

go read her friends, they're all slaying too:

📜 HISTORY 📜

for history information, see RoarAudio(7). that's where the lore lives. 🧚

okay that's the whole page, you ate it, you understood it, you're a lighting engineer now. obsessed with you. 💖

and a lil sign-off: this page is part of the RoarAudio manual set, dated January 2010. yeah, 2010. she's vintage, she's timeless, she's still controlling lights. 💜✨

📦 where this page comes from