XIL-GUI(1)

NAME
xil-gui - launch the xil-pipeline web dashboard (Gradio)

SYNOPSIS
xil-gui [-h] [--port PORT] [--host HOST] [--share]

DESCRIPTION
Opens a browser-based Gradio dashboard that supplements the CLI with four tabs:

Episodes
    Workspace overview — all detected episodes with parse/stems/DAW/master completion status.

Audio Preview
    Browse and play stems for any episode directly in the browser. Stems can be filtered by type (dialogue, sfx, music, ambience). Labels are enriched from the parsed JSON when available.

Run Stage
    Launch pipeline stages (parse, produce, assemble, daw, master) against a selected episode with live log streaming. Dry-run is on by default.

Timeline
    Embeds the interactive HTML timeline generated by xil-daw --timeline-html in an iframe. Prompts for generation when absent.

Requires the optional [gui] extra:

    pip install 'xil-pipeline[gui]'

OPTIONS

--port PORT
    Port to listen on (default: 7860)

--host HOST
    Host address to bind (default: 127.0.0.1)

--share
    Generate a public ngrok URL for partner access. The URL is open (no authentication) and valid for up to 72 hours. Suitable for trusted collaborator sessions only.

EXAMPLES

Open locally:
    xil-gui

Custom port:
    xil-gui --port 8080

Share with collaborators (generates public URL):
    xil-gui --share

Via unified dispatcher:
    xil gui

NOTES
The dashboard detects episodes by globbing cast_*.json files in the current working directory. Run from the project workspace root.

Audio files are served from the workspace via Gradio's allowed_paths mechanism. The --share tunnel streams audio through the ngrok relay.

Each Run Stage execution is an isolated subprocess. The dashboard remains responsive if a stage errors or is cancelled.

SEE ALSO
xil(1), xil-assemble(1), xil-daw(1), xil-produce(1)