Skip to content
FrostyBee Docs LogoFrostyBee Docs

Settings

Settings change how Vaste reads, shows, and reloads files. Every change applies at once and is saved automatically. There is no Save button.

Open Settings

Section titled “Open Settings”

Use any of these:

  • Press Ctrl + ,.
  • Select More actions (…) → Settings.
  • On the welcome screen, select the gear button in the title bar.
  • Run Settings from the command palette (Ctrl + K).

Settings opens over the window, with four categories on the left: General, Appearance, Viewer, and Keyboard. To close it, select Back to app or press Esc.

To find a setting, type in Search settings…. The search covers the names and descriptions of the settings and of the keyboard shortcuts. If nothing matches, Settings shows No settings found.

General

Section titled “General”
Section Setting What it does Default
File changes Auto reload Reloads an open file automatically after another program changes it. See Live reload. On
Startup Restore last session Reopens your files and their positions when Vaste starts. See Sessions and windows. Off
Storage Decompressed cache size The most space that decompressed copies of compressed files may use, from 1 to 500 GB. See The decompressed cache. 10 GB

Restore last session takes effect the next time you start Vaste. Decompressed cache size is applied when Vaste starts: Vaste removes the oldest copies until the cache fits the size.

Appearance

Section titled “Appearance”

The Theme section holds the appearance mode, the color themes, the interface font, and motion and window preferences. See Themes and appearance.

Viewer

Section titled “Viewer”
Section Setting What it does Default
Typography Viewer font size The size of the file’s text in every view, from 10 to 24 pixels 13
Typography Canvas renderer Draws Text view and Grep view lines as graphics rather than as text. You cannot select text within a line with the mouse. See Text view. Off
Whitespace Tab width How many columns a tab takes: 1, 2, 4, or 8 4
Whitespace Word wrap Wraps long lines in Text view instead of scrolling sideways Off
Whitespace Column ruler Shows column positions above Text view and Grep view when word wrap is off On
Whitespace Overview markers Shows search matches, bookmarks, and new lines beside the scrollbar, in Text view and Hex view On
Whitespace Line numbers Shows the line numbers in Text view and Grep view On
Whitespace Log-level colours Tints lines by their log level. See Log levels and highlighters. On
Whitespace Delta-t gutter Shows the time since the previous timestamped line. See Time between lines. Off
Whitespace Time histogram Shows how lines spread over time beside the scrollbar. See Time histogram. On
Hex view Bytes per row How many bytes each Hex view row shows: 8, 16, or 32 16
Hex view Byte grouping How many bytes are joined without a space in the hex pane: 1, 2, 4, or 8 1
Hex view Colour bytes by class Tints bytes by class in Hex view. See Byte classes. On

The Viewer font size sets the size of the file’s content. To change the size of menus, dialogs, and the toolbar, use Font size in Themes and appearance.

Keyboard

Section titled “Keyboard”

The Keyboard category lists every command that has a keyboard shortcut. Select a shortcut to change it. See Custom shortcuts.

License

Section titled “License”

The License category shows the state of the commercial trial or your license, with Activate license, Purchase license, and, once activated, Deactivate, Check now, and Manage subscription. See License and pricing.

Section Setting What it does Default
Title bar Hide license badge Hides the trial and license pill in the title bar of every window. Off

How Vaste saves settings

Section titled “How Vaste saves settings”

Vaste saves settings in the file settings.toml in its data folder. See Data and cache locations. When you change a setting in one window, every other Vaste window applies it too.

Settings has no button to restore every default. The theme has Reset to preset, and the shortcuts have Reset and Reset all. To return every setting to its default, quit Vaste and delete settings.toml.

If you edit the file by hand, Vaste checks the values when it starts: a number outside its range moves to the nearest end of the range, and an unknown choice returns to its default. The file accepts some values that Settings does not offer, such as a Decompressed cache size of up to 1000 GB. If it cannot read the file at all, it renames it to settings.toml.corrupt- followed by a number, and starts with the default settings.

The terminal app, vaste-tui, has its own settings file. See TUI configuration.

Next steps

Section titled “Next steps”