Add support for nerdfont symbols for file types and folders

Author: dividebysandwich

README.md

@@ -108,8 +108,9 @@ The installed executable is named **`rc`** for quick typing.
   diagram** (Tab) groups connections into colour-coded cards showing each peer IP
   and its direction, with clickable/navigable addresses and reverse-DNS lookups.
 - **Look & feel** — many color themes (fully customizable via `themes.toml`),
-  truecolor animated gradients, an optional CPU/memory status widget, and a
-  configurable **F2 user menu**.
+  truecolor animated gradients, an optional CPU/memory status widget, optional
+  **Nerd Font file-type icons** in the listings, and a configurable
+  **F2 user menu**.
 - **Terminal graphics** — on terminals with a **Kitty**, **Sixel** or **iTerm2**
   graphics protocol, the progress bars, process-explorer graphs, transfer speed
   graph and the disk-explorer **treemap** (a nested "pillow" map of each folder's

doc/MANUAL.md

@@ -408,6 +408,18 @@ just color: `/` directory, `*` executable, `@` symlink, `!` broken symlink, and
 a leading space for plain files (keeps names aligned). File **names are colored**
 by type as well: archives, documents, images and audio/video each get a hue.
 
+**Nerd Font symbols.** Turning on *Options → Settings → Nerd Font symbols*
+replaces those markers with a per-type icon — a folder, a chain link (broken for
+a dangling one), and a glyph picked from the file itself: its language for source
+files (Rust, Python, Go, …), the category for documents, images, audio, video,
+archives, fonts, keys, databases and binaries, and a few whole names that carry
+no extension (`Makefile`, `Dockerfile`, `LICENSE`, `.gitignore`, `Cargo.toml`, …).
+Anything unrecognized gets a blank page, or a gear if it is executable. The glyph
+is followed by a space, so names line up exactly as they do without it. This
+needs a [Nerd Font](https://www.nerdfonts.com/) selected in your terminal —
+preferably a **Mono** variant, whose icons are one cell wide — which is why it is
+off by default; without one the listing shows replacement boxes.
+
 
 ## File operations
 
@@ -1411,7 +1423,7 @@ Configuration files live in your platform config directory
 (`~/.config/rat-commander/` on Linux):
 
 - **`config.toml`** — written by the Settings dialog. Holds the active theme and
-  language, the truecolor / animation / status-widget toggles, the external
+  language, the truecolor / animation / status-widget / `nerd_font` toggles, the external
   editor and viewer commands, the confirmation flags, the remembered remote
   servers (without passwords), and your directory **`bookmarks`** (used by the
   command palette, Ctrl-P). It also holds `command_history_max` (default
@@ -1437,7 +1449,9 @@ Configuration files live in your platform config directory
 
 Choose the **theme** and **language**, toggle **truecolor**, **animations**, the
 **system-status widget**, the **command prompt** (the shell line below the
-panels — also `Ctrl-F5`; see *Working without the command prompt*) and **Reshape
+panels — also `Ctrl-F5`; see *Working without the command prompt*), **Nerd Font
+symbols** (per-file-type icons in the listing — see *Panels*; needs a Nerd Font
+in your terminal) and **Reshape
 RTL text** (see *Language*), pick the
 **Graphics** mode (see *Terminal graphics* below), set an **external editor /
 viewer** command (used instead of the built-in ones), and choose whether to use
@@ -1451,7 +1465,9 @@ The **Theme**, **Language** and **Graphics** fields are dropdowns: press
 through it, **Enter** to pick, **Esc** to close. They **preview live** as you
 move the highlight — the UI re-colors / re-translates / re-draws immediately — so
 **Enter** keeps the highlighted one and **Esc** (closing the dialog) reverts to
-what you started with. In every dialog the **OK** and **Cancel** buttons are part
+what you started with. The **Nerd Font symbols** box previews live in the same
+way: the listings behind the dialog switch markers as you tick it, and go back on
+**Esc**. In every dialog the **OK** and **Cancel** buttons are part
 of the keyboard focus ring: **Tab** / **↑↓** move onto them and **Enter** or
 **Space** activates the highlighted one (**Enter** still submits from a field and
 **Esc** always cancels).

src/app/state/dialogs.rs

@@ -249,6 +249,7 @@ impl AppState {
                 self.config.animation = v.animation;
                 self.config.system_status = v.system_status;
                 self.set_command_prompt(v.command_prompt);
+                self.config.nerd_font = v.nerd_font;
                 self.config.brief_columns = v.brief_columns;
                 self.truecolor = v.truecolor;
                 // Apply the chosen language (store English as the default => None).

src/app/state/lifecycle.rs

@@ -264,6 +264,19 @@ impl AppState {
         p.cwd.clone()
     }
 
+    /// Whether the panels draw Nerd Font type glyphs instead of the `ls -F`
+    /// classify characters. While the Settings dialog is open this follows its
+    /// live checkbox, so the listings behind it update as the box is ticked and
+    /// snap back when the dialog is cancelled (nothing is stored until submit).
+    pub(crate) fn nerd_font_active(&self) -> bool {
+        match &self.dialog {
+            Some(Dialog::Form(fd)) => {
+                fd.check_value("Nerd Font symbols").unwrap_or(self.config.nerd_font)
+            }
+            _ => self.config.nerd_font,
+        }
+    }
+
     /// Whether the active UI theme has a dark background (picks a fitting syntax
     /// highlighting theme).
     pub(in crate::app::state) fn dark_ui(&self) -> bool {

src/app/state/tests.rs

@@ -1839,6 +1839,37 @@ async fn theme_preview_applies_and_reverts_on_cancel() {
     assert_eq!(st.theme.name, original, "cancel should revert to the original theme");
 }
 
+#[tokio::test]
+async fn nerd_font_symbols_preview_live_and_persist_on_ok() {
+    let (tx, _rx) = async_bridge::channel();
+    let mut st = AppState::new(tx);
+    st.config.nerd_font = false;
+    st.open_settings();
+    let key = |c| KeyEvent::new(c, KeyModifiers::NONE);
+    // "Nerd Font symbols" is the sixth field of the Visual group (index 11);
+    // Tab down to it and toggle it with Space.
+    for _ in 0..11 {
+        st.handle_key(key(KeyCode::Tab)).await;
+    }
+    st.handle_key(key(KeyCode::Char(' '))).await;
+    assert!(st.nerd_font_active(), "the listing previews the glyphs while the box is ticked");
+    assert!(!st.config.nerd_font, "nothing is stored until the form is submitted");
+
+    // Esc closes the dialog without applying it…
+    st.handle_key(key(KeyCode::Esc)).await;
+    assert!(!st.nerd_font_active(), "cancel reverts to the plain `ls -F` markers");
+
+    // …and submitting saves it.
+    st.open_settings();
+    for _ in 0..11 {
+        st.handle_key(key(KeyCode::Tab)).await;
+    }
+    st.handle_key(key(KeyCode::Char(' '))).await;
+    st.handle_key(key(KeyCode::Enter)).await;
+    assert!(st.config.nerd_font, "OK stores the setting");
+    assert!(st.nerd_font_active(), "and the listing keeps drawing the glyphs");
+}
+
 #[tokio::test]
 async fn f1_opens_help_in_viewer() {
     let (tx, _rx) = async_bridge::channel();

src/config/mod.rs

@@ -110,6 +110,11 @@ pub struct Config {
     /// and typing a printable character starts a quick search instead of
     /// entering text. (Missing from an old config → the struct default, `true`.)
     pub command_prompt: bool,
+    /// Draw a Nerd Font glyph per file type in the listing instead of the plain
+    /// `ls -F` classify characters (`/`, `*`, `@`, `!`). Needs a Nerd Font
+    /// installed in the terminal, so it is off unless asked for. (Missing from an
+    /// old config → the struct default, `false`.)
+    pub nerd_font: bool,
     /// Number of columns in the Brief (multi-column names) view.
     /// (Missing from an old config → the struct default, `2`.)
     pub brief_columns: usize,
@@ -174,6 +179,7 @@ impl Default for Config {
             animation: false,
             system_status: true,
             command_prompt: true,
+            nerd_font: false,
             brief_columns: 2,
             command_history_max: 100,
             panels: [PanelView::default(); 2],

src/l10n/ar.toml

@@ -97,6 +97,7 @@ rtl = true
 "Animations" = "الرسوم المتحركة"
 "System status widget" = "أداة حالة النظام"
 "Command prompt" = "سطر الأوامر"
+"Nerd Font symbols" = "رموز Nerd Font"
 "External editor" = "محرر خارجي"
 "External viewer" = "عارض خارجي"
 "Use internal viewer" = "استخدام العارض الداخلي"

src/l10n/cs.toml

@@ -93,6 +93,7 @@ code = "cs"
 "Animations" = "Animace"
 "System status widget" = "Widget stavu systému"
 "Command prompt" = "Příkazový řádek"
+"Nerd Font symbols" = "Symboly Nerd Font"
 "External editor" = "Externí editor"
 "External viewer" = "Externí prohlížeč"
 "Use internal viewer" = "Použít interní prohlížeč"

src/l10n/de.toml

@@ -138,6 +138,7 @@ code = "de"
 "Animations" = "Animationen"
 "System status widget" = "System-Statusanzeige"
 "Command prompt" = "Befehlszeile"
+"Nerd Font symbols" = "Nerd-Font-Symbole"
 "External editor" = "Externer Editor"
 "External viewer" = "Externer Betrachter"
 "Use internal viewer" = "Internen Betrachter verwenden"

src/l10n/en.toml

@@ -102,6 +102,7 @@ code = "en"
 "Animations" = "Animations"
 "System status widget" = "System status widget"
 "Command prompt" = "Command prompt"
+"Nerd Font symbols" = "Nerd Font symbols"
 "External editor" = "External editor"
 "External viewer" = "External viewer"
 "Use internal viewer" = "Use internal viewer"