ScriptWeaver View source

Install & run

Get the Player

Download the Player for your platform from scriptweaver.dev/download. It's a single, self-contained binary — there is nothing else to install (no Node.js, Python, or Tcl).

The Player is free and open source (MPL-2.0); you're welcome to redistribute it alongside your apps.

Verify your download. Official builds are signed — compare the published SHA-256 sum with your file:

# Linux / macOS
shasum -a 256 scriptweaver

# Windows (PowerShell)
Get-FileHash scriptweaver.exe

Run an app

Run a script directly:

scriptweaver myapp.js

Or run a packaged app — a .zip containing a main.js plus any assets:

scriptweaver myapp.zip

See Packaging apps for how to build a bundle.

Command-line flags (CLI options)

Flag Effect
--light Use the default light theme, cerculean (alias for --theme light).
--dark Use the default dark theme, superhero — the default (alias for --theme dark).
--theme <name> Start in a named theme (light/dark or any ttkbootstrap theme). See Theming.
--list-themes Print the available theme names and exit.
--trace Print the underlying Tk commands to stderr — handy when debugging.
--help, -h Open the help viewer with the ScriptWeaver docs (what you're reading). Pass a .zip or project directory to view that app's bundled help instead.

Run with no arguments at all to get the interactive shell.

scriptweaver --theme cosmo myapp.js

For the complete reference — every flag plus the pack / bake build subcommands — see the Command-line reference.

The interactive shell (REPL)

Start the Player with no file and you get an interactive JavaScript shell plus an empty window:

scriptweaver

Type code and watch the window change live — the quickest way to explore the widget API:

const b = app.Button({ text: 'Hi', onClick: () => sw.dialog.alert('hi') });
b.pack.configure({ padx: 30, pady: 30 });

Next