| title | Settings Reference |
|---|---|
| description | A complete reference for every option on the Transmute Settings page. |
| order | 5 |
The Settings page lets you configure Transmute's appearance, conversion behaviour, default output formats, and data management. Changes to appearance and conversion options take effect after clicking Save Changes.
Choose the colour theme applied across the entire application. Transmute ships with seven built-in themes:
| Theme | Style |
|---|---|
| Rubedo (default) | Dark — red accent on dark blue |
| Citrinitas | Dark — gold accent on deep violet |
| Viriditas | Dark — green accent on black |
| Nigredo | Dark — purple accent on black |
| Albedo | Light — silver tones |
| Aurora | Light — orange accent on warm cream |
| Caelum | Light — sky blue accent on cool white |
See the Themes page for screenshots of each theme.
Default: off
When enabled, the browser will automatically trigger a file download as soon as a conversion finishes. When disabled, converted files remain available in the History view for manual download at any time.
Default: on
When enabled, the original uploaded file is retained on disk after a conversion completes, and will continue to appear in the Files view. When disabled, the source file is deleted once the conversion job finishes and only the converted output is kept.
You can save a default low, medium, or high quality level for any output format that exposes quality options. When you later convert to that format, Transmute applies your saved default automatically unless you explicitly choose a different quality for that conversion.
See Quality Reference for the exact encoder settings behind each quality tier.
Default: on
Enables automatic background cleanup of uploads and conversions after they age out. When toggled off, files and conversion records are kept indefinitely (or until removed manually).
Default: 60 minutes · Visible only when Cleanup TTL is enabled · Range: 1–10080 minutes (1 minute to 1 week)
The number of minutes Transmute waits before automatically deleting an uploaded file or conversion record. For example, a value of 60 means any file or conversion older than one hour will be removed by the background cleanup task.
Use the − / + buttons or type a value directly into the field.
Tip: 1440 minutes = 1 day, 10080 minutes = 1 week.
The Save Changes button persists all Appearance and Conversion settings to the server. Settings are sent as a PATCH /api/settings request and take effect immediately after saving.
These actions are immediate and irreversible. A confirmation dialog is shown before any deletion takes place.
Deletes all completed conversion records and their associated output files from the server. Uploaded source files are not affected. Equivalent to DELETE /api/conversions/all.
Deletes all uploaded source files from the server. Conversion records and output files are not affected. Equivalent to DELETE /api/files/all.
Default formats let you pin a preferred output format for a given input type. When a file of that type is uploaded on the Converter page, the output format dropdown will be pre-selected to your configured default, saving you from choosing it manually each time. You can still override the selection per file before starting a conversion.
- Select an input format from the left dropdown — only formats that don't already have a default configured are shown.
- Select the desired output format from the right dropdown.
- Click Add.
Use the output format dropdown in the existing mappings table to choose a different output format. The change is saved immediately.
Click the × button on the right side of any row to remove that mapping. The change takes effect immediately and the input format becomes available to configure again.