docs: add example config file

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