From 9f39129efb923813dbb4fbdbad53cce919f4a267 Mon Sep 17 00:00:00 2001
From: OkayishComputer <okayishcomputer@noreply.codeberg.org>
Date: Fri, 19 Dec 2025 04:11:43 +0100
Subject: [PATCH] Update res/config.ini

Re-organized options to keep related settings together, rephrased some of the color comments to make the color behavior clearer to new users, added headings to sections, added diagram of main box
---
 res/config.ini | 61 ++++++++++++++++++++++++++++++++------------------
 1 file changed, 39 insertions(+), 22 deletions(-)

diff --git a/res/config.ini b/res/config.ini
index 4165350..82d20c5 100644
--- a/res/config.ini
+++ b/res/config.ini
@@ -1,11 +1,11 @@
-### STYLE AND COLOR CONFIGURATION ###
+### APPEARANCE ###
 
 # Use full 24-bit RGB color (true) or indexed 8-color mode (false)
 full_color = true
 
 # If full_color is true, each color assigned in this config should be a 32-bit value (24-bit RGB + 8-bit styling).
 # The format is 0xSSRRGGBB, where SS is the styling, RR is red, GG is green, and BB is blue.
-# Each color component (RR, GG, BB) is a hexadecimal value from 00 to FF. (0-255 in decimal notation)
+# Each color component (RR, GG, BB) is a hexadecimal value from 00 to FF. (0-255)
 
 # Here are the possible styling options:
 # TB_BOLD      0x01RRGGBB
@@ -17,15 +17,15 @@ full_color = true
 # TB_BRIGHT    0x40RRGGBB
 # TB_DIM       0x80RRGGBB
 
-# For example, pure red would be 0x00FF0000, bold green would be 0x010000FF00.
 # Note that, if you want to use the default color value of the terminal, you can use the
 # special value 0x00000000. This means that, if you want to use black, you *must* use
 # the styling option TB_HI_BLACK (the RGB values are ignored when using this option).
 
 # If full_color is false, output will be in indxed 8-color mode.
-# In this mode, each color assigned in this config should use the format 0xSS0C, where SS is styling, and C is an integer from 0-8.
+# In this mode, each color assigned in this config should use the following format:
+# 0xSS0C, where SS is styling, and C is an integer from 0-8.
 
-# All eight-color mode color codes:
+# All eight eight-color color codes:
 # TB_DEFAULT              0xSS00
 # TB_BLACK                0xSS01
 # TB_RED                  0xSS02
@@ -40,26 +40,26 @@ full_color = true
 # NOTE: 256-color .dur files will ONLY be displayed if full_color is true.
 
 # Background color id
+# 8-color:
+#    0x0000
 bg = 0x00000000
 
 # Border foreground color id
-# Default is white
+#           0x0108
 border_fg = 0x00FFFFFF
 
 # Error background color id
+#          0x0000
 error_bg = 0x00000000
 
 # Error foreground color id
-# Default is red and bold
+#          0x0102
 error_fg = 0x01FF0000
 
 # Foreground color id
-# Default is white
+#    0x0108
 fg = 0x00FFFFFF
 
-# Allow empty password or not when authenticating
-allow_empty_password = true
-
 # The character used to mask the password
 # You can either type it directly as a UTF-8 character (like *), or use a UTF-32
 # codepoint (for example 0x2022 for a bullet point)
@@ -80,13 +80,6 @@ blank_box = true
 # If set to null, none will be shown
 box_title = null
 
-# Erase password input on failure
-clear_password = false
-
-# Input box active by default on startup
-# Available inputs: info_line, session, login, password
-default_input = login
-
 # Set margin to the edges of the DM (useful for curved monitors)
 edge_margin = 0
 
@@ -118,6 +111,21 @@ margin_box_v = 1
 # Center the session name.
 text_in_center = false
 
+# Here is a diagram of the main box layout:
+
+# ┌Title─────────────────────────┐
+# │                              │
+# │  <          Info          >  │
+# │                              │
+# │  environment  < session   >  │
+# │                              │
+# │  login        < username  >  │
+# │                              │
+# │  password     ******         │
+# │                              │  
+# └──────────────────────────────┘
+
+# CLOCK #
 # Change the state and language of the big clock
 # none -> Disabled (default)
 # en   -> English
@@ -134,9 +142,9 @@ bigclock_seconds = false
 # If null, the clock won't be shown
 clock = null
 
+#####################################################################################
 
-
-### ANIMATION CONFIGURATION ###
+### ANIMATION ###
 
 # The active animation
 # none       -> Nothing
@@ -181,7 +189,7 @@ dur_x_offset = 0
 dur_y_offset = 0
 
 
-# CONWAY #
+# CONWAY'S GAME OF LIFE #
 # Game of Life entropy interval (0 = disabled, >0 = add entropy every N generations)
 # 0 -> Pure Conway's Game of Life (will eventually stabilize)
 # 10 -> Add entropy every 10 generations (recommended for continuous activity)
@@ -228,10 +236,19 @@ colormix_col2 = 0x000000FF
 # Color mixing animation third color id
 colormix_col3 = 0x20000000
 
+##########################################################################
 
+### PATHS AND BEHAVIOR ###
 
+# Allow empty password or not when authenticating
+allow_empty_password = true
 
-### PATHS AND BEHAVIOR CONFIGURATION ###
+# Erase password input on failure
+clear_password = false
+
+# Input box active by default on startup
+# Available inputs: info_line, session, login, password
+default_input = login
 
 # The number of failed authentications before a special animation is played... ;)
 # If set to 0, the animation will never be played