GM-Scriptorium · 0.5.0 desktop app · mock for review, before any build

GM-Scriptorium as a Windows desktop app

38 scenes: the installer with its new options and campaign pages, the tray icon and its menu, five toasts, the panel and preview changes, the terminal and the uninstaller. Updated for your board rulings of 14 Oct: every frame shows the option you chose. A dashed decision DTn tag marks which card set that part; the table below lists the choices.

New or changed in this worknot built / could drawn for the record, not in the buildWindows frames are drawn at desktop size and shrink to fit; pinch to zoom.
Board cardQuestionChosen 14 Oct (what every frame shows)Tagged on
DT1When the desktop app shipsB: hold 0.5.0 until the desktop app is built; 0.5.0 = installer, no-login update, update notice, desktop app and installer options not the recommendationW01
DT2How heavy the desktop part may beA: a small native tray helper beside the exe (the Architect picks the language)W08 U01
DT3gm-scriptorium with no arguments in a terminalA: start or reuse the background app, open the panel, give the prompt back. Note: a tray item "Open command line (Advanced)"C01 T02 C03
DT4Start with Windows defaultA: offered and ticked while this PC only; a warning line when remote access is onW03 T02 T03
DT5First-campaign answers in the installerA: installer asks name, vault, output; the program's own init --yes writes them; title and theme stay in the panelW04 W05 W05e W06 B01
DT6Remote access in the installerA (later): not in the installer; the browser-setup question is its own issueW04
DT7Panel portsFixed, the user can pick them; default 7400 (panel) and 7401 (preview) not the recommendationW03 T09 T10 N05 B05 B02
DT8Tray stop and update itemsB: Stop panel / Start panel, icon stays; Restart and Quit stay; Check for updates opens the Updates card not the recommendationT02 T08 T06
DT9Open the browser when it startsA: yes when you start it, quiet at sign-in (no toast)W09 N02
DT10Tray "Open site"A: "Open preview", explained as not the live site (tray line and a strip on the preview)T02 B06

Installer

Setup, page by page, for a first install that answers the campaign questions here (the W04 > W05 path). W06 is kept for the record but not built; W07 replaces W04 and W05 on an upgrade; W10 appears whenever the app is already running.

W01. Welcomeinstaller · NSIS welcome page

Scene 1 of 38W01 · Welcomeinstaller · NSIS welcome page
GM-Scriptorium 0.5.0 Setup
GM-Scriptoriumfor game masters

Welcome to GM-Scriptorium 0.5.0 Setup decision DT1

Setup will install GM-Scriptorium for you only. You don't need administrator permission.

GM-Scriptorium turns your gm-apprentice campaign vault into a website for your players. It runs quietly in the background on this PC, with an icon by the clock, and nothing leaves it unless you publish.

Click Next to continue.

GM-Scriptorium 0.5.0

The built welcome page with one new clause: GM-Scriptorium now runs in the background and lives by the clock. The version is 0.5.0: you chose to hold 0.5.0 until the desktop app is in it (DT1 = B).

W02. Install folderinstaller · as built

Scene 2 of 38W02 · Install folderinstaller · as built
GM-Scriptorium 0.5.0 Setup
Choose Install LocationChoose the folder in which to install GM-Scriptorium 0.5.0.

Setup will install GM-Scriptorium in the following folder. To install in a different folder, click Browse and select another folder. Click Next to continue.

Destination Folder
Space required: 96.4 MBSpace available: 212.6 GB
Installs for you only, inside your own user folder, so no administrator prompt appears.
GM-Scriptorium 0.5.0

Unchanged from the merged installer: same folder, same write probe on Next. Shown so the page order reads end to end.

W03. Optionsinstaller · custom options page

Scene 3 of 38W03 · Optionsinstaller · custom options page
GM-Scriptorium 0.5.0 Setup
Choose OptionsPick what Setup adds for you.
Always added. Find GM-Scriptorium by typing its name in Start.
A shortcut on your desktop.
It starts quietly in the notification area, with no window. Turn it off any time from its icon.
Lets you type gm-scriptorium in any terminal. Changes PATH for you only.
▾ Advanced decision DT7
Change these only if another program already uses them. Your panel will be at http://127.0.0.1:7400.
GM-Scriptorium 0.5.0

