The Omarchy Look

On Linux, Tabletist takes the Omarchy look: square corners, the keyboard first, vim keys, and the desktop’s monospace font throughout. Every Linux desktop gets it. On macOS and Windows the app has a desktop look instead, and there is no setting that switches between them.

The keyboard

This page lists the keys of the Omarchy look, grouped by where they work. The status line along the bottom shows the ones that work where you are. The app’s own list (?) is shorter: it leaves out the keys of the dialogs and of the lists that open in an editor.

A letter does its job when no text field has the keyboard. While a field has it, letters are typed into the field, and Esc gives the keyboard back.

Everywhere

Ctrl+P opens quick open from any pane: a picker at the top of the window that finds a table or view by name, in this connection or (Tab) in every open one. With nothing typed it lists what you opened lately, numbered; once you type, it lists what matches. Its commands stay on :. / in the sidebar still filters the sidebar’s list.

The picker

The connection form

The sidebar

The start screen

A window with no tab open shows the start screen in the main pane: the connection in one line (a production connection gets its red strip there, with read-only where it is), the five tables, views and SQL editors you opened last on this connection, numbered, and under start the ways to begin. On your first visit it lists the largest tables instead, from the database’s statistics, so nothing is queried (a SQLite file lists its tables by name). A / line under the connection holds the search. The status line says -- START -- while no tab is open. After a connect the keyboard is in the sidebar; Ctrl+L gives it to the screen, whose border lights, and Ctrl+H puts it back.

With the search open, the matches replace the start lists:

A table

The Structure and Data views are clicked: switching between them has no key. Nor has copying a whole row.

The Agents tab

The Structure view

Ctrl+L brings the keyboard to its columns, as it does to the rows.

The label is the column that the table’s rows are read by in the list of a foreign key that points at it: Editing Data says what it does. A key or a column of bytes is not taken, and the status line says why.

The row panel

Editing

A date or time cell has no key for the time of the save: type now() into it.

The : prompt takes w, e! and diff on a table, the label lines in its Structure view, ro and rw in a SQL editor, and nothing else.

A save can ask you something first. Each question has its own keys:

The SQL editor

While the completion list is open:

On a result, with the keyboard out of the editor:

When a read-only run refused a write, the card in Messages has its own letters: e edits the connection, and w allows writes in this tab or runs the statements again in a read-write transaction, whichever the card offers.

Under a result the limit cut, a shows all of it. When the timeout stopped a run, t runs it again without one. Times read “45s”, “1m” and “1m 30s” in this look.

The History tab

Settings

The Mac’s keys are in Tabletist on macOS, and the keys of the macOS and Windows looks together in Keyboard Shortcuts.

Themes

On Omarchy, Tabletist follows the current theme and recolors when you switch themes, while it runs. On another Linux desktop it follows the system’s light or dark setting.

Tabletist maps an Omarchy theme onto its own palette with a template. The one it ships is contrib/omarchy/tabletist.json.tpl in the source; a tabletist.json.tpl of your own in ~/.config/omarchy/themed is used instead.

Pinning a theme

Settings › Appearance shows the theme drawn now and the palette it gave. l on the theme row pins the theme Omarchy shows: Tabletist keeps it when you switch Omarchy’s theme, and h follows Omarchy again.

A theme can also be pinned in settings.toml, by the name of an Omarchy theme, yours or one Omarchy ships:

[appearance]
theme = "Tokyo Night"

Your own colors

A palette file in the themes folder of Tabletist’s settings folder can replace the desktop’s colors. Pin it by its file’s name:

[appearance]
theme = "my-theme.json"

A name alone ("my-theme") is an Omarchy theme’s first, and the palette’s only where no Omarchy theme has it. A file or an Omarchy theme’s folder anywhere is pinned by its path, starting with / or ~/:

[appearance]
theme = "~/themes/my-theme.json"

A pin that cannot be found or read is told in the status line once a connection is open, and on the theme row of Settings › Appearance, and Tabletist follows the desktop instead. The folder and the file are described in Settings and Files.

Settings

Cmd/Ctrl+, opens Settings. In the Omarchy look it is a full screen with settings.toml shown beside the options. Edits made to the file in your editor are applied while Tabletist runs.

The font and its size

Tabletist draws in the desktop’s monospace font, as fontconfig resolves it (omarchy font set changes it), and Settings › Appearance names the font drawn. Another font is named in settings.toml by its fontconfig name; one fontconfig does not have is drawn as the system’s monospace, and the font row says so:

[appearance]
font = "Fira Code"
font_size = 15

The size, 9 to 24, sizes the whole window, as a terminal’s font size does. h and l on the size row change it, and so do Ctrl+= and Ctrl+- anywhere in the window; R on the row puts back 13.