Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

CLI Flags

These flags are passed when launching logana from the shell:

FlagDescription
<file>...One or more files or a directory to open. A directory opens every file inside it (including inside any archives found there), each in its own tab. A file argument with *, ?, or [] wildcards expands to every matching file. Omit to read from stdin.
-f, --filters <path>Preload a saved filter set (JSON). Filters are applied in a single pass during indexing and remain active for interactive use.
-i, --include <args>Add an include filter. Accepts the same arguments as :filter. May be repeated. Examples: -i "error", -i "--field level=ERROR"
-o, --exclude <args>Add an exclude filter. Accepts the same arguments as :exclude. May be repeated. Examples: -o "debug", -o "--field level=debug"
-t, --timestamp <args>Add a date/time range filter. Accepts the same arguments as :date-filter. May be repeated.
--tailStart at the end of the file and enable tail mode. Combined with --filters, the last matching line is available immediately after loading.
--mcp [PORT]Start the embedded MCP server on launch. Port defaults to 9876. See MCP Server.
--headlessRun without TUI — apply filters and write matching lines to stdout or --output.
--output <path>Write headless output to a file instead of stdout. Requires --headless.

In-App Commands

Press : in normal mode to open command mode. Tab completes commands, flags, colors, themes, and file paths. Command history is navigable with Up / Down.

Filtering

CommandDescription
:filter [--regex|-r] [--ignore-case|-i] [-l] [--fg COLOR] [--bg COLOR] <pattern>Add an include filter (show only matching lines)
:filter --field <key>=<value>Add a field-scoped include filter (e.g. level=error); repeat to require several fields at once
:filter --group|-g <name> <pattern>Assign the filter to a named group, toggleable together via :toggle-group
:filter --auto|-a <pattern>Add an include filter with a randomly generated, readable fg/bg color pair instead of specifying --fg/--bg
:filter --fga <pattern>Add an include filter with a random, colorful fg color readable against the current theme background; bg is left as given
:exclude [--regex|-r] [--ignore-case|-i] <pattern>Add an exclude filter (hide matching lines)
:exclude --field <key>=<value>Add a field-scoped exclude filter (e.g. level=debug)
:exclude --group|-g <name> <pattern>Assign the exclude filter to a named group
:highlight [--regex|-r] [--ignore-case|-i] [-l] [--fg COLOR] [--bg COLOR] <pattern> (alias :h)Add a highlight filter — colors matches without affecting visibility
:highlight --auto|-a <pattern>Add a highlight filter with a randomly generated, readable fg/bg color pair
:highlight --fga <pattern>Add a highlight filter with a random, colorful fg color readable against the current theme background
:date-filter <expr>Add a date/time range filter
:set-color [--fg COLOR] [--bg COLOR]Set highlight color for the selected filter
:toggle-group <name>Toggle every filter in a named group on/off together
:group <name> [--fg COLOR] [--bg COLOR] [-l] [--auto] [--clear]Set, update, or clear a group’s predefined color style, used by filters in the group with no color of their own
:filteringToggle all filtering on/off (bypass every filter)
:clear-filtersRemove all filter definitions
:disable-filtersDisable all filters without removing them
:enable-filtersEnable all disabled filters
:save-filters <file>Save current filters to a JSON file
:load-filters <file>Load filters from a JSON file
:import-filters <file> [-a|--append]Import a Notepad++ Analyze-plugin or User-Defined-Language XML config as Include filters. Replaces current filters by default; --append merges instead

Flag ordering: All options (--regex, --fg, --bg, -l, --field, --group/-g, --ignore-case/-i, --auto, --fga) must appear before the pattern. Everything after the first pattern word is treated as part of the pattern text. --auto cannot be combined with --fg/--bg. --fga cannot be combined with --fg or --auto.

See Filter Groups for the Groups sidebar and group management mode (Ctrl+g).

See Filtering, Date & Time Filters, and Field Filters for full details.

CommandDescription
:<N>Jump to line N (e.g. :500)

Files and Tabs

CommandDescription
:open <path>Open a file, directory, or compressed/archive file. A path with *, ?, or [] wildcards opens every matching file, each in its own tab. A directory opens every file inside it, each in its own tab; an archive shows its contents picker first — see Quick Start
:file-picker <path>Open a picker to choose which files to open from a directory or archive, instead of :open’s default of opening everything
:close-tabClose the current tab (quits if it’s the last tab)
:save <path>Save the currently visible (filtered) lines to a file in raw format
:export-marked <path>Export marked lines to a file
:run <program> [args...]Execute a command and stream its output to a new tab; stderr lines show as errors
:schema [name]Show the active schema, or switch this tab to a named custom or built-in schema. Use :schema none to treat the file as plain text
:default-filters [format] [path]Configure a filter file to auto-load whenever a format is assigned to a tab with no filters yet. No args opens a popup listing every format

Display

