Sessions and Session Manager

Wayscriber can restore drawings automatically, or you can work with named session files when each meeting, lecture, or project needs its own canvas state.

Default sessions

Default persistence is controlled by the [session] config section. It is the right choice when you want Wayscriber to reopen with the same drawing state you used last time.

[session]
persist_transparent = true
persist_history = true
restore_tool_state = true
per_output = true
storage = "auto"
max_file_size_mb = 50

With per_output = true, Wayscriber keeps separate default session files for each monitor.

Named session files

Use --session-file when you want a specific file to hold a specific drawing set:

wayscriber --active --session-file ~/Documents/lecture-04.wayscriber-session
wayscriber --freeze --session-file ~/Documents/lecture-04.wayscriber-session
wayscriber --daemon --session-file ~/Documents/default-work.wayscriber-session
wayscriber --daemon-toggle --session-file ~/Documents/meeting.wayscriber-session
wayscriber --session-info --session-file ~/Documents/lecture-04.wayscriber-session
wayscriber --clear-session --session-file ~/Documents/lecture-04.wayscriber-session

--session-file uses the exact selected file, implies persistence for that run, and conflicts with --no-resume-session. Launch, Open, and Save As flows require an existing parent directory. --session-info and --clear-session can still inspect or clean up stale named-session paths after the parent directory is gone.

If a daemon overlay is already visible with one named session, hide it before toggling to a different named session target.

Overlay Session panel

The overlay Session panel is in the side toolbar. Use it for the active session you are working in now:

• Open loads an existing named session and records it in recent sessions.
• Save As writes the current overlay to another named session and switches the active target. If no extension is supplied, Wayscriber appends .wayscriber-session; if target artifacts already exist, it asks before replacing them.
• Info reports the active session file size, board shape counts, and history status.
• Clear removes saved data for the active target.
• Recent session rows reopen named sessions you used earlier.
• Manager opens the configurator Session tab.

The Open and Save As file pickers use zenity first, then fall back to kdialog when available.

Configurator Session tab

The configurator manages default persistence settings and the named-session catalog. Named sessions are recorded when they are opened or saved from the CLI, daemon, or overlay Session panel.

Catalog actions:

• Save Name changes only the catalog display label.
• Reveal File opens the session file location.
• Forget removes catalog metadata without deleting session files.
• Duplicate copies an inactive session’s primary file to a new named target.
• Move relocates an inactive session file and its non-lock sidecars.
• Clear Saved Data removes saved data for that catalog entry.

Duplicate, Move, and Clear Saved Data are offline file-maintenance actions. They are disabled while an overlay, manually started daemon, or background service is active. Use Save As from the overlay for the currently active session, or stop the overlay/service before changing inactive files from the configurator.