Start with Windows is new and ticked (DT4). A closed-by-default Advanced section (drawn open) holds the fixed ports, 7400 and 7401 unless you change them (DT7 = fixed, your note). This needs a custom nsDialogs page, since the built components page can't hold text fields. Setup doesn't test the ports; a busy port shows up at start (T09, N05). Desktop and PATH stay unticked. Finish keeps its run box, now "Start GM-Scriptorium now" (W09). Next goes to the campaign pages, or to W07 if settings already exist.

W04. Your first campaigninstaller · nsDialogs page

Scene 4 of 38W04 · Your first campaigninstaller · nsDialogs page
GM-Scriptorium 0.5.0 Setup
Your First CampaignTell GM-Scriptorium where your campaign lives, now or later.
A short setup with a preview of each theme. Nothing is written until you review it.
Campaign name, vault and output folder. Title and theme stay in your browser.
GM-Scriptorium opens on setup the next time you start it.
Your panel works on this PC only. To use it from a laptop or phone, see the remote access guide after Setup. decision DT6
GM-Scriptorium 0.5.0

New page. The browser path is the default, and every route keeps a skip. Remote access is not asked here (DT6: later, its own issue); one line points to the guide.

W05. Campaign detailsinstaller · nsDialogs page

Scene 5 of 38W05 · Campaign detailsinstaller · nsDialogs page
GM-Scriptorium 0.5.0 Setup
Campaign DetailsSetup checks these with GM-Scriptorium itself before it installs.
Lowercase letters, digits and hyphens. Used in commands and folder names.
Where your players' website is built. Must be outside the vault.

Site title comes from your vault, and the theme is gloam. Change either in the panel. decision DT5

GM-Scriptorium 0.5.0

Shown only when W04 says "answer here now" (DT5 option A). Name, vault (existing, or new plus game system) and output, with Browse buttons. Install runs the program's own init --yes check; NSIS never writes the settings.

W05e. Campaign details, refusedinstaller · same page, a refusal

Scene 6 of 38W05e · Campaign details, refusedinstaller · same page, a refusal
GM-Scriptorium 0.5.0 Setup
Campaign DetailsSetup checks these with GM-Scriptorium itself before it installs.
Lowercase letters, digits and hyphens. Used in commands and folder names.
This folder is inside your vault. Pick a folder outside it, such as C:\Users\Sam\Documents\long-lease-site.gm-scriptorium: refusing to build inside the vault: C:\Users\Sam\Documents\Campaigns\long-lease\site
GM-Scriptorium 0.5.0

Output folder inside the vault: a plain line plus the program's own one-line refusal (exit code 3), and nothing is written. Architect to solve: the refusal is shown either before or after the files are copied (NSIS can't run the program's checks before it is on disk). Drawn here as the before case.

W06. Title and theme (not built)installer · optional page

Scene 7 of 38W06 · Title and theme (not built) not built: DT5 = Ainstaller · optional page
GM-Scriptorium 0.5.0 Setup
Site Title and ThemeOptional. You can change both later in the panel.
What your players see at the top of every page. Taken from your vault.
A dark base with its own palette, ready to use as it is.
Smoky dark ground, brass headings, recaps on a parchment slip.
No theme CSS. Your campaign's own palette carries the look.
The panel shows each theme on your own pages before you choose.
GM-Scriptorium 0.5.0

Kept for the record only. You chose DT5 = A: title and theme stay in the panel, where the theme previews are, so this page is not built.

W07. Existing settings foundinstaller · upgrade or reinstall

Scene 8 of 38W07 · Existing settings foundinstaller · upgrade or reinstall
GM-Scriptorium 0.5.0 Setup
Your CampaignsSetup found your settings and won't change them.

Found 2 campaigns. Setup won't change them.

long-leasedefaultC:\Users\Sam\Documents\Campaigns\long-lease
harbour-watchC:\Users\Sam\Documents\Campaigns\harbour-watch

Settings file: C:\Users\Sam\AppData\Roaming\Scriptorium\config.toml

To add another campaign, use Campaigns in the panel.

GM-Scriptorium 0.5.0

On an upgrade or reinstall the campaign pages (W04 to W06) are skipped. Setup only reads the settings, honouring SCRIPTORIUM_CONFIG if set, and lists what it found. The config file is never modified.

W08. Installinginstaller · progress page

