config.example.yaml

# exex configuration example.
#
# Save this to $XDG_CONFIG_HOME/exex/config.yaml (or
# $HOME/.config/exex/config.yaml) and edit. Every field is optional —
# unset entries keep their built-in defaults, so you only need to include the
# parts you want to override.
#
# Colour values use lipgloss syntax: either a #RRGGBB hex string or an ANSI
# 256-colour index (e.g. "203"). See
# https://www.ditig.com/256-colors-cheat-sheet for the index palette.
#
# Keys use Bubble Tea's key strings: "ctrl+c", "tab", "enter", "left",
# "pgdown", letter and digit literals. Any binding can be a single value
# (`quit: q`) or a list (`quit: [q, ctrl+c]`).

# Colour theme, applied before the `colors:` overrides below. Besides the
# built-in nord (default), dark, solarized-dark and solarized-light, this accepts
# ANY Chroma style name (dracula, monokai, github-dark, gruvbox, onedark, …) and
# derives the whole UI palette from it. Individual `colors:` entries still win.
# Tip: press `,` in-app to change the theme (and more) live.
theme: nord

colors:
  # ---- Disassembly: instruction-class mnemonic colour --------------------
  instruction_call: "39"      # `call`, `bl`, `jal`
  instruction_ret: "203"      # `ret`, `iret`
  instruction_jump_unconditional: "220"
  instruction_jump_conditional: "213"
  instruction_syscall: "84"
  instruction_nop: "240"
  instruction_mnemonic_default: "117"

  # ---- Disassembly: address columns + operand links ----------------------
  address_column: "245"                      # left-most "0x401234" column (grey so symbols pop)
  address_link_intra_function: "85"          # local jump targets
  address_link_inter_function: "51"          # cross-function calls / PLT

  # ---- Disassembly: mnemonic + operand tokens (built-in highlighter) -----
  # Used by the lite build, and by the full build when no Chroma asm lexer
  # matches. (The full build's normal asm colours come from `syntax_theme`.)
  asm_register: "152"                        # registers in operands (rax, x0, %rdi)
  asm_immediate: "215"                       # immediate / numeric literals
  asm_move: "80"                             # mov / load / store / push / pop / lea
  asm_arith: "176"                           # add / sub / cmp / test / logic / shifts
  hex_pointer_fg: "75"                        # mapped pointer words in the hex pointer-decode view (p)

  # ---- Sticky "current symbol" banner above the disasm scroller ----------
  sticky_symbol_banner_fg: "231"
  sticky_symbol_banner_bg: "236"

  # ---- Symbol-table view (by ELF symbol type) ----------------------------
  symbol_function: "84"        # STT_FUNC
  symbol_data_object: "75"     # STT_OBJECT
  symbol_source_file: "245"    # STT_FILE
  symbol_section: "213"        # STT_SECTION
  symbol_tls: "177"            # STT_TLS
  symbol_common: "215"         # STT_COMMON
  symbol_other: "250"          # STT_NOTYPE and friends

  # ---- Section-table view (by section semantics) -------------------------
  section_executable_code: "84"    # .text, .plt, .init
  section_writable_data: "75"      # .data, .bss, .got
  section_readonly_data: "117"     # .rodata, .interp
  section_tls: "177"
  section_debug_info: "240"        # .debug_*, .zdebug_*
  section_note: "245"              # .note.*
  section_symbol_table: "213"      # SYMTAB / DYNSYM / STRTAB
  section_dynamic_linking: "141"   # DYNAMIC / HASH / GNU_VERSYM*
  section_relocations: "173"       # REL / RELA

  # ---- Source pane syntax-highlighting theme -----------------------------
  # Any chroma style name, e.g. monokai, github-dark, nord, dracula,
  # catppuccin-mocha, onedark, vulcan. Omit to follow the built-in theme.
  # syntax_theme: nord

  # ---- Source pane: cursor position + code-mapping highlight --------------
  source_current_line_fg: "231"   # the line the cursor is on
  source_current_line_bg: "63"
  source_mapped_fg: "153"          # address mapping to the current line (no caret)
  source_code_line_fg: "252"       # lines with code / addresses mapping elsewhere
  source_unmapped_fg: "240"        # dimmed, unmapped lines / gutter
  # Per-column correlation highlight (carets, column numbers, mapped addresses).
  # Cycled across a source line's distinct columns. Omit to keep the default.
  # column_palette: ["203", "220", "84", "39", "213", "51", "215", "141"]

  # ---- View body ----------------------------------------------------------
  # Optional non-transparent background behind view/pane content. Omit to use
  # the terminal background.
  # view_bg: "236"

  # ---- Window chrome: title, tab strip, footer ---------------------------
  title_fg: "231"
  title_bg: "66"
  tab_fg: "245"
  tab_active_fg: "231"
  tab_active_bg: "63"
  footer_fg: "245"
  header_key_fg: "75"              # "Key:" labels on the Info page

  # ---- Tables (Sections / Symbols / Strings) -----------------------------
  table_header_fg: "231"
  table_header_bg: "236"
  table_row_fg: "252"
  table_selected_fg: "231"
  table_selected_bg: "63"

  # ---- Shared accents ----------------------------------------------------
  symbol_name_fg: "214"            # bold symbol names (entry, libraries)
  section_banner_fg: "214"         # centred "==== .section ====" banner

  # ---- Modal overlays + search switches ----------------------------------
  modal_border_fg: "63"
  search_switch_fg: "231"
  search_switch_bg: "238"

  # ---- Help overlay ------------------------------------------------------
  help_key_fg: "214"
  help_desc_fg: "252"
  help_head_fg: "117"

  # ---- Tree views (symbols/sources/libs collapsible group rows) -----------
  tree_node_fg: "141"

  # ---- Status footer messages --------------------------------------------
  status_error_fg: "203"
  status_info_fg: "114"
  status_warn_fg: "214"            # partial/weak hardening flags on Info page

  # ---- File-path colouring (Libraries / Sources) -------------------------
  # Paths are coloured by their top directory components (whole subtrees share a
  # colour). This palette is cycled; a few entries keeps the differentiation
  # coarse. Omit to keep the built-in palette.
  # path_palette: ["75", "114", "214", "141", "213"]

  # ---- Hex / Raw byte colouring ------------------------------------------
  # The per-byte colour ramp. Must be exactly 18 colours: [0]=0x00,
  # [1..16]=high-nibble buckets for 0x01..0xFE, [17]=0xFF. Omit to keep the
  # built-in rainbow ramp.
  # hex_byte_palette:
  #   - "#808080"   # 0x00
  #   - "#FF71A9"   # 0x01..0x0F
  #   - "#FF7A78"   # 0x10..0x1F
  #   - "#FF8123"   # 0x20..0x2F
  #   - "#F79300"   # 0x30..0x3F
  #   - "#E69F00"   # 0x40..0x4F
  #   - "#C1B200"   # 0x50..0x5F
  #   - "#82C600"   # 0x60..0x6F
  #   - "#00D500"   # 0x70..0x7F
  #   - "#00D459"   # 0x80..0x8F
  #   - "#00D091"   # 0x90..0x9F
  #   - "#00CCBB"   # 0xA0..0xAF
  #   - "#00C7DE"   # 0xB0..0xBF
  #   - "#00BEFF"   # 0xC0..0xCF
  #   - "#6CAFFF"   # 0xD0..0xDF
  #   - "#B298FF"   # 0xE0..0xEF
  #   - "#FF4DFF"   # 0xF0..0xFE
  #   - "#FFFFFF"   # 0xFF

