Keybindings

All keybindings are configurable via ~/.config/logana/config.json. Only the keys you want to change need to be specified — all others retain their defaults.

Key Syntax

Each binding is a string (or array of strings for multiple alternatives):

Multiple alternatives:

"scroll_down": ["j", "Down"]

Navigation (shared across all modes)

"navigation": {
  "scroll_down": ["j", "Down"],
  "scroll_up": ["k", "Up"],
  "half_page_down": "Ctrl+d",
  "half_page_up": "Ctrl+u",
  "page_down": "PageDown",
  "page_up": "PageUp"
}

Normal Mode

"normal": {
  "scroll_left": ["h", "Left"],
  "scroll_right": ["l", "Right"],
  "start_of_line": "0",
  "end_of_line": "$",
  "command_mode": ":",
  "filter_mode": "f",
  "group_mode": "Ctrl+g",
  "toggle_filtering": "F",
  "toggle_highlight_mode": "H",
  "go_to_top_chord": "g",
  "go_to_bottom": "G",
  "mark_line": "m",
  "expand_continuation": ">",
  "collapse_continuation": "<",
  "search_forward": "/",
  "search_backward": "?",
  "next_match": "n",
  "prev_match": "N",
  "visual_mode": "V",
  "visual_char": "v",
  "toggle_marks_only": "M",
  "yank_line": "y",
  "yank_marked": "Y",
  "show_keybindings": "F1",
  "clear_all": "C",
  "edit_comment": "r",
  "delete_comment": "d",
  "comment_line": "c",
  "next_error": "e",
  "prev_error": "E",
  "next_warning": "w",
  "prev_warning": "W",
  "filter_include": "i",
  "filter_include_auto": "a",
  "filter_exclude": "o",
  "enter_ui_mode": "u",
  "clear_search": "Esc"
}

filter_mode opens the filter manager; group_mode opens group management scoped to the selected group. go_to_top_chord is the first key of the gg chord — pressing it twice jumps to the first line, matching go_to_bottom’s single-press jump to the last line. clear_search clears an active search highlight when nothing else is open.

Global (always active)

"global": {
  "quit": "q",
  "next_tab": "Tab",
  "prev_tab": "Shift+Tab",
  "new_tab": "Ctrl+t",
  "close_tab": "Ctrl+w",
  "file_switcher": "Ctrl+p"
}

Filter Manager

"filter": {
  "toggle_filter": "Space",
  "edit_filter": "e",
  "delete_filter": "d",
  "set_color": "c",
  "add_include_filter": "i",
  "add_include_filter_auto": "a",
  "add_exclude_filter": "o",
  "add_date_filter": "t",
  "add_highlight_filter": "h",
  "search": "/",
  "move_filter_down": "J",
  "move_filter_up": "K",
  "toggle_all_filters": "A",
  "clear_all_filters": "C",
  "exit_mode": "Esc",
  "sidebar_grow": ">",
  "sidebar_shrink": "<"
}

The filter manager also reuses the shared navigation group above (scroll_down/scroll_up/half_page_down/half_page_up/page_down/page_up) and, for jump-to-top/bottom, the normal.go_to_top_chord/normal.go_to_bottom bindings — no separate fields needed for those. sidebar_grow/sidebar_shrink resize the sidebar while it’s focused.

Group Mode

"group": {
  "clear_group_style": "x",
  "add_group": "a"
}

Group management (Ctrl+g) reuses several filter/navigation bindings rather than duplicating them: filter.toggle_all_filters/filter.toggle_filter to toggle the selected group, filter.edit_filter to edit its style, filter.exit_mode to exit, and navigation.scroll_down/scroll_up to move between groups. clear_group_style has no sensible existing key to borrow, so it gets this dedicated field.

Search / Filter Edit / Command Confirm & Cancel

"search": {
  "confirm": "Enter",
  "cancel": "Esc"
},
"filter_edit": {
  "confirm": "Enter",
  "cancel": "Esc"
},
"command": {
  "confirm": "Enter",
  "cancel": "Esc"
}

search confirms or cancels the log panel’s //? search or the filter manager’s / search. filter_edit confirms or cancels an in-place filter pattern edit. command confirms or cancels the : command line.

Visual Line Mode

"visual_line": {
  "comment": "c",
  "mark": "m",
  "yank": "y",
  "search": "/",
  "exit": "Esc"
}

Visual Char Mode

"visual": {
  "move_left": ["h", "Left"],
  "move_right": ["l", "Right"],
  "word_forward": "w",
  "word_backward": "b",
  "word_end": "e",
  "word_forward_big": "W",
  "word_backward_big": "B",
  "word_end_big": "E",
  "start_of_line": "0",
  "first_nonblank": "^",
  "end_of_line": "$",
  "find_forward": "f",
  "find_backward": "F",
  "till_forward": "t",
  "till_backward": "T",
  "repeat_motion": ";",
  "repeat_motion_rev": ",",
  "start_selection": "v",
  "filter_include": "i",
  "filter_exclude": "o",
  "search": "/",
  "yank": "y",
  "exit": "Esc"
}

Comment (Annotation) Mode

"comment": {
  "newline": "Enter",
  "save": "Ctrl+s",
  "cancel": "Esc",
  "delete": "Ctrl+d"
}