Scene 9 of 38W08 · Installinginstaller · progress page
GM-Scriptorium 0.5.0 Setup
InstallingPlease wait while GM-Scriptorium 0.5.0 is being installed.
Setting up long-lease
Output folder: C:\Users\Sam\AppData\Local\Programs\GM-Scriptorium
Extract: gm-scriptorium.exe... 100%
Extract: gm-scriptorium-tray.exe... 100% decision DT2
Created shortcut: Start menu
Start with Windows: on
Ports: panel 7400, preview 7401
Add to PATH: skipped
Setting up long-lease (gm-scriptorium init --yes)
Registered long-lease as your default campaign
GM-Scriptorium 0.5.0

Files first, then the program's own writer sets up the campaign. The log names the new tray helper (DT2: a small native helper; the Architect picks its name and language).

W09. Finishinstaller · NSIS finish page

Scene 10 of 38W09 · Finishinstaller · NSIS finish page
GM-Scriptorium 0.5.0 Setup
GM-Scriptoriumfor game masters

Completing GM-Scriptorium Setup

GM-Scriptorium is installed, and long-lease is set up.

It lives in the notification area, by the clock. Closing your browser doesn't stop it; use the icon's Quit when you want it off.

Click ^ by the clock to find it
Your browser opens on your panel, already signed in.
GM-Scriptorium 0.5.0

Finish starts the background app with no console window: the tray icon appears, then the browser opens signed in (DT9: open the browser when you start it yourself). If the browser-setup path was chosen, the browser opens on setup instead.

W10. GM-Scriptorium is runninginstaller · message box

Scene 11 of 38W10 · GM-Scriptorium is runninginstaller · message box
GM-Scriptorium 0.5.0 Setup

GM-Scriptorium is running. Setup will close it.

Everything you saved is on disk. If you tick "Start GM-Scriptorium now" at the end, it starts again.

Replaces today's "close the window, then Retry" box, since there is no window to close any more. Setup stops the tray app and its server the same way Quit does. Cancel leaves everything as it was.

Tray

The background app has no window. Its icon in the notification area is the whole interface: state in the tooltip and menu header, actions in the menu.

T01. The icon, in the overflowtray · notification area

Scene 12 of 38T01 · The icon, in the overflowtray · notification area
GM-Scriptorium: running, long-lease
Windows 11 puts a new icon here, under ^. Drag it onto the taskbar to keep it in view.

Hovering shows the tooltip with the state and campaign. Double-click opens the panel (a fresh signed-in tab); right-click opens the menu (T02). The Lantern reads on light and dark taskbars.

T02. Menu: running, this PC onlytray · context menu

Scene 13 of 38T02 · Menu: running, this PC onlytray · context menu
GM-Scriptorium 0.5.0Running · long-leaseThis PC only · 127.0.0.1:7400
Open panel
Open preview decision DT10
Only you can see it. Not your published site.
Stop panel decision DT8
Restart
Check for updates
Start with Windows decision DT4
Open command line (Advanced) decision DT3
Open log folder
Quit GM-Scriptorium

The everyday menu. Open preview carries a grey line saying it isn't the published site (DT10, your note). Stop panel turns the panel and preview off but keeps the icon (DT8 = B, see T08). Open command line (Advanced) opens a terminal ready for gm-scriptorium (DT3, your note; C03). Check for updates still opens the panel's Updates card.

T03. Menu: remote access ontray · context menu

Scene 14 of 38T03 · Menu: remote access ontray · context menu
GM-Scriptorium 0.5.0Running · long-leaseRemote: reverse proxyhttps://scriptorium.home.arpa
Open panel
Open preview
Only you can see it. Not your published site.
Stop panel
Restart
Check for updates
Start with Windows
Remote access is on, so it also listens for other devices from sign-in. decision DT4
Open command line (Advanced)
Open log folder
Quit GM-Scriptorium

Same menu when remote access was set up from the command line. The header names the mode and the address. Under Start with Windows, one warning line says it now listens for other devices from sign-in (the DT4 caveat).

T04. Menu: startingtray · context menu

Scene 15 of 38T04 · Menu: startingtray · context menu
GM-Scriptorium 0.5.0Starting · long-leaseOpening your vault
Open panel
Open preview
Only you can see it. Not your published site.
Stop panel
Restart
Check for updates
Start with Windows
Open command line (Advanced)
Open log folder
Quit GM-Scriptorium

