build-live...ugin-multi(1)

✨ NAME ✨

build-lives-rfx-plugin-multi — bestie, this one builds rendered effects for LiVES 💖

It lives in section 1 of the General Commands Manual, so it's a real-deal user command, not some dusty library thing. 🎀

---

🌸 SYNOPSIS 🌸

build-lives-rfx-plugin-multi type [scripts_dir exec_dir] [build_bindir]

---

🦋 DESCRIPTION 🦋

Okay so this is a perl script, and what it does is build rendered effects (RFX) plugins for LiVES. That's the whole vibe. 🫶

Here's the tea on how it figures out where stuff lives: if scripts_dir isn't defined, then type gets used to locate both the plugin scripts directory and the output directory. Two birds, one little type argument. 💅

And what can type even be?? Glad you asked, bestie:

• builtin — the default, no thoughts needed ✨
• custom — you're doing your own thing 🎀
• test — testing hours 🧪
• builtinx — this one is special: it forces scripts_dir and exec_dir to be read straight from the parameters. It's the one used during LiVES install, and it is the only type you should ever use if scripts_dir is specified. Not optional. Periodt. 👑

So like, every plugin script in the input directory gets scanned to find its language code — and then the script gets handed off to the script compiler for that language. 🔥

Where's that compiler at, though? The directory location of the script_compiler can be specified with the build_bindir parameter (this is exactly what happens during LiVES installation, iykyk). If you don't do that, the script just goes looking through your $PATH. 🕵️‍♀️

💀 Return Values 💀

The script comes back with these, and you should lowkey memorize them:

• 0 — success, we ate 🍓
• 1 — the type parameter was not defined, or it was set to an invalid value 🙈
• 3 — the builder for a plugin script was not found 😭

Ngl, if you get a 3, something in your language setup is missing. Not a vibe. Go find that builder.

---

🌈 SEE ALSO 🌈

• build-lives-rfx-plugin(1)
• lives(1)

---

👑 AUTHOR 👑

Gabriel Finch a.k.a Salsaman (salsaman@xs4all.nl) 💜

---

And that's a wrap, bestie!! This icon of a page is from the General Commands Manual, dated May 9 2010 — shoutout to that era. Go build some rendered effects, you absolute main character. 🦋✨