MAXXLORR TRACKER 4.87 - STARTUP OPTIONS
=====================================

Pass options in the URL, not after the HTML filename as executable arguments.
Both forms below are supported:
  index.html?help
  index.html#mlt:help

Combine options with &. Bare boolean options mean on; on/off, true/false,
yes/no and 1/0 are accepted. URL-encode spaces and nested URL values.

  index.html?file=demo.xm&play&position=0&row=16&track=2
  index.html#mlt:view=mix&theme=graphite&scale=100&edit=off

Windows PowerShell:
  Start-Process 'file:///C:/MLT/index.html#mlt:help'
  Start-Process 'file:///C:/MLT/index.html#mlt:view=mix&scale=100'

Options
-------
help                 List all options in a full-window PowerShell-style console.
version              Display the application version.
console              Keep the startup console open after setup.
file=URL_OR_PATH     Open MLT, XM, IT, MOD, S3M, MID or MIDI using the menu importer.
play                 Start playback after import and configuration.
position=0..65535    Zero-based sequence position, bounded by the loaded song.
row=0..1023          Zero-based starting row, bounded by the chosen pattern.
track=1..64          Select an existing track and its rack.
instrument=1..128    Select an existing instrument.
sample=1..16         Select an existing slot in the selected instrument.
view=MODE            pattern, instrument, sample or mix.
rack=MODE            fx, track or master.
scale=50..125        Interface percentage in steps of five.
theme=ID             See theme identifiers below.
edit=on|off          Initial Edit mode.
lock-follow=on|off   Pattern Lock follow.
sequence-follow=on|off  Automatic sequence centering.
left-panel=STATE     open or closed.
right-panel=STATE    open or closed.
agc=on|off           AGC setting for the loaded song.

Aliases: h -> help, open -> file, autoplay -> play.
Themes: midnight, graphite, emerald, crimson, violet, teal, amber, rose,
mono, arctic, paper, mint, solar, cobalt, plum, contrast.

Behavior
--------
Help/version display the console without loading the requested file or starting
playback. The normal tracker initialization completes first; import follows;
explicit options are then applied. Missing options retain normal defaults or
the imported project settings. Unknown, duplicated and malformed options are
reported in the console before settings are applied. Song-specific selections
are validated after import. Nothing silently clamps an out-of-range selection.

Scale and theme use the normal controls and save their preferences. AGC changes
the loaded project. Other initial selection/view options follow the ordinary
UI model. No language option is implemented in this release.

Files
-----
On an HTTP(S) page, relative URLs load relative to the HTML URL. Remote URLs
require successful browser access and appropriate server CORS headers. Downloads
are streamed with a 128 MiB limit and a 30-second timeout. Executable/data URL
schemes are rejected. This is not a general-purpose network or shell client.

A file:// page cannot automatically read arbitrary local paths. A local file
argument displays the requested path and a file picker in the startup console.
Once the user selects a file, the same import/configuration/play sequence resumes.
Browser permissions are respected. Browsers do not expose desktop argv to HTML.

MIDI imports retain the normal bank-selection workflow. Startup options do not
silently download or replace sound banks beyond that existing import behavior.

Playback
--------
position/row use the canonical cursor transport, including sample auto-seek.
Speed and the song timing model are preserved. If audio initialization is blocked
by autoplay policy, the console offers Start playback and waits for a click.
Pending audio initialization does not schedule duplicate music playback.

Console commands: help, version, run, clear, close. They control this application
only; no Windows command, JavaScript string or external program is executed.

Maintenance and checks
----------------------
source/launch.js owns the typed catalogue, parsing, console and one-shot startup
orchestration. Its catalogue generates the runtime help. source/build-launch.cjs
embeds it in the existing canonical initialization module, without a new script
tag, polling loop, MutationObserver or renderer wrapper. Startup executes after
the window's existing DOMContentLoaded initialization handlers.

tests/launch.cjs checks parsing, validation, help priority, full-window layout,
settings, sequence/sample selection, local and intercepted HTTP imports,
XM/IT/MOD/S3M importer dispatch, playable transport, and recovery from deliberately
blocked initialization. The HTTP fixture is intercepted locally; this is not a
claim that every external host permits CORS. See launch-results*.json and the
embedded-guide screenshot for the executed Chromium/Firefox results.