For the few seconds before the panel is up (longer at sign-in if the vault is on a drive that is still connecting). Panel, preview, updates and Restart are greyed; the log, Start with Windows and Quit still work.

T05. Menu: can't reach your vaulttray · context menu, error state

Scene 16 of 38T05 · Menu: can't reach your vaulttray · context menu, error state
!
GM-Scriptorium 0.5.0Can't reach your vaultV:\campaigns\long-lease isn't connected.
Try again
Open log folder
Open panel
Open preview
Check for updates
Start with Windows
Open command line (Advanced)
Quit GM-Scriptorium

Start-up failed (here the vault is on a mapped drive, V:, not yet connected at sign-in). The icon gets a red badge, the menu leads with the one-line reason, Try again and Open log folder. A shortcut launch in this state shows the error toast (N03) instead of a second copy.

T06. Menu: update availabletray · context menu

Scene 17 of 38T06 · Menu: update availabletray · context menu
GM-Scriptorium 0.5.0Running · long-leaseThis PC only · 127.0.0.1:7400
Open panel
Open preview
Only you can see it. Not your published site.
Stop panel
Restart
Update available: 0.5.1
Start with Windows
Open command line (Advanced)
Open log folder
Quit GM-Scriptorium

After the daily check finds 0.5.1, the icon gets a blue dot and "Check for updates" becomes Update available: 0.5.1, which opens the panel's Updates card. No one-click update in the tray. Needs the update notice, now part of 0.5.0 (DT1 = B).

T07. Quit, with remote access ontray · confirm box

Scene 18 of 38T07 · Quit, with remote access ontray · confirm box
GM-Scriptorium

Quit GM-Scriptorium?

Remote access is on. Quitting signs out anyone using the panel from another device, and turns off your preview.

Quit asks only when remote access is on or a build is running (that variant reads "A preview build is running. Quitting stops it partway; your vault isn't changed."). Otherwise Quit stops at once, and open tabs show the stopped page (B04). Stop panel asks the same way.

T08. Menu: panel stoppedtray · context menu and tooltip

Scene 19 of 38T08 · Menu: panel stoppedtray · context menu and tooltip
GM-Scriptorium 0.5.0Panel stopped · long-leaseNothing is listening. Start it again here.
Start panel decision DT8
Open panel
Open preview
Only you can see it. Not your published site.
Restart
Check for updates
Start with Windows
Open command line (Advanced)
Open log folder
Quit GM-Scriptorium
GM-Scriptorium: panel stopped, long-lease
Tooltip on hover, menu closed

After Stop panel (DT8 = B): the icon stays with a grey badge, the panel and preview are off and open tabs show the stopped page. Start panel is the default item, and double-clicking the icon starts it and opens a tab. Check for updates, the command line and Quit still work.

T09. Menu: port in usetray · context menu, error state

Scene 20 of 38T09 · Menu: port in usetray · context menu, error state
!
GM-Scriptorium 0.5.0Port 7400 is in use by another programThe panel can't start on it.
Change ports... decision DT7
Try again
Open log folder
Open panel
Open preview
Check for updates
Start with Windows
Open command line (Advanced)
Quit GM-Scriptorium

With fixed ports (DT7), another program can hold 7400 or 7401. The icon gets the red badge and the menu leads with the reason, then Change ports... (T10) and Try again. A shortcut launch in this state shows the toast (N05).

T10. Change portstray · small window from the tray

Scene 21 of 38T10 · Change portstray · small window from the tray

Opened from Change ports... in the tray or on the N05 toast, because the panel can't open to change them itself. Save hands the ports to the program's own settings writer (never the tray helper) and starts the panel. When the panel is running, the same change lives on the Overview (B05).

Notifications

Windows toasts, kept to four moments: first run, a start-up failure, a busy port, and a new version. Problems after start-up go to the panel instead.

N01. First run: find it herenotification · toast

Scene 22 of 38N01 · First run: find it herenotification · toast
GM-Scriptorium···  ✕
GM-Scriptorium is runningFind its icon by the clock: click ^ to see it. Closing your browser doesn't stop GM-Scriptorium.
The ^ the toast means, by the clock

