Command-Line Usage

FrameLift's own command-line handling is intentionally minimal — the host consumes only one argument and forwards the rest to plugins.

Opening a file or URL

The first non-flag argument is treated as a file path or URL to open at startup:

FrameLift "C:\clips\demo.mkv"
FrameLift "https://example.com/stream.m3u8"

Arguments beginning with - are skipped by the host, and unknown flags do not interfere with opening the target.

Everything else goes to plugins

At startup — after every plugin has loaded and subscribed — the host publishes the entire command line verbatim as a CliCommandEvent (argv[0] is the program name). The host itself only acts on the first positional argument; any plugin can subscribe and interpret the remaining arguments as its own subcommands, flags, or batch/analysis tasks, without the host needing to know about them.

This means the available flags depend on which plugins are installed. For plugin authors, the event is documented in the SDK Events reference.