Sessions and the editor¶

Creating a session¶

Press + on a project page. The New Session screen asks for:

Session Title
Select a Session Type. A description of the chosen type appears under the dropdown. See Session types for each one.

Press Create Session, then Go to Session Settings to open the editor.

The session editor¶

The editor page has a header with Back to Project, Stats, Export (downloads a .hypnabundle of this session) and Save. Under the header is the session title, then the editor tabs, then the Danger Zone with Delete Session.

Saving writes the whole session at once. Nothing is stored until you press Save.

Tabs¶

Tab	Shown for	Contents
Content	all types	the lines, text, iteration count and distractor lines the session uses
Spiral	MST, BST	spiral type and its settings
Settings	all types	type-specific settings plus optional features
Images	MST, BST	image uploads and the image display mode
Script	all types	the raw HypnoSpec document

Each box on these tabs is one HypnoSpec feature, and its heading links to the feature’s schema reference on the site.

Adding optional features¶

At the top of the Content tab, Add optional feature lists the features not yet on the session. Click a chip to add it; the editor jumps to the tab where its settings live.

Chip	Adds	Where
+ Distractors	distractor lines and random-placement distractors	Content
+ Wall Distractors	the wall-of-text distractor style	Settings
+ Audio	a looping audio track	Settings
+ Custom CSS	a stylesheet for the player	Settings
+ YSS (YuukSpace Script)	inline scripting (MST and BST only)	Settings

Settings for all of these are described in Session features, Custom CSS and YSS.

Line lists¶

Lines, distractors, interrupters, punishment phrases and wrong words are all edited with the same list control: type in the box and press Enter to add a line, edit a line in place, or press Delete on a row. Long lists are virtualised, so sessions with thousands of lines stay responsive.

Images¶

The Images tab uploader accepts PNG, JPEG, GIF, WEBP and WEBM, by drag-and-drop or the Upload button, and uploads immediately. Every image is converted to WEBP on the server. Thumbnails can be viewed as a grid or list and deleted individually.

Per-session image limits depend on your account tier:

Tier	Images per session
Free	100
Supporter	200
Expanded	500
Overkill	1000
Trade Ya!	unlimited

Images belonging to sessions that have not been opened for some time are moved to cold storage. The next launch shows “This session hasn’t been opened in a while. Give us a moment to take the images out of storage…” while they are restored, then preloads the images before starting.

The display mode (Full-screen Cycler or Scatter) is chosen on the same tab. See Images.

The Script tab¶

The Script tab shows the entire session as a HypnoSpec document in YAML, with schema hints, completion and live diagnostics. Edit it and press Validate & Apply to push the changes into the other tabs, then Save. While the script has unapplied edits the other tabs and the Save button are disabled.

This is the only place to change a few settings the form tabs do not expose, such as distractor timing. See Editing the HypnoSpec document.

Launch options¶

On the project page every session has Launch Session. MST and BST sessions also have VR, which renders a side-by-side view for a phone headset, and, for accounts with WebXR enabled, XR, which launches on a VR or AR headset. See Running sessions for the player itself.

Statistics and history¶

Stats in the editor header opens Session Statistics: a chart of watches and starts per day over 7, 14 or 30 days, a live list of ongoing runs with their elapsed time, and stale runs from the last hour.

Every save is recorded. Project settings have a History button; session history is at the session settings URL with /history/ appended.

Deleting a session¶

Delete Session in the Danger Zone asks for confirmation and warns that all media and data will be removed. Export a bundle first if you may want the session back.