CommandDescription
:wrapToggle line wrap on/off (persisted across sessions)
:line-numbersToggle the line number gutter on/off (persisted across sessions)
:relative-line-numbersToggle relative line numbers — other rows show their distance from the selected row (persisted across sessions)
:tailToggle tail mode (auto-scroll on new content)
:rawToggle raw display — show input text while keeping format parsing enabled; title shows [RAW] when active
:collapseHide continuation lines file-wide, showing only each entry’s first line
:expandReveal continuation lines previously hidden by :collapse
:level-colorsOpen the level colors dialog — toggle coloring per level (TRACE, DEBUG, INFO, NOTICE, WARNING, ERROR, FATAL); INFO/TRACE/DEBUG/NOTICE are off by default
:value-colorsOpen the value colors dialog — toggle coloring for HTTP methods, status codes, IPs, UUIDs, and process/logger names
:set-theme <name>Switch the color theme (persisted across sessions)
:themeOpen a searchable picker to browse themes with live preview; Enter applies and persists, Esc restores the previous theme
:sidebar-position left|rightMove the filter sidebar to the left or right of the log panel (persisted across sessions)

OTel Collector

CommandDescription
:otel [port]Open an OTLP gRPC receiver tab (default port 4317)
:otel --http [port]Open an OTLP HTTP/JSON receiver tab (default port 4318)

See OTel Collector for full details.

MCP Server

CommandDescription
:enable-mcp [--port N]Start the embedded MCP server (default port 9876)
:disable-mcpStop the MCP server

See MCP Server for full details.

Live Data

These commands control how the current tab handles incoming data from a file watcher or stream (stdin, Docker).

CommandDescription
:stopPermanently stop all incoming data for the current tab — drops the file watcher and/or stream
:pauseFreeze the view; the background watcher/stream keeps running. Title shows [PAUSED]
:resumeResume applying incoming data; the latest snapshot is applied immediately

Note: :pause / :resume are non-destructive — no data is lost while paused. :stop is permanent; to resume watching a file after stopping, reopen it with :open.

Structured Fields

CommandDescription
:hide-field <col>Hide a single column
:show-field <col>Show a previously hidden column
:show-all-fieldsReset to default column display
:select-fieldsOpen an interactive column picker
:show-keysShow field keys alongside values (e.g. method=GET)
:hide-keysShow only values, hiding field keys (default)

Merged View

CommandDescription
:mergeOpen a source-selection popup, then create a new tab interleaving the selected tabs sorted by timestamp

See Multi-Tab for full details.

Export and Streaming

CommandDescription
:export <file> [-t <template>]Export annotations to a file (default template: markdown)
:dockerPick and stream a running Docker container
:dltPick and stream from a DLT daemon over TCP

Session

CommandDescription
:resetRestore all settings to defaults and clear all persisted state

Tab Completion

Command mode supports multi-tier tab completion:

  1. Color names — after --fg or --bg flags
  2. Template names — after -t / --template flags in :export
  3. File paths — for :open, :file-picker, :save-filters, :load-filters, :import-filters, :export
  4. Theme names — for :set-theme
  5. Command names — for everything else

Press Tab / Shift+Tab to cycle through completions. A highlighted suggestion appears in the hint area; Space accepts it.

Notepad++ import compatibility

The built-in importer accepts AnalysePlugin AnalyseDoc and Notepad++ UDL XML. AnalysePlugin normal, escaped and Rust-compatible regex searches preserve case, whole-word, doSearch, groups, foreground (color, with fgColor as an alias), background and select="text"/line scope. Omitted backgrounds remain unset; omitted foregrounds use Logana’s readable-contrast policy only when a background is explicitly provided, and otherwise remain unset. Whole words use Rust regex Unicode word boundaries, which can differ from Scintilla’s configured word characters. Escaped searches support control escapes and fixed-width binary, octal, decimal and hexadecimal character escapes.

For example, <SearchText color="red">ERROR</SearchText> imports red text with no background color. Logana keeps the current log background instead of painting it white. Adding bgColor="white" explicitly imports a white background. This also applies to UDL WordsStyle entries: a foreground-only style imports its keywords without adding a background. If neither color is provided, both remain unset.

UDL imports all eight keyword lists with their corresponding styles and Global caseIgnored setting. Multiple languages keep separate style lookups. Quoted phrases are kept together, but use literal whitespace. UDL keyword matching remains substring matching, including prefix-mode imports; it does not reproduce the UDL lexer, nesting, variable whitespace or multiline phrases. Comments, numbers, operators, folding and delimiters are not imported. Font decorations and inherited/transparent colors are not reproduced. Active unsupported options produce import warnings.

Malformed XML, DTDs, unknown search modes (including rgx_multiline) and regexes unsupported by Rust’s regex engine fail the import before filters are replaced. This includes lookarounds and backreferences. AnalysePlugin hide is reported as unsupported, rather than converted to an Exclude filter: it hides matched text in the plugin, while Exclude would hide the entire line. Import creates Include filters, so unmatched lines can be hidden by Logana. The standalone Python conversion script retains its legacy behavior.

Format references: AnalysePlugin serialization and defaults, AnalysePlugin schema, and the Notepad++ UDL manual.