Projects

A project is the container for sessions. It carries the title, description, tags, visibility, the name the subject is addressed by, and the list of co-authors and viewers. Projects are created from Something New (or the dashboard’s Create New…) and managed from the project page and its settings.

Creating a project

The New Project form has these fields:

Project Title (required)

Shown in the public project list and on the project page.

Description of Project for List

Shown under the title on the project page. Supports limited BBCode for bold, italic, colour, size and links.

Subject’s Name (required)

The name, title or term the subject is addressed by. The project page greets them with “Here are your tasks to complete, {name}”.

Hide Project from Main List

Hides the project from the public list. Anyone with the direct link can still open it and watch it.

What is your session about? (at least one required)

Tags describing the content. They power search and filtering, and they drive the content warnings other users see. If a viewer has not opted in to one of your tags, the project page shows them a red Contains: line listing it.

Co-authors and viewers cannot be added at creation time; use Project Settings.

After creation you can go Back to Dashboard, Go to Project, or Create New Session in Project.

The project page

The project page is what subjects see. Its header offers:

Control	Who sees it	What it does
Watch / Unwatch Project	everyone signed in	Adds the project to your watched list on your profile, with a link that works even if the project is hidden
Report	everyone signed in	Reports the project to moderation
Export project bundle	owner and co-authors, or anyone if export is allowed	Downloads a .hypnabundle of the whole project with media
Metrics	owner and co-authors	Opens the project metrics page
Import a session bundle	owner and co-authors	Adds a session from a .hypnabundle file
+	owner and co-authors	Creates a new session
Project Settings	owner and co-authors	Opens the settings page

Below the header: the description, Project Author, co-authors, tags, any related audio files, and the session list. Each session row shows its type, a speaker icon if it has autoplaying audio, an estimated duration for spiral tasks, the launch buttons, a Settings link for editors, and a ? button that opens the transparency report.

Comments live in an accordion at the bottom. They accept plain text only, and the page reloads after you submit.

Transparency report

The ? next to a session opens a report of what the session contains: type, session ID, creator, the lines, distractors, text, iteration count, audio URL, and an expandable list of images. A copy button copies the whole session JSON. The session ID shown here is what you need to add the session to a playlist.

Project settings

Reached from Project Settings on the project page. The header has Back to Project, History and Save.

Name of Session

Despite the label, this is the project title.

Project Description

As on creation; BBCode is supported.

Subject’s Name, Hide Project from Main List, tags

As on creation.

Allow other users to export this project

Lets any signed-in user download the project and its sessions as a .hypnabundle with all media, for offline play in Fractal or importing into their own account. Off by default, in which case only you and your co-authors can export. Only the project owner can change this.

Session Order

Drag sessions into order, or use the up and down arrows, then press Save Order.

Project Co-authors

Search for a username and add it. Co-authors can edit every session in the project, including deleting sessions, and can manage viewers. They cannot add other co-authors or delete the project.

Project Viewers

Users who can open the project even when it is hidden. An alternative to sharing the direct link.

Danger Zone: Delete Project

Owner only. Asks Are you Sure?, warns that all media and data will be cleared, and suggests exporting a bundle first.

History

History shows every change made to the project’s settings, page by page. Session edits have their own history, reached from the session settings page URL with /history/ appended.

Supporter-only projects

Some projects are available only to supporters. This is not a creator-facing toggle: it is set by site staff on request. A non-supporter opening one sees a Pardon the interruption dialog with a link to the subscriptions page.

Metrics

Metrics shows, per session: the ten most recent starts, total starts, completions with the completion ratio, the top ten completers and every user who has started it. Users who chose Anonymous in their profile settings are shown as Anonymous.

Exporting and importing bundles

A Hypna Bundle (.hypnabundle) is a zip file containing a project or a single session plus every media file it uses. Bundles move content between accounts and between Hypna and the Fractal desktop app.

• Export project bundle on the project page downloads the whole project.

• Export on a session’s settings page downloads that one session.

• Import on the Projects page creates a new project from a bundle. Imported projects arrive hidden.

• Import a session bundle on a project page adds a session to that project.

Limits per bundle:

Limit	Value
Project bundle	512 MB
Session bundle	128 MB
Single media file	25 MB
Single JSON file	5 MB
Files in the zip	2000

Sessions that have never been opened in the current editor have no HypnoSpec document and block an export until they are opened and saved once.