config.toml

# ===== BASIC SETTINGS =====
# These settings go at the ROOT LEVEL (not in any [section])

# Highlight color for selected items and cursor
highlight_color = "LightBlue"

# Keybinds (optional - uncomment to customize)
# See keybinds.toml for examples
# [keybinds]
# up = ["up", { key = "p", modifiers = "ctrl" }]
# down = ["down", { key = "n", modifiers = "ctrl" }]
# select = ["enter"]
# exit = ["esc"]
# pin = [{ key = "space", modifiers = "ctrl" }]
# hide = [{ key = "delete", modifiers = "alt" }]
# unhide_last = [{ key = "u", modifiers = "alt" }]

# Cursor character in search box
cursor = "█"

# Command to launch terminal apps (apps with Terminal=true). Use "tty" for TTY mode (same as -t/--tty).
terminal_launcher = "kitty -e"

# Don't wrap around at list ends (false = wrap around)
hard_stop = false

# Use rounded corners for panels
rounded_borders = true

# ===== COLORS =====
# WARNING: Color options go at ROOT LEVEL (not in [app_launcher])
# Note: Colors can be overridden in [dmenu] and [cclip] sections for mode-specific styling
# Formats: Named ("Red", "LightBlue"), Hex ("#ff0000", "#f00"),
#          RGB ("rgb(255,0,0)"), 8-bit ("196")

# Border colors for each panel
main_border_color = "White"      # Border color for the main info panel (top)
apps_border_color = "White"      # Border color for the apps list panel (middle)
input_border_color = "White"     # Border color for the input panel (bottom)

# Text Colors (non-highlighted text in each panel)
main_text_color = "White"        # Text color for the main info panel
apps_text_color = "White"        # Text color for the apps list
input_text_color = "White"       # Text color for the input field

# Pin/Favorite Settings
pin_color = "rgb(255,165,0)"     # Color for pin icon (default: orange)
pin_icon = "📌"                   # Icon for pinned apps (use Ctrl+Space to pin/unpin)

# Show selected app name in panel titles (instead of "Apps"/"Fsel")
fancy_mode = false

# Panel title color
header_title_color = "LightBlue"

# ===== LAYOUT =====

# Top panel height as percentage (0-70%)
# Set to 0 to hide the title/content panel entirely
title_panel_height_percent = 30

# Input panel height in lines (1-10)
input_panel_height = 3

# Title panel position: "top", "middle", or "bottom"
title_panel_position = "top"

# ===== SECTIONS =====
# All sections must be at the bottom of the file!

# ===== APP LAUNCHER =====
# These settings MUST be in the [app_launcher] section
# WARNING: DO NOT put color/UI options here - they belong at the root level!
[app_launcher]

# Filter apps based on OnlyShowIn/NotShowIn and $XDG_CURRENT_DESKTOP
# Hides apps not meant for your desktop environment
filter_desktop = true

# Hide desktop action entries such as "New Window" and "Open Private Window"
# false = keep action entries visible, true = show only main app entries
filter_actions = false

# Suppress duplicate desktop IDs and equal visible names using XDG directory precedence
# false keeps every discovered source visible unless you hide it manually
auto_hide_duplicates = false

# Include raw executables from $PATH (ls, grep, etc.)
list_executables_in_path = false

# Hide app list until you start typing
hide_before_typing = false

# Optional command prefix used before launched apps
# Example: ["runapp", "--"] or ["uwsm", "app", "--"]
# launch_prefix = ["runapp", "--"]

# Match mode: "fuzzy" or "exact"
# fuzzy = fzf-style matching (fire matches Firefox)
# exact = only exact/starts-with/contains matches
# note: in -p/--program mode, exact requires an exact app or executable name
match_mode = "fuzzy"

# Ranking mode for initial app order and score boost tie-breaking:
# frecency  = frequency + recency (default, zoxide-style)
# recency   = most recently launched first
# frequency = most frequently launched first
ranking_mode = "frecency"

# Pinned apps ordering:
# ranking       = follow selected ranking_mode (default)
# alphabetical  = pinned apps sorted by name
# oldest_pinned = pinned apps sorted by first pin time (oldest first)
# newest_pinned = pinned apps sorted by first pin time (newest first)
pinned_order = "ranking"

# Confirm before launching with -p if app has never been launched before
# Helps prevent accidental launches of wrong apps
confirm_first_launch = false

# Character depth for prefix matching priority (default: 3)
# When query length is within this depth, prefix matches (exact, word-start)
# are prioritized over fuzzy matches. Beyond this depth, all matches use fuzzy scoring.
# Example: With prefix_depth=3, typing "fi" (2 chars) prioritizes prefix matches,
#          but typing "fire" (4 chars) uses fuzzy matching for all results.
prefix_depth = 3

# ===== DMENU MODE =====
# Override settings when using --dmenu flag
# Inherits from main settings if not specified
# These settings MUST be in the [dmenu] section

[dmenu]

# Colors (optional overrides)
# highlight_color = "LightBlue"
# cursor = "█"

# Border colors
# main_border_color = "White"
# items_border_color = "White"
# input_border_color = "White"

# Text colors
# main_text_color = "White"
# items_text_color = "White"
# input_text_color = "White"

# UI
# rounded_borders = true
# hard_stop = false
# header_title_color = "LightBlue"

# Layout
# title_panel_height_percent = 40
# input_panel_height = 3
# title_panel_position = "top"

# Parsing
delimiter = " "                  # Column delimiter (override with --delimiter)
show_line_numbers = true         # Show line numbers in content
wrap_long_lines = true           # Wrap long lines

# Behavior
password_character = "*"         # Character for --password mode
exit_if_empty = false            # Exit if stdin is empty

# ===== CLIPBOARD MODE =====
# Override settings when using --cclip flag
# Inherits from [dmenu] then main settings
# These settings MUST be in the [cclip] section

[cclip]

# Colors (optional overrides)
# highlight_color = "LightBlue"
# cursor = "█"

# Border colors
# main_border_color = "White"
# items_border_color = "White"
# input_border_color = "White"

# Text colors
# main_text_color = "White"
# items_text_color = "White"
# input_text_color = "White"

# UI
# rounded_borders = true
# hard_stop = false
# header_title_color = "LightBlue"

# Layout
# title_panel_height_percent = 40
# input_panel_height = 3
# title_panel_position = "top"

# Display
show_line_numbers = true         # Show cclip rowid
wrap_long_lines = true           # Wrap long lines

# Images (Kitty/Sixel/Halfblocks-capable terminal; built-in ratatui-image, no chafa)
image_preview = true             # Show inline image previews
hide_inline_image_message = false # Hide "[Inline Image Preview]" text

# Tags (requires cclip with tag support)
# show_tag_color_names = false   # Show tag color names in display