Sessions

What is a Session?

A session is one game night. Each session is numbered and can have a date, audio recording, transcript, summary, plot hooks, and notes.

Sessions belong to a Campaign and are listed in chronological order on the campaign page.

Creating a Session

1. Go to the Campaign page and click "Add Session".
2. Enter the session number and optionally a date.
3. All active player characters in the campaign are automatically added to the session.
4. Click "Create Session".

Uploading Audio & Transcribing

1. On the Session page, scroll to "Upload Session Audio".
2. Select an audio file in one of the supported formats: FLAC, MP3, WAV, OGG, M4A, WebM, AAC, Opus, WMA, AIFF, or AC3. The file can be up to 500MB.
3. Optionally, set the Number of Speakers if you know how many people are in the recording. Leave it blank to auto-detect; a correct count produces cleaner "Speaker 1 / Speaker 2" labels.
4. Click "Upload Audio".
5. The session enters a transcription queue. You'll see "Waiting — position 1 of 3" or similar.
6. When it's your turn, the system transcribes the audio on CPU. A progress bar shows how far along it is. You'll see the live transcript appear as it's generated.
7. When complete, the transcript is available for viewing, editing, and downloading. Speaker labels (e.g. "Speaker 1", "Speaker 2") appear once transcription finishes — the recording is diarized offline after speech recognition.

Uploading a new audio file replaces the previous one and restarts the transcription process.

You must obtain consent from all participants before recording or uploading a session; as the Game Master you are responsible for that consent. CyberScribe deletes uploaded audio files after transcription completes and does not retain them.

Generating a Summary

Once you have a transcript (and optionally notes), you can generate an AI summary:

1. On the Session page, click "Generate Summary".
2. The AI processes the combined prompt (transcript + notes + all prompt levels) and generates a summary.
3. When complete, the summary appears in the Session Summary section. You can edit it or download it.
4. The summary is visible to players when they log in to view the session.

Generating Plot Hooks

Plot Hooks work the same way as summaries but are private to the Game Master — players never see them:

1. On the Session page, click "Generate Hooks".
2. The AI uses the same prompt structure but with your Plot Hook prompts instead of Summary prompts.
3. When complete, you can edit or download them.

NPC Compendium

Each session can contribute to your campaign's NPC Compendium — a browsable list of every named non-player character the party has met, with a short blurb per session:

1. On the Session page, click "Extract NPCs" (or enable "Auto-Extract NPCs on Transcription Completion" in the session, campaign, or GM settings to run it automatically).
2. The AI scans the transcript and notes and records each named NPC encountered, with a one-to-two sentence blurb about what they did that session. Generic descriptors without a proper name ("door guard", "community leader") are skipped.
3. Open the compendium from the Campaign page ("NPC Compendium"). NPCs are listed most-seen first with a live filter; selecting one shows every session they appeared in.
4. The compendium is visible to players when they log in.

Taking Notes

You can write Session Notes directly in the session page. Notes are included in the AI prompt when generating summaries and hooks — use them to record things the AI wouldn't know from audio alone (e.g. "The players discovered a hidden passage behind the bookshelf").

Notes support Markdown formatting for bold, italic, lists, and headings.

Downloading Content

Every piece of content can be downloaded as a text file:

• Summary
• Plot Hooks
• Notes
• Transcript

Viewing AI Prompts

At the bottom of the Session page, click:

• "View Summary Prompts" — see the exact combined prompt used for summaries, including all five levels and the generation settings (temperature, top P, etc.).
• "View Plot Hook Prompts" — same thing but for the plot hook prompt.

For a deeper explanation of how prompts work, see AI Prompts.

Deleting a Session

At the bottom of the Session page, click "Delete Session". This cannot be undone. The session number won't be reused.

Background Task Queue (Admin)

Admins can monitor all background jobs site-wide from Admin Dashboard → Background Task Queue. The page lists every pending or in-progress transcription, summary, and plot hook job across all sessions, with its state, queue position, and how long it has been waiting.

Cancelling a job makes the transcription worker and AI generation skip it instead of blocking the queue. Use it to clear out jobs that are stuck or no longer wanted:

• Transcription — removes the session from the transcription queue and clears its status. The upload can be re-queued later.
• Summary / Plot Hooks — clears the job status so the AI generation thread skips it. You can generate again later.