Add auto icon mode fallback and Nerd Font docs

This commit is contained in:
vrubelroman 2026-04-24 14:44:49 +03:00
parent ef47410bcf
commit 780150500d
6 changed files with 193 additions and 18 deletions

View file

@ -9,6 +9,20 @@
- Asynchronous copy/move with progress and background mode
- Theme support and configurable layout/columns
## Font requirement (icons)
For file icons, `vcom` expects a Nerd Font in your terminal profile.
Default behavior is `ui.icon_mode = "auto"`:
- if a Nerd Font is detected, `vcom` uses Nerd icons
- if not, `vcom` falls back to ASCII icons automatically
You can force behavior in config:
- `ui.icon_mode = "nerd"`: always use Nerd icons
- `ui.icon_mode = "ascii"`: always use ASCII icons
Preview mode (`F9` / `i`) temporarily replaces the inactive pane and shows:
- directory listing preview
@ -60,6 +74,17 @@ Download the release `.deb` for `v0.1.2`, then install:
sudo apt install ./vcom_0.1.2_amd64.deb
```
Install a Nerd Font (example):
```bash
wget -qO /tmp/JetBrainsMono.zip https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.zip
mkdir -p ~/.local/share/fonts/JetBrainsMonoNerd
unzip -o /tmp/JetBrainsMono.zip -d ~/.local/share/fonts/JetBrainsMonoNerd
fc-cache -fv
```
Then set your terminal font to a Nerd Font variant (for example, `JetBrainsMono Nerd Font`).
### Arch Linux
A `PKGBUILD` is included in the repository:
@ -80,6 +105,13 @@ Optional config lookup order:
Reference config: [vcom.toml](/home/vrubel/projects/vcom/vcom.toml)
Icon mode example:
```toml
[ui]
icon_mode = "auto" # auto | nerd | ascii
```
## Themes
Built-in themes: