Settings
Open the settings panel by clicking the gear icon in the top-right corner. Settings are organised into tabs.
Features
| Setting | Description |
|---|---|
| AI endpoint | URL of the OpenAI-compatible VLM endpoint for AI tag analysis |
| AI model | Model name to use for analysis |
| Tag prefix | Prefix applied to AI-generated tags (e.g. ai/) |
| Collection description | Optional context passed to the model |
| Image/video/archive prompt | Override the default analysis prompts |
| Face detection endpoint | URL for the face detection model |
| Videolab | Show the optional video-processing workspace |
| Archive optimisation | Enable archive rebuilding actions |
| Replace original | Allow an optimised archive to replace its source after confirmation |
| Archive exclusions | Optional patterns omitted while optimising an archive |
Video
| Setting | Description |
|---|---|
| Max trickplay frames | Maximum number of frames in a trickplay sprite sheet |
| Frame selection | interval (evenly spaced) or scene (scene-change detection) |
Tiles
Controls the appearance of the file browser grid:
| Setting | Description |
|---|---|
| Tile size | Small / Medium / Large |
| Show filenames | Whether to show filenames below thumbnails |
Embeddings
| Setting | Description |
|---|---|
| Text endpoint | URL of the text embedding endpoint |
| Text model | Model name for text embedding |
| Vision endpoint | URL of the vision embedding endpoint |
| Vision model | Model name for vision embedding |
| Index all files | Start bulk indexing of all files in the database |
| Cancel indexing | Stop the running index job |
See Semantic search for a full setup guide.
Database
| Action | Description |
|---|---|
| Clear cache | Delete all thumbnails, trickplay sprites, and transcoded files |
| Database info | Show statistics (file count, tag count, database size) |
Compression and archive optimisation
Compression settings control new archives created from file selections. The automatic ZIP mode stores already-compressed media and deflates text and metadata. Archive optimisation is a separate opt-in feature: it can rebuild an existing archive, optionally exclude configured metadata patterns, and—only when explicitly enabled and confirmed—replace the original.
The replace option is destructive in intent but still participates in Tessera's filesystem-history and recovery mechanisms. Leave it disabled when you want the optimised archive beside the source for comparison.