Shown once, the first time it starts (from Finish or the Start menu), while the browser opens on the panel. It never shows again for that Windows user.

N02. Quiet start at sign-innotification · none

Scene 23 of 38N02 · Quiet start at sign-innotification · none
Signed in. No toast and no browser tab: the icon is simply there under ^. decision DT9

With Start with Windows on, sign-in starts it quietly: no window, no tab, no toast (DT9 = A).

N03. Start-up error: can't reach your vaultnotification · toast

Scene 24 of 38N03 · Start-up error: can't reach your vaultnotification · toast
GM-Scriptorium···  ✕
GM-Scriptorium couldn't startCan't reach your vault for long-lease: V:\campaigns\long-lease isn't connected.

After a short run of retries at sign-in, or straight away from a shortcut. The same one-liner covers the other start-up failures: a bad config, several campaigns with no default. A busy port has its own toast with a way out (N05). The tray stays in the T05 state.

N04. Update availablenotification · toast

Scene 25 of 38N04 · Update availablenotification · toast
decision DT8
GM-Scriptorium···  ✕
GM-Scriptorium 0.5.1 is availableYou have 0.5.0. See what's new in your panel.

Once per new version, after the daily check. What's new opens the panel's Updates card; Not now hides it until the next version. Like T06 it relies on the update notice and [update] settings, now in 0.5.0.

N05. Start-up error: port in usenotification · toast

Scene 26 of 38N05 · Start-up error: port in usenotification · toast
decision DT7
GM-Scriptorium···  ✕
GM-Scriptorium couldn't startPort 7400 is in use by another program.

The fixed-port failure (DT7). Change ports opens the small window from T10; the tray stays in the T09 state until the panel starts.

Browser

The built panel, drawn with the real stylesheet, plus the preview page. Purple dashed outlines mark what this work adds or changes. Also shot at 390 px.

B01. Setup, pre-filled from the installerbrowser · setup review

Scene 27 of 38B01 · Setup, pre-filled from the installer not built: DT5 = Abrowser · setup review
GM-Scriptorium setup
http://127.0.0.1:7400/setup#reviewdecision DT7
GM-Scriptorium setup
Review

Filled in from the installer. Check your answers, then set up. Nothing is written until you press a button below.

Last step

Check your answers

Setup writes your campaign's files when you press a button below. A folder you made with New folder is already on your disk.

Review before setting up

Set up long-lease

Campaign namelong-lease
VaultC:\Users\Sam\Documents\Campaigns\long-lease
Output folderC:\Users\Sam\Documents\long-lease-site
Site titleThe Long Lease from pack
Themegloam
  1. Create in C:\Users\Sam\Documents\Campaigns\long-lease\_meta\scriptorium\: css, images, pack.toml and vault.config.json. Nothing else in the vault changes, and no existing file is overwritten.
  2. Register long-lease as your default campaign, in C:\Users\Sam\AppData\Roaming\Scriptorium\config.toml.
  3. Run a first check, then build a preview that only you can see.

Kept for the record only. It showed DT5 option B (the installer asks, the browser reviews). You chose DT5 = A, so the installer's own init --yes writes the answers and this screen is not built.

B02. Overview, first runbrowser · panel Overview

Scene 28 of 38B02 · Overview, first runbrowser · panel Overview
The Long Lease · Backstage
http://127.0.0.1:7400/#/overviewdecision DT7
Overview
Welcome to Backstage

long-lease is set up.

This is your panel. Closing this tab doesn't stop GM-Scriptorium: it keeps running by the clock, and its icon opens the panel again. Three good next steps:

  1. Look at your preview. Only you can see it.
  2. Commit your vault. Setup added files under _meta/scriptorium/.
  3. When it’s ready for players, Preview & publish walks you through it.
Backstage · campaign long-lease

The Long Lease

A rent-strike in a city that keeps its own books.

Theme
gloam dark
Last check
Not run in this tab yet
Last preview
Not run in this tab yet

The built one-time welcome, with its first line rewritten: closing this tab doesn't stop GM-Scriptorium, and the tray icon gets you back. The address is fixed at 127.0.0.1:7400 (DT7 = fixed), so bookmarks keep working.

B03. Error banner: vault unreachablebrowser · panel Overview

