History Settings
Capture history is stored at %APPDATA%\Tex\capture_history.json alongside the images it references. These settings control retention.
Settings
| Setting | Default | Description | UI location |
|---|---|---|---|
PersistToDisk | true | Write history across sessions. When off, history is in-memory only | Settings → History |
MaxItems | 50 | Maximum number of captures retained. Oldest dropped first | Settings → History |
MaxSizeMB | 200 | Maximum total disk usage of history images in megabytes | Settings → History |
AutoSaveAnnotations | true | Write annotation edits back into the history entry when you apply them | Settings → History |
How MaxItems and MaxSizeMB interact
Both limits are enforced — the lower bound wins. Captures are dropped from the oldest end until both conditions are satisfied:
- item count ≤
MaxItems, and - total on-disk size ≤
MaxSizeMB
So if you shoot 50 full-4K screenshots that together exceed 200 MB, items will be trimmed beyond the MaxItems cap to meet the size budget. Conversely, 200 tiny region captures will be trimmed to 50 items even if the size is trivial.
Tip — Raising MaxSizeMB without raising MaxItems has no effect if you typically hit the item cap first. Tune whichever bound is actually binding for your workflow.
Disabling persistence
Turning PersistToDisk off switches history to session-only mode. Captures still appear in the History window during the current run, but the list is discarded when Tex exits.
Warning — Disabling PersistToDisk does not delete the existing capture_history.json or stored images. Re-enabling later will restore the prior list. To clear history permanently, close Tex and delete %APPDATA%\Tex\capture_history.json and the %APPDATA%\Tex\captures\ folder.
AutoSaveAnnotations
When on, every Apply & Save in the annotation editor overwrites the history entry with the annotated image. When off, the annotation is copied out (to clipboard or a save dialog) but the history retains the clean original — useful if you annotate repeatedly from the same source.