Settings

By the end of this page you will have changed Osmium's theme and the defaults the create wizard starts from, and you will know which file those live in.

Reaching it#

Press s on Home.

The Osmium settings screen, with a list of sections on the left and the settings of the selected section on the right.

The sections#

The left container picks a section and the right one edits it — the same two-container shape Manage Servers uses.

Appearance — the theme. It is applied to every command, not only to the full-screen interface: the progress bars, spinners and marks the commands print come from the same palette.

Teal is Osmium's own. The other nine — Dracula, Nord, Catppuccin, Tokyo Night, Gruvbox, Rosé Pine, Everforest, Kanagawa and Solarized — take their colours and their names from the community colour schemes they are named after, each used under its own licence. Osmium is not affiliated with, endorsed by or connected to any of those projects; the names are there so you can recognise the palette you already use.

Defaults — two settings the create wizard starts from:

Setting	What it does	Default
Default server folder	Where the wizard puts a server when you pick "Default folder"	the `servers` folder inside Osmium's config directory
Default memory	Preselects the memory step	`4G`

Memory accepts gigabytes or megabytes — 6G, 10G, 3072M.

About — what this binary is: its version, the commit it was built from, the build date, and the Go toolchain and platform. It is the same information osmium --version prints, and it is what a bug report needs.

Where settings are stored#

In config.json in Osmium's config directory — ~/.config/osmium on Linux, ~/Library/Application Support/osmium on macOS, %AppData%\osmium on Windows. The full schema is in Configuration.

Your Manage Servers layout and hidden panes are saved to the same file, but from that screen rather than from this one.

Keybindings#

Moving between sections:

Key	Action	Notes
`↑`, `↓`	Section
`tab`	Settings	Moves focus into the section's settings
`esc`	Home

Inside a section:

Key	Action	Notes
`↑`, `↓`	Move
`enter`	Apply	Applies the setting, or opens a text field for typing
`tab`	Sections	Back to the section list
`esc`	Home

Editing a text field:

Key	Action	Notes
`enter`	Save
`ctrl+u`	Clear	Empties the field
`esc`	Cancel	Leaves the setting as it was

Next#

Cheat sheet — every key on one page.