Handbook

13 · Desk

Session

What the browser stores, and how you export a project.

The desk restores the last session from IndexedDB. The database name is neural-drift. The store is kv.

Boot

  1. Restoring the session appears.
  2. sessionReady opens persistence after prefs apply.
  3. sessionBooted waits for file and media restore.
  4. Mic restore does not block the overlay.

Empty-state copy waits until boot finishes so a restored queue does not flash as empty.

What prefs store

Console prefs (version 21) hold:

  • Active look
  • Render quality, resolution, stage background, FPS
  • Media and effects parameters
  • Transport: volume, loop, response, smoothness, beat, curves, band ranges, BPM, source kind, mic device, track index
  • Inspector tab and group open states
  • Pinned parameters (up to 16)
  • Media preview toggle
  • Library width, scenes docked plus height, looks/media split, library tab
  • Modulations
  • Per-look controls, palettes, and invert modes
  • Allow motion

Unknown preset ids and foreign control keys stay parked so a rewrite does not erase them.

What else stores

Separate IndexedDB entries hold:

  • Scene library (sets, scenes, media refs)
  • Media library entries and blobs
  • Custom look library
  • MIDI map
  • Audio file queue blobs
  • Media queue blobs

Export a project

On the Output tab, Export project writes a JSON bundle. The bundle holds settings and references. It does not embed large media.

Import a project

  1. Click Import project.
  2. Pick a .json or .ndrift file.
  3. Read the preview counts.
  4. Link files if the import needs local media.
  5. Replace and reload applies the bundle.
  6. Cancel leaves the current session.

Cloud copy

You can also upload scenes, looks, and media to your account. That copy is private. The console still keeps the local IndexedDB session. Export a project file when you need a file you can move off this browser.