Confirm Dialogs

"confirm": {
  "yes": ["y", "Enter"],
  "no": ["n", "Esc"],
  "always": "Shift+Y",
  "never": "Shift+N"
}

always/never apply the same choice automatically to every future prompt of that kind, where the dialog supports it (e.g. session restore).

UI Options Mode

"ui": {
  "toggle_sidebar": "s",
  "toggle_mode_bar": "b",
  "toggle_borders": "B",
  "toggle_wrap": "w",
  "toggle_relative_line_numbers": "r",
  "toggle_groups_panel": "g",
  "exit": "Esc"
}

Select Fields Mode

"select_fields": {
  "toggle": "Space",
  "move_down": "J",
  "move_up": "K",
  "all": "a",
  "none": "n",
  "reset": "r",
  "apply": "Enter",
  "cancel": "Esc",
  "search": "/"
}

reset restores the popup’s staged fields to the format’s default order with everything visible — clearing both any J/K reorder and any hidden fields in one step. Like all/none, it only changes what’s staged; apply still commits it.

Archive Picker Mode

"archive_picker": {
  "toggle": "Space",
  "merge_toggle": "m",
  "expand": "Right",
  "collapse": "Left",
  "all": "a",
  "none": "n",
  "apply": "Enter",
  "cancel": "Esc",
  "search": "/",
  "search_toggle": "Ctrl+e",
  "search_merge_toggle": "Alt+m",
  "search_select_all": "Ctrl+a",
  "search_merge_all": "Ctrl+Alt+m"
}

toggle marks a file (or a container’s whole subtree) for extraction — each toggled file opens as its own tab on apply. merge_toggle marks a file independently for merging instead: every merge-marked file is extracted and combined into one timestamp-sorted tab on apply, rather than opening separately. A file can be toggled, merge_toggled, both, or neither, and apply performs both actions together in one press. If a merge-marked file’s format can’t be recognized, only the merge is skipped (with an error naming the file) — toggled files still extract and open normally.

Archive listing only auto-decompresses one nested level; a nested archive found any deeper shows as a collapsed row instead of being read upfront. expand reads and reveals it on demand (or, on an already-fetched row that’s merely folded shut, just reveals its children again with no re-fetch); collapse folds an expanded container’s children back out of view without discarding the already-fetched data.

search opens a live regex query that narrows the file tree to matching files (keeping their containing archive visible for context) — Enter confirms and un-narrows the list, Esc cancels back to the pre-search selection. An invalid/incomplete regex (e.g. while still typing) falls back to a plain substring match rather than matching nothing.

While searching, toggle/merge_toggle/all/none are unavailable — their keys are needed as literal query text. search_toggle and search_merge_toggle take their place, marking the selected row for extraction/merging without leaving search, so several files sharing a prefix can be selected from one query instead of re-searching for each. search_select_all/search_merge_all go further and mark every row whose name currently matches the query in one press, rather than just the selected row.

search_merge_toggle defaults to Alt+m rather than a Ctrl-chord at all: outside an enhanced keyboard protocol, Ctrl+M and a plain Enter keypress send the exact same byte, so the terminal reports Ctrl+M as Enter — a bare Ctrl+m binding would silently never fire, and apply’s Enter binding would consume the keypress instead. Alt+m sidesteps the ambiguity entirely.

search_merge_all defaults to Ctrl+Alt+m — a superset of search_merge_toggle’s Alt+m, keeping the two mnemonically paired (m for merge, an extra modifier for “all”). It doesn’t collide with Enter either, since Alt alone isn’t held.

Row navigation reuses the same keys as the filter sidebar and log panel (from the navigation group) rather than duplicating them here: j/k (optionally count-prefixed, e.g. 12j), Ctrl+d/Ctrl+u for a half page, PageDown/PageUp for a full page, and gg/G (optionally count-prefixed, e.g. 25G) to jump to the first/last or a specific row.

Docker Select Mode

"docker_select": {
  "confirm": "Enter",
  "cancel": "Esc"
}

DLT Select Mode

"dlt_select": {
  "confirm": "Enter",
  "cancel": "Esc",
  "delete": "d",
  "next_field": "Tab",
  "prev_field": "Shift+Tab"
}

next_field/prev_field move between the connection form’s input fields (host, port, …) before confirming.

Value Colors Mode

"value_colors": {
  "toggle": "Space",
  "all": "a",
  "none": "n",
  "apply": "Enter",
  "cancel": "Esc"
}

Keybindings Help

"help": {
  "close": ["Esc", "q", "F1"]
}

Custom Commands

Bind a key to run a fixed command line, checked in Normal Mode ahead of every built-in action:

"custom": [
  {
    "key": "F2",
    "command": "load-filters ~/logs/filters/draco-mars.json"
  }
]

command is whatever you’d type after : in command mode — no leading :. key accepts any binding from the Key Syntax above, including an array of alternatives. Add as many entries as you like; each one gets its own row in :show-keybindings.

A custom binding that reuses a built-in action’s key wins over it (deliberately — see Conflict Validation below for how you’ll be warned about the collision, not blocked from making it).

Conflict Validation

At startup, logana validates all configured keybindings for conflicts within each mode scope. Conflicts are printed to stderr with a description of the overlapping bindings, but do not prevent startup.