Files
talemate/docs/user-guide/restoring-scenes.md
veguAI 42a8863e65 0.36.0 (#255)
Major Features

- API key encryption at rest using Fernet (OS keyring with file fallback)
- Prompt Manager: unified UI with template groups, priority ordering, override tracking, response extractors
- Scene context history review panel with token budgets and best-fit mode
- Multiple concurrent director chats with auto-generated titles
- Granular scene state reset dialog
- Time passage insert/edit/delete in scene view
- Image analysis via OpenAI-compatible and Talemate Client backends
- Volatile context placement after scene history for improved prompt caching

Improvements

- Configurable narrator generation length per narration type
- AI Aware conversation mode
- Summarizer: custom instructions, writing style inclusion, short line filtering
- Anthropic: adaptive thinking support, updated model list (opus-4-5/4-6, haiku-4-5)
- Google: gemini-3.1 support
- World editor: generate from topic, quick create state reinforcement, reorganized menus
- Node editor: promote scene modules to global
- Frontend: version mismatch detection, hideable bracket content, required scene name
- TTS: improved pause handling, audio tag support for vocal markers (ElevenLabs v3)
- Writing style template for AI-generated instructions
- Added Kimi.jinja2 LLM prompt template
- Option to disable character names in stopping strings
- Client response length enforcement options
- Graduated token count sliders
- Increased summarizer token threshold max

Bugfixes

- Fix bracket/paren/brace terminators stripped from message ends
- Fix colon in conversation causing content loss
- Fix "Use as reference" navigating to blank page
- Fix avatar regeneration and manual regenerate
- Fix conversation agent ignoring generation length
- Fix duplicate length instructions with reasoning enabled
- Fix trailing newline on message edits
- Fix summarize dialogue sending too much context with layered history
- Fix layered history inspection and construction issues
- Fix empty response handling in summarization
- Fix context ID dot notation with dotted character names
- Fix recursive retry in focal agent
- Fix leading whitespace causing duplicate prepared responses
- Fix summarization not stripping ANALYSIS OF lines
- Fix template group selection/removal in prompt manager
- Fix multiline text in parentheses/brackets parser
- Fix determine_character_name resolution
- Fix character activate/deactivate desyncing creative menu
- Fix character image generation missing context
- Fix LMStudio client not sending token limits
- Fix Recent Scene images on newer Chromium
- Fix sequential reinforcement messages cut off at first linebreak
- Fix reinforcement removal not clearing state
- Fixes #252, #256, #258

Deprecations

- Removed context investigations (replaced by AI-assisted RAG mixin)
- Removed deprecated prompt templates (fix-continuity-errors, fix-exposition, etc.)
- Removed conversation/edit.jinja2, auto break repetition, CLI reset layered history
---------

Co-authored-by: theDTV2 <47825738+theDTV2@users.noreply.github.com>
2026-03-15 12:00:57 +02:00

2.5 KiB

Restoring Scenes from Backups

Talemate provides two ways to return a scene to a previous state:

  • Restore from Backup — use the automatic version history to go back to any previous revision (covered on this page)
  • Restore from Restore Point — reset to a specific save file you've designated as a baseline in the scene settings

Both methods create a new, unsaved scene — your existing files are never modified.

Restore from backup

Every time you save, Talemate records the changes as a delta in the scene's changelog directory. This version history lets you restore a scene to any previous revision.

How to restore

  1. From the main screen, locate your scene in the Quick load section
  2. Click the three-dot menu (⋮) on the scene card
  3. Select Restore from Backup

Restore menu option

Restore options

Restore menu option

The backup restore dialog provides several restoration options:

  • Restore Earliest - Returns the scene to its initial state (revision 0)
  • Restore Latest - Restores the most recent saved state
  • Filter by date/time - Find and restore to a specific point in time

When you use the date/time filter, Talemate will show the closest available revision to your selected time.

Important notes

!!! warning Restoring creates a new, unsaved scene from the selected revision. Your original scene file will not be modified. This allows you to safely explore previous states without losing your current progress.

After restoration:

  • The restored scene opens as a new, unsaved scene
  • You must manually save it to preserve the restored state
  • The original scene file remains unchanged in its current state

Restore from restore point

If you've configured a restore point in the scene settings, you can reset the scene to that baseline state using the :material-backup-restore: Restore Scene button. This is useful for scenes you want to replay from a fixed starting point, such as testing a scene during development.

Unlike backup restoration, which uses the automatic version history, restore points use a specific save file you've chosen as the baseline. See the restoration settings documentation for setup details.