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
Choose an entry point by purpose
Section titled “Choose an entry point by purpose”| What you want to do | Operation to use |
|---|---|
| Write a new storyboard script | New Storyboard Script |
| Open an existing script document | Import Text / Markdown |
| Automate project operations with Lua | Open a script from the Gallery or the project |
Edit a storyboard script
Section titled “Edit a storyboard script”- Open Scripts from Panels.
- Create a script with New Storyboard Script, or import a text or Markdown file.
- Edit it in the open tab, using Find and text-size controls as needed.
- Save it and confirm that the change remains in the script row or tab.
Run Lua automation
Section titled “Run Lua automation”- Save the project and create a file snapshot before running anything.
- Open a script from the Gallery or the project.
- Read the source and identify the layers, frames, or files it can change.
- Use
Lintto check its syntax and APIs. - Run it with
Run. - Inspect the changed scope. If the result is not intended, undo before saving or restore the snapshot.
If a script cannot be opened or run
Section titled “If a script cannot be opened or run”| Message or symptom | Check this first |
|---|---|
| “No Scripts Attached” | Open a script from the Gallery or create a storyboard script. |
Lint reports an API error | Remove operations that are reported as sandboxed or unavailable. |
| Running it causes no visible change | Check the target layer, frame, selection, and other prerequisites expected by the script. |
| Running it makes an unintended change | Do not save; undo or restore the snapshot created beforehand. |
Main controls
Section titled “Main controls”| Control | What it does |
|---|---|
| New / Import | Creates a storyboard script or imports text or Markdown |
| Syntax Highlighting | Color-codes Markdown or script syntax |
| Decrease / Increase text size | Changes the editor’s display text size |
| Close Tab / Close Others / Close All | Organizes open scripts |
| Edit / Find / Lint | Edits and searches source data and checks syntax and APIs |
| Save / Run | Saves to the project or runs Lua automation |
Use scripts safely
Section titled “Use scripts safely”- 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.
Related articles
Section titled “Related articles”Verification
Section titled “Verification”- 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