Blog

Thoughts, tutorials, and insights

plugins/

September 23, 2026•6 min read

Lua 5.4 embedded

Omadesign 0.5.8 embeds Lua 5.4.9 and plugin API 1 inside the Linux packages. There is no separate runtime to install. An update leaves the plugins you already installed in place.

omadesign0.5.8plugins

September 23, 2026•6 min read

Manage plugins

Plugins → Manage plugins installs a .lua file, a folder with main.lua, or an .omaplug bundle. Each plugin has an Enable checkbox. An update keeps a hidden backup of the previous folder. Reload after you edit.

omadesign0.5.8plugins

September 23, 2026•6 min read

Studio starter twelve

Studio starter ships twelve Lua actions on first install. A duotone, a shadow, an SVG icon, two brushes, a canvas tool, a pattern, a gradient, a palette, a batch nudge, and two behaviors that stay off until you opt in.

omadesign0.5.8plugins

September 23, 2026•5 min read

Plugin categories

Plugin actions declare a category. Filters, effects, icons, brushes, tools, behaviors, batch, patterns, gradients, and swatches each have a precondition, and the manager groups them that way.

omadesign0.5.8plugins

September 23, 2026•5 min read

Opt-in behaviors

Document and selection behaviors ship off. One checkbox opts in, remembers the choice, and a behavior’s own output does not fire itself again.

omadesign0.5.8plugins

September 23, 2026•5 min read

Host API surface

API 1 is a short list of oma calls. Shapes, fills, effects, brushes, palettes, SVG, pixels, and a status message. Each run gets a fresh Lua VM.

omadesign0.5.8plugins

September 23, 2026•5 min read

Plugin CLI batch

omadesign --plugin and --batch walk every immediate .oma in filename order, write new files, keep the inputs, and refuse a path that already exists.

omadesign0.5.8plugins

September 23, 2026•4 min read

Install list plugins CLI

omadesign --install-plugin and --list-plugins run without a window. Brush, palette, and canvas tools still belong to the desktop. Document commands batch from the shell.

omadesign0.5.8plugins

September 23, 2026•4 min read

Plugin sandbox limits

A plugin cannot run programs, open the network, or read arbitrary files. The caps are 15 seconds, 64 MiB of Lua heap, and 20,000 edits. This release has no plugin marketplace.

omadesign0.5.8plugins

September 23, 2026•4 min read

Starter source path

After install, the clean Studio starter tree is at ~/.local/share/omadesign/plugin-examples/studio-starter. Fork the repo, add a folder under plugins/, and open a pull request with the proof.

omadesign0.5.8plugins

September 23, 2026•4 min read

Plugins without ExtendScript tax

0.5.8 runs Lua plugins inside the binary. Filters, effects, icons, brushes, tools, patterns, gradients, swatches, and a batch command. One undo. No separate runtime.

omadesign0.5.8plugins