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. With vim keybindings (the look’s own), the SQL editor has vim’s modes besides: there Esc goes from insert mode to normal mode, and a second 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

A group’s tables are drawn two cells in, with a │ before them and without the group’s prefix. The status line names the table under the cursor in full: book_covers · table · 13 rows.

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

V then y copies whole rows, with tabs between the values.

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 DDL view

S (or ddl in a table’s header) shows its definition as text, as Browsing Data says: read-only, with line numbers. The header says where it comes from and from which server, and the outline beside the text lists its parts with how much each holds, the part the cursor is in marked. Click a part to go to it.

The status line says how many lines are selected and which line the cursor is on.

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, ddl from any pane, 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

Settings › Keyboard

The Keyboard pane lists the commands by group, each with the scope its keys work in and the keys, and changes them: the defaults are the ones on this page. A command marked not built yet has its keys kept for it, and they do nothing until it is built; :keys default marks its lines so.

While a command records, press keys… stands in its keys. A chord is taken at once. Letters gather into keys of several (gd), which end 800 ms after the last letter or on Enter, and a line of the prompt (:w) ends on Enter; Backspace takes a letter back and Esc gives up. A command takes keys of the kind it has: Delete row typed letters, Toggle sidebar a chord, Save changes a line or a chord, and new keys of one kind leave its keys of the other. Super is never bound (Hyprland owns it), nor are : alone and Esc, nor vim’s insert keys (ctrl+w, ctrl+h, ctrl+u, ctrl+r) in an editor, nor letters that start with a digit, which is a count. Keys another command has offer [s] swap where the exchange can stand: that command gives up the keys and gets the ones this one had. The file beside the list shows the keys’ part of settings.toml as it is.

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.