config.example.toml

# SPDX-FileCopyrightText: 2026 fxrdhan
# SPDX-License-Identifier: EUPL-1.2

# Example Configuration File for `lez`
#
# An explicit file is the only one read:
#   --config <PATH>, else $LEZ_CONFIG_FILE, $EZA_CONFIG_FILE or $EXA_CONFIG_FILE
#
# Otherwise the first of config.toml, lez.toml, config.yaml and config.yml in
# the configuration directory is read, which is the first of:
#   1. $LEZ_CONFIG_DIR, else $EZA_CONFIG_DIR
#   2. $XDG_CONFIG_HOME/lez (or .../eza if only that exists), when set
#   3. the platform's: ~/.config/lez on Linux,
#      ~/Library/Application Support/lez on macOS, %APPDATA%\lez on Windows
#      (or .../eza if only that exists)
#
# Local (per-directory) configuration:
#   .lez.toml, .lez.yaml, .lez.yml, .eza.toml, .eza.yaml in current working directory.
#
# Precedence hierarchy:
#   CLI Argument > Environment Variable > Local Config (.lez.toml) > Global Config (config.toml) > Built-in Default

[display]
# Default view mode: "grid", "lines" (oneline), "long", "tree", "json", or "code"
# mode = "grid"

# Show table column headers in long view
# header = true

# Show group ownership column
# group = false

# Show numeric user and group IDs instead of names
# numeric = false

# Show hard link count column
# links = false

# Show inode number column
# inode = false

# Show mount points / filesystem info in long mode
# mounts = false

# Show the size of the allocated filesystem blocks, in bytes (`-S`)
# blocksize = false

# Show the number of allocated filesystem blocks (`--blocks`)
# blocks = false

# Calculate and show recursive directory total size (can be slow on large trees);
# only the long view and size sorts use it, so other views skip the walk
# total_size = false

# Characters in a file size's number, the decimal point included, from 1 to 8
# (default 3, as in `2.3M`; 4 gives `2.35M`)
# size_digits = 3

# Timestamp style: "default", "iso", "long-iso", "full-iso", "relative", "relative-recent", or custom strftime "+%Y-%m-%d %H:%M"
# time_style = "default"

# Show permissions in octal format (Unix only)
# octal_permissions = false

# Dereference symlinks when showing file details
# dereference = false

# Show extended attributes in long view
# extended = false

# Show security context (SELinux, AppArmor, Windows security)
# security_context = false

# Show BSD / macOS / Windows file flags
# file_flags = false

# Only show group column if group name differs from owner
# smart_group = false

# Cut user and group names wider than this many columns (0 leaves them whole)
# owner_width = 12

# Absolute path mode: "off", "on", or "follow"
# absolute = "off"

# Embed hyperlinks (OSC 8): "never", "auto", or "always"
# hyperlink = "never"

# Filename quoting style: "never", "auto", or "always"
# quotes = "auto"

[filter]
# Show all hidden and dot files (equivalent to -a)
# all = false

# Show hidden files excluding '.' and '..' (equivalent to -A)
# almost_all = false

# List only directories
# only_dirs = false

# List only regular files
# only_files = false

# Show dotfiles without showing other hidden entries
# show_dotfiles = false

# Do not show system files (Windows only)
# no_system = false

# Do not show entries with the Windows hidden attribute (Windows only)
# no_hidden_attrib = false

# Do not show Windows hidden profile links / junctions (Windows only)
# no_hidden_links = false

# List of glob patterns to ignore
# ignore_globs = ["*.tmp", ".DS_Store", "node_modules"]

# Ignore git submodule contents
# ignore_submodules = false

# Respect .gitignore rules when within a Git repository
# git_ignore = false

# Sort field: "name", "filename", "lex", "size", "extension", "date", "modified", "accessed", "created", "type", "inode", "none"
# sort = "name"

# Reverse sort order
# reverse = false

# Maximum directory recursion depth
# level = 2

[git]
# Show Git status in long mode
# git = false

# Display Git status indicators using Nerd Font glyphs/icons
# git_glyphs = false

# List git repository status summary and branch
# git_repos = false

# List git repository branch name only (faster)
# git_repos_no_status = false

[icons]
# When to display icons: "never", "auto", or "always"
# icons = "auto"

# Number of spaces between icons and file names (1, 2, or 3)
# spacing = 1

[theme]
# Terminal colour usage: "never", "auto", or "always"
# color = "auto"

# Colour scale highlighting: "none", "all", "age", or "size"
# color_scale = "none"

# Colour scale gradient mode: "fixed" or "gradient"
# color_scale_mode = "gradient"

# A theme from the themes folder of the configuration directory, read
# instead of theme.yml: "night" reads themes/night.yml or themes/night.yaml
# name = "night"

[loc]
# Format for sub-language files column: "symbol" (default '*'), "count" (file count), or "blank"
# sub_files = "symbol"

# Number of decimal digits to display for percentages (0..=8, default: 1)
# percent_digits = 1

# Whether to display the Language column alongside lines-of-code
# language = true