Skip to content

Use scripts

Verification record: Umoupen 0.9.49 build 530 (2026-08-24) · Verification scope

An automation script is a program that expresses operations as executable code. Lua is the language used to write that code; an API lets a program call application features. Lint checks aspects such as syntax before execution. This is a separate use from writing structured text in Markdown.

Open Lua automation scripts and Markdown or text storyboard scripts inside a project. Storyboard writing and automation that can change the project are separate uses within the same panel.

Location: Panels → Show Panels → Scripts

What you want to doOperation to use
Write a new storyboard scriptNew Storyboard Script
Open an existing script documentImport Text / Markdown
Automate project operations with LuaOpen a script from the Gallery or the project
  1. Open Scripts from Panels.
  2. Create a script with New Storyboard Script, or import a text or Markdown file.
  3. Edit it in the open tab, using Find and text-size controls as needed.
  4. Save it and confirm that the change remains in the script row or tab.
  1. Save the project and create a file snapshot before running anything.
  2. Open a script from the Gallery or the project.
  3. Read the source and identify the layers, frames, or files it can change.
  4. Use Lint to check its syntax and APIs.
  5. Run it with Run.
  6. Inspect the changed scope. If the result is not intended, undo before saving or restore the snapshot.
Message or symptomCheck this first
“No Scripts Attached”Open a script from the Gallery or create a storyboard script.
Lint reports an API errorRemove operations that are reported as sandboxed or unavailable.
Running it causes no visible changeCheck the target layer, frame, selection, and other prerequisites expected by the script.
Running it makes an unintended changeDo not save; undo or restore the snapshot created beforehand.
ControlWhat it does
New / ImportCreates a storyboard script or imports text or Markdown
Syntax HighlightingColor-codes Markdown or script syntax
Decrease / Increase text sizeChanges the editor’s display text size
Close Tab / Close Others / Close AllOrganizes open scripts
Edit / Find / LintEdits and searches source data and checks syntax and APIs
Save / RunSaves to the project or runs Lua automation
  • Run only scripts whose source and actions you can verify.
  • If the source accesses external files or a network, inspect those targets before running it.
  • Results vary by script. Test unfamiliar automation on a duplicate project first.
  • Hands-on verified: Verified the Scripts panel entry point in build 530.
  • Verified from the current implementation: Verified Lua automation, storyboard scripts, Markdown and text import, syntax coloring, text size, tab controls, editing, Search, validation, saving, and running in the current implementation.
  • Unverified: The complete public API, results from running individual scripts, and the Windows version were not verified.
  • Evidence records: F-20260822-011, F-20260823-001, F-20260824-003