From 9885a192a13721e82f6674e433a3b711f06f0910 Mon Sep 17 00:00:00 2001
From: "s0wlz (Matthias Puchstein)" <matthias@puchstein.lu>
Date: Wed, 31 Dec 2025 01:22:20 +0100
Subject: [PATCH] feat: add Btop resource monitor template

- Created Jinja2 template for Btop theme.
- Mapped system DNA to Btop graph gradients and UI elements.
- Updated documentation and repository map.
---
 GEMINI.md                    |  1 +
 INSTALL.md                   | 40 ++++++++++++++--
 README.md                    |  1 +
 templates/btop/apex.theme.j2 | 89 ++++++++++++++++++++++++++++++++++++
 templates/btop/meta.yaml     |  4 ++
 5 files changed, 132 insertions(+), 3 deletions(-)
 create mode 100644 templates/btop/apex.theme.j2
 create mode 100644 templates/btop/meta.yaml

diff --git a/GEMINI.md b/GEMINI.md
index ad3afa0..f43a567 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -83,5 +83,6 @@ Apex is not about pretty colors; it is about signal clarity.
 │ ├── fuzzel/
 │ ├── waybar/
 │ ├── zathura/
+│ ├── btop/
 │ └── alacritty/
 └── dist/ # Compiled theme files (gitignore this)
diff --git a/INSTALL.md b/INSTALL.md
index 0de1140..3ffe348 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -275,11 +275,45 @@ All generated theme files can be found in the `dist/` directory after running `u
 
             2. Or include it in your existing config:
 
-               ```conf
+                  ```conf
 
-               include apex-neon-zathurarc
+                  include apex-neon-zathurarc
 
-               ```
+                  ```
+
+               
+
+               ---
+
+               
+
+               ## 12. Btop
+
+               
+
+               **Files:**
+
+               - `dist/btop/apex-neon.theme`
+
+               - `dist/btop/apex-aeon.theme`
+
+               
+
+               **Installation:**
+
+               1. Copy the desired file to your Btop themes directory (usually `~/.config/btop/themes/`):
+
+                  ```bash
+
+                  mkdir -p ~/.config/btop/themes
+
+                  cp dist/btop/*.theme ~/.config/btop/themes/
+
+                  ```
+
+               2. Select the theme within Btop settings (ESC -> Options -> Color theme).
+
+               
 
             
 
diff --git a/README.md b/README.md
index 905e43a..18d0d34 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ The factory currently generates native themes for:
 - **Fuzzel** (INI)
 - **Waybar** (CSS variables)
 - **Zathura** (Config)
+- **Btop** (Theme)
 
 ## The Apex DNA
 
diff --git a/templates/btop/apex.theme.j2 b/templates/btop/apex.theme.j2
new file mode 100644
index 0000000..cea291e
--- /dev/null
+++ b/templates/btop/apex.theme.j2
@@ -0,0 +1,89 @@
+# {{ scheme }} — Btop Theme
+# DNA: State over Decoration
+
+# Main background, empty for terminal default, black for dark themes
+theme[main_bg]="{{ palette.background }}"
+
+# Main text color
+theme[main_fg]="{{ palette.foreground }}"
+
+# Title color for boxes
+theme[title]="{{ palette.foreground }}"
+
+# Highlight color for keyboard shortcuts
+theme[hi_fg]="{{ palette.cursor }}"
+
+# Background color of selected item in processes box
+theme[selected_bg]="{{ palette.selection }}"
+
+# Foreground color of selected item in processes box
+theme[selected_fg]="{{ palette.selection_fg }}"
+
+# Color of inactive/disabled text
+theme[inactive_fg]="{{ ui.dim }}"
+
+# Color of text appearing on top of graphs, i.e. usage percentage
+theme[graph_text]="{{ ui.dim }}"
+
+# Background color of the percentage meters
+theme[meter_bg]="{{ ui.panel }}"
+
+# Misc colors for processes box including mini cpu graphs, used memory percentage, and entries filter
+theme[proc_misc]="{{ palette.info }}"
+
+# Cpu box outline color
+theme[cpu_box]="{{ ui.border }}"
+
+# Memory box outline color
+theme[mem_box]="{{ ui.border }}"
+
+# Net box outline color
+theme[net_box]="{{ ui.border }}"
+
+# Processes box outline color
+theme[proc_box]="{{ ui.border }}"
+
+# Box divider line and small boxes line color
+theme[div_line]="{{ ui.border }}"
+
+# Temperature graph colors
+theme[temp_start]="{{ palette.info }}"
+theme[temp_mid]="{{ palette.special }}"
+theme[temp_end]="{{ palette.cursor }}"
+
+# CPU graph colors
+theme[cpu_start]="{{ palette.info }}"
+theme[cpu_mid]="{{ palette.special }}"
+theme[cpu_end]="{{ palette.cursor }}"
+
+# Mem graph colors
+theme[free_start]="{{ palette.success }}"
+theme[free_mid]="{{ palette.warning }}"
+theme[free_end]="{{ palette.cursor }}"
+
+theme[cached_start]="{{ palette.info }}"
+theme[cached_mid]="{{ palette.special }}"
+theme[cached_end]="{{ palette.cursor }}"
+
+theme[available_start]="{{ palette.success }}"
+theme[available_mid]="{{ palette.warning }}"
+theme[available_end]="{{ palette.cursor }}"
+
+theme[used_start]="{{ palette.info }}"
+theme[used_mid]="{{ palette.special }}"
+theme[used_end]="{{ palette.cursor }}"
+
+# Download graph colors
+theme[download_start]="{{ palette.info }}"
+theme[download_mid]="{{ palette.special }}"
+theme[download_end]="{{ palette.cursor }}"
+
+# Upload graph colors
+theme[upload_start]="{{ palette.info }}"
+theme[upload_mid]="{{ palette.special }}"
+theme[upload_end]="{{ palette.cursor }}"
+
+# Process path color
+theme[process_start]="{{ palette.info }}"
+theme[process_mid]="{{ palette.special }}"
+theme[process_end]="{{ palette.cursor }}"
diff --git a/templates/btop/meta.yaml b/templates/btop/meta.yaml
new file mode 100644
index 0000000..bc98ce9
--- /dev/null
+++ b/templates/btop/meta.yaml
@@ -0,0 +1,4 @@
+author: S0wlz (Owlibou)
+description: Btop resource monitor theme
+version: 1.0.0
+strategy: individual