keys:
  quit: [q, ctrl+c]
  goto: g
  view_info: "1"
  view_sections: "2"
  view_symbols: "3"
  view_disasm: "4"
  view_hex: "5"
  view_libs: "6"
  view_raw: "7"
  view_strings: "8"
  view_sources: "9"
  toggle_source: tab
  copy_address: a
  copy_symbol: s
  copy_path: c
  open_disasm: d
  wrap: w
  filter_type: t
  search_mode: ctrl+t
  search_direction: ctrl+r
  search_origin: ctrl+o
  next: "]"   # next symbol (disasm) / next non-zero byte (hex/raw)
  prev: "["   # previous symbol / previous non-zero byte
  settings: ","   # open the settings popup

behavior:
  # View to open on startup: info, sections, symbols, disasm, hex, raw,
  # strings, libs, sources. Defaults to info.
  default_view: info
  # Tint the view/pane area with the theme background. Off by default (the UI
  # uses the terminal's own background). Toggle live from the settings popup (,).
  background: false
  # Start with long-line wrapping enabled. The `w` key still toggles wrapping for
  # the current session. Toggle/save live from the settings popup (,).
  default_wrap: false
  # Open the Symbols / Sources / Libs views as a collapsible namespace/path tree
  # (grouping C++/Swift scoped names by "."/"::", file & library paths by "/")
  # instead of a flat list. The `f` key toggles each for the session; toggle/save
  # live from the settings popup (,).
  tree_symbols: false
  tree_sources: false
  tree_libs: false
  # Start every tree fully collapsed (top-level groups only). `+`/`−` expand or
  # collapse all for the session.
  tree_collapsed: false
  # Start the Symbols view with long "(…)"/"<…>" contents (parameter lists and
  # template arguments) shown as "..."; short ones (≤5 chars, e.g. "<int>") are kept.
  # `e` toggles all rows and `.` toggles the row under the cursor for the session;
  # the all-rows toggle also abbreviates symbol names in the disasm/hex/pointer
  # annotations. Toggle/save live from the settings popup (,).
  abbrev_args: false
  # Disasm/hex display toggles (all default off; flip them live from the settings
  # popup with ',').
  # Hide the raw instruction-byte column in the disasm view (like objdump
  # --no-show-raw-insn), reclaiming width for the code and source pane.
  hide_disasm_bytes: false
  # Hide the symbol/target annotations in the disasm and hex views.
  hide_annotations: false
  # Separate instruction bytes with spaces ("01 00 00 14") instead of the compact
  # form ("01000014"), matching the `-o disasm` dump.
  spaced_disasm_bytes: false
  # Where the disasm view lands by default (and redirects to when asked to show
  # a non-executable address): lowest, text, main, start, or entry. Defaults to
  # lowest (the lowest executable address). Unresolvable choices fall back.
  default_disasm_target: lowest
  # Maximum executable bytes decoded into disassembly at once. Navigation and
  # search slide this window through the executable image with overlap.
  disasm_max_bytes: 2097152  # 2 MiB
  # Parallel workers for background disasm search. 0 keeps the adaptive default.
  disasm_search_workers: 0