Swadhin Biswas docs: add example config file · 3/1/2026
5e327e2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
# =============================================================================
# FetchX Configuration File
# Location: ~/.config/fetchx/config.toml
#
# FetchX is a fast, modern system info tool (neofetch clone in Rust).
# All options have sensible defaults — only set what you want to change.
# =============================================================================
# ─── Display Options ─────────────────────────────────────────────────────────
# Disable all colors
# no_color = false
# Enable bold text
# bold = true
# Separator between label and value
# separator = ": "
# ─── Text Colors ─────────────────────────────────────────────────────────────
# Either "distro" for automatic color matching, or an array of 6 color numbers:
# [title, @, underline, subtitle, colon, info]
#
# Color numbers: 0=black, 1=red, 2=green, 3=yellow, 4=blue,
# 5=magenta, 6=cyan, 7=white, 8-255=256-color palette
#
# Examples:
# colors = "distro" # auto-detect from distro (default)
# colors = [4, 6, 1, 8, 8, 6] # blue title, cyan @, red underline, etc.
# colors = [6, 6] # cyan title & subtitle, rest default
colors = "distro"
# ─── ASCII Art / Logo ────────────────────────────────────────────────────────
# Image backend: "ascii", "kitty", "sixel", "chafa", "off"
# image_backend = "ascii"
# Image source: "auto", "ascii", "wallpaper", "/path/to/image.png"
# image_source = "auto"
# Which distro's ASCII art to display (when image_backend = "ascii")
# Values: "auto", "arch", "ubuntu", "debian", "fedora", "gentoo", "nixos",
# "manjaro", "void", "pop", "cachyos", "endeavouros", "artix", "kali",
# "opensuse", "linuxmint", "alpine", "garuda", "zorin", "elementary",
# "rocky", "alma", "slackware", "centos", "solus", "deepin", "mx",
# "raspbian", "freebsd", "openbsd", "macos", "windows", "android"
# ascii_distro = "auto"
# Path to a custom ASCII art file (overrides ascii_distro when set)
# The file can use {c1}..{c6} color placeholders, one line per line of art.
# Example: ascii_file = "/home/user/.config/fetchx/my_logo.txt"
# ascii_file = null
# Colors for ASCII art: "distro" or explicit color numbers
# Examples:
# ascii_colors = "distro" # use distro's default colors
# ascii_colors = [4, 6, 1] # custom colors for {c1}, {c2}, {c3}
ascii_colors = "distro"
# Bold the ASCII art
# ascii_bold = true
# ─── Image Options (for kitty/sixel/chafa backends) ──────────────────────────
# Path to a custom image file
# custom_image = "/path/to/image.png"
# Image size: "auto", "none", or dimensions like "300px", "50%"
# image_size = "auto"
# Crop mode: "normal", "fit", "fill"
# crop_mode = "normal"
# Crop offset: "center", "north", "south", "east", "west",
# "northwest", "northeast", "southwest", "southeast"
# crop_offset = "center"
# ─── Extra Features ──────────────────────────────────────────────────────────
# Use emoji art instead of ASCII art
# emoji_mode = false
# Use Nerd Font icons for info labels (requires a Nerd Font terminal font)
# nerd_font = false
# ─── Layout ──────────────────────────────────────────────────────────────────
# Gap between logo/image and info text (characters)
# gap = 3
# Show only the logo, hide system info
# logo_only = false
# ─── Info Fields ─────────────────────────────────────────────────────────────
# Toggle which info lines to display
show_title = true
show_underline = true
show_os = true
show_host = true
show_kernel = true
show_uptime = true
show_packages = true
show_shell = true
show_resolution = true
show_de = true
show_wm = true
show_wm_theme = true
show_theme = true
show_icons = true
show_terminal = true
show_term_font = true
show_cpu = true
show_gpu = true
show_memory = true
show_disk = false
show_battery = false
show_local_ip = false
show_public_ip = false
show_locale = false
show_colors = true
# ─── Color Blocks ───────────────────────────────────────────────────────────
# Range of colors to display in color blocks
# Default shows all 16 standard terminal colors (0-15)
# block_range = [0, 15]
# Width of each color block (in spaces)
# block_width = 3
# Height of color blocks (in lines)
# block_height = 1
# ─── Underline ───────────────────────────────────────────────────────────────
# Character used for the title underline
# underline_char = "-"
# ─── Misc ────────────────────────────────────────────────────────────────────
# Stdout mode: disable colors and image (useful for piping)
# stdout = false