Scene 29 of 38B03 · Error banner: vault unreachablebrowser · panel Overview
The Long Lease · Backstage
http://127.0.0.1:7400/#/overviewdecision DT7
Overview
Backstage · campaign long-lease

The Long Lease

A rent-strike in a city that keeps its own books.

Theme
gloam dark
Last check
Can't check
Last preview
Paused

A problem after start-up (the drive dropped mid-session) shows as a banner on every screen, not a toast. Actions that need the vault are disabled; the banner clears itself when the vault is back.

B04. Stopped, after Quit or Stop panelbrowser · stopped page

Scene 30 of 38B04 · Stopped, after Quit or Stop panelbrowser · stopped page
GM-Scriptorium · stopped
http://127.0.0.1:7400/#/overviewdecision DT7
GM
Backstage

GM-Scriptorium has stopped

The panel and your preview are off. Everything you saved is on disk.

Start it again from the GM-Scriptorium icon by the clock, or from the Start menu.

What open tabs turn into after Stop panel, Quit or sign-out. The built wording stays; only the last line changes, to name both ways back: the tray icon (after Stop panel) and the Start menu (after Quit).

B05. Changing the ports laterbrowser · panel Overview, Addresses card

Scene 31 of 38B05 · Changing the ports laterbrowser · panel Overview, Addresses card
The Long Lease · Backstage
http://127.0.0.1:7400/#/overviewdecision DT7
Overview
Backstage · campaign long-lease

The Long Lease

A rent-strike in a city that keeps its own books.

Theme
gloam dark
Last check
Not run in this tab yet
Last preview
Not run in this tab yet

This PC's addresses decision DT7

Panelhttp://127.0.0.1:7400
Previewhttp://127.0.0.1:7401

Saving restarts GM-Scriptorium on the new ports, and this tab moves with it. Bookmarks to the old address stop working.

Where ports change after install: a small This PC's addresses card at the bottom of the Overview, beside the planned Updates card. Change opens the two fields (drawn open). With remote access on, the card says the ports are set under Remote access instead.

B06. Preview, marked as not livebrowser · the GM-only preview

Scene 32 of 38B06 · Preview, marked as not livebrowser · the GM-only preview
The Long Lease
http://127.0.0.1:7401/decision DT10
Preview only, not your live site.Only you can see this page. Players see what you publish.Back to the panel
The Long LeaseStoryCharactersWorldReferenceSearch

The Long Lease

Three hundred years ago a queen rented this valley from a dragon. At midsummer the dragon came back for the rent.

Latest session

The Wardens went up the Brisk to the Founder's barrow and read the rent at last.

The team

Beatrix HollowayKnight of the Marigold Guard
Iveth SolenneExpelled journeywoman
Kit FarrowCourier, formerly a pickpocket
Odda QuarrelBell-founder's daughter
Third-party notices · GM

What tray > Open preview opens (DT10, your note). A striped strip on every preview page says this isn't the live site, with a link back to the panel. Like the existing GM link, it is added to the preview only and never reaches a published build. The site itself is drawn roughly here.

Terminal

The command line keeps working alongside the background app.

C01. No arguments, while the app runsterminal · Windows Terminal

Scene 33 of 38C01 · No arguments, while the app runsterminal · Windows Terminal
decision DT3
Windows PowerShell
+
PS C:\Users\Sam> gm-scriptorium
GM-Scriptorium is already running in the background (long-lease).
Opened a new signed-in tab in your browser.
PS C:\Users\Sam> later, after Quit from the trayPS C:\Users\Sam> gm-scriptorium
Started GM-Scriptorium in the background (long-lease).
Its icon is by the clock, and your browser is opening.
PS C:\Users\Sam>

DT3 option A: typing gm-scriptorium starts or reuses the background app, opens a tab and gives the prompt back. No second panel. If the panel was stopped from the tray, it starts it. serve --admin still runs a foreground panel; portable copies keep today's console launch mode.

C02. status notes the background app (could)terminal · Windows Terminal

Scene 34 of 38C02 · status notes the background app (could)terminal · Windows Terminal
could
Windows PowerShell
+
PS C:\Users\Sam> gm-scriptorium status
long-lease: reachable (C:\Users\Sam\Documents\Campaigns\long-lease)
harbour-watch: reachable (C:\Users\Sam\Documents\Campaigns\harbour-watch)

Background app: running since 9:02 am, panel http://127.0.0.1:7400 (this PC only), long-lease
PS C:\Users\Sam>

A "could": status keeps its campaign lines and adds one line about the background app (or "Background app: not running"). check, build, config, remote and update work unchanged alongside it.

C03. Opened from the tray (Advanced)terminal · from tray > Open command line

Scene 35 of 38C03 · Opened from the tray (Advanced)terminal · from tray > Open command line
decision DT3
GM-Scriptorium
+
GM-Scriptorium 0.5.0 command line
GM-Scriptorium keeps running in the background. Commands here work alongside it.
Try gm-scriptorium status, gm-scriptorium check or gm-scriptorium help.

PS C:\Users\Sam> gm-scriptorium status
long-lease: reachable (C:\Users\Sam\Documents\Campaigns\long-lease)

Background app: running since 9:02 am, panel http://127.0.0.1:7400 (this PC only), long-lease
PS C:\Users\Sam>

Tray > Open command line (Advanced) (your note on DT3). It opens Windows Terminal, or the classic console if that's missing, in your user folder, with GM-Scriptorium on the PATH for that window only, so it works even if you left the PATH option unticked.

Uninstall

The uninstaller closes the running app itself and removes the new pieces.

U01. Uninstall, with the app runninguninstaller · confirm page

Scene 36 of 38U01 · Uninstall, with the app runninguninstaller · confirm page
GM-Scriptorium Uninstall
Uninstall GM-ScriptoriumRemove GM-Scriptorium 0.5.0 from your computer.
GM-Scriptorium is running. Uninstall will close it first.

GM-Scriptorium will be removed from C:\Users\Sam\AppData\Local\Programs\GM-Scriptorium.

Removed

  • The program, its tray helper decision DT2, and any leftovers from updates
  • The Start menu shortcut, and the desktop shortcut if you made one
  • The start-with-Windows entry
  • The PATH entry, if Setup added one
  • The Installed apps entry

Never touched

  • Your settings and campaign list, in C:\Users\Sam\AppData\Roaming\Scriptorium
  • Your campaign vaults, including their _meta\scriptorium\ folders
  • Your built sites, and anything you have published
GM-Scriptorium 0.5.0

The built confirm page, plus a line saying it will close the running app (no Retry box). The Removed list gains the tray helper and the start-with-Windows entry; Never touched is unchanged.

U02. Uninstall finisheduninstaller · finish page

Scene 37 of 38U02 · Uninstall finisheduninstaller · finish page
GM-Scriptorium Uninstall
GM-Scriptoriumfor game masters

GM-Scriptorium is removed

GM-Scriptorium has been removed from your computer. It no longer starts when you sign in.

Kept, as always: your settings and campaign list in C:\Users\Sam\AppData\Roaming\Scriptorium, your campaign vaults and your built sites.

GM-Scriptorium 0.5.0

The built finish page, kept lines and the unticked feedback box as they are, with one added sentence confirming the start-with-Windows entry is gone.

Notes

Behaviour with nothing on screen.

S01. Sign-out, restart and shutdownstoryboard note · behaviour only

Scene 38 of 38S01 · Sign-out, restart and shutdownstoryboard note · behaviour only

When Windows ends the session

Nothing to draw: there is no window and no prompt. This is the behaviour the build must show on the VM.

  1. Windows says the session is ending
    • Sign-out, restart or shutdown.
    • The tray helper receives it and tells GM-Scriptorium to stop.
    • No "this app is preventing shutdown" screen.
  2. A clean stop, inside Windows' time limit
    • Same path as Quit: panel and preview listeners closed, remote listener closed, programs it started ended, launcher file removed.
    • Open tabs show the stopped page (B04).
    • Settings are never written: config.toml is byte for byte unchanged.
  3. Next sign-in
    • With Start with Windows on, it starts quietly (N02).
    • Any leftovers from a cut-short stop are tidied first.
    • A vault on a drive that isn't connected yet gets retries, then T05 and N03.
Accepted leftovers (as ADR 0028)A dead launcher file and a preview folder, if Windows cuts the stop short. Both are cleaned on the next run.
Never in the logThe launch code, the session token, a password or a cookie. The log sits in an owner-only folder.

Covers the S01 note from the plan and the matching Windows criterion (sign-out, shutdown and restart stop cleanly; config hash unchanged).