Update lsd/vivid Theme
Update the Warm Graphite theme for lsd and vivid.
References
Getting Documentation
Clone repos for reference when needed:
git clone --depth 1 https://github.com/lsd-rs/lsd.git /tmp/lsd-repo
git clone --depth 1 https://github.com/sharkdp/vivid.git /tmp/vivid-repo
Key reference files:
/tmp/lsd-repo/doc/samples/colors-sample.yaml - lsd color config example/tmp/lsd-repo/doc/colors.md - lsd color documentation/tmp/vivid-repo/themes/ - vivid theme examples
File Locations
Master files (edit these):
lsd/colors.yaml - UI metadata colors (user, group, permissions, dates, git status)lsd/config.yaml - lsd layout and behavior settingsvivid/themes/warm-graphite.yml - file type colors via LS_COLORS
Installed locations:
~/.config/lsd/colors.yaml~/.config/lsd/config.yaml~/.config/vivid/themes/warm-graphite.yml
Color Palette (ANSI 256)
| Code |
Name |
Hex |
Used For |
| 140 |
mauve |
#af87d7 |
user, symlinks, renamed (lavender) |
| 243 |
gray |
#767676 |
group, unmodified |
| 245 |
light gray |
#8a8a8a |
permissions, older dates |
| 240 |
dark gray |
#585858 |
no-access, ignored, tree-edge |
| 223 |
peach |
#ffd7af |
hour-old dates, highlights |
| 174 |
rose |
#d78787 |
day-old dates, media (salmon) |
| 186 |
tan |
#d7d787 |
large files, markup (chartreuse) |
| 107 |
sage |
#87af5f |
executables, git new, source code (lime) |
| 178 |
gold |
#d7af00 |
git modified, config, archives (cleaner) |
| 173 |
coral |
#d7875f |
errors, deleted, conflicts (terracotta) |
| 73 |
teal |
#5fafaf |
directories, links, tooling (richer) |
Workflow
- Edit the master files in this repo
- Install:
just install
- Reload:
source ~/.zshrc
- Test:
just test
- Commit changes to git if satisfied
Testing Colors
To verify ANSI codes are being applied correctly (since terminal output may strip colors):
lsd -la --color=always | head -3 | cat -v
This shows raw ANSI escape codes like ^[[38;5;251m (color 251) so you can verify the config is loaded.
Color Formats
- lsd colors.yaml: ANSI 256 codes (numbers) or named colors
- vivid warm-graphite.yml: Hex colors without # prefix (e.g., "d7af5f")
Common Tasks
Change a specific color
- Find the element in the appropriate file
- Update the color code/hex value
- Run
just install && source ~/.zshrc && just test
Add a new accent color to vivid
- Add to
colors: section in warm-graphite.yml
- Reference it in the appropriate category (core, text, programming, etc.)
1---2name: update-theme3description: Update the Warm Graphite color theme for lsd and vivid terminal tools. Use when modifying colors, refreshing the palette, or adjusting file type styling.4---5
6# Update lsd/vivid Theme
7
8Update the Warm Graphite theme for lsd and vivid.
9
10## References
11
12- **lsd**: https://github.com/lsd-rs/lsd
13- **vivid**: https://github.com/sharkdp/vivid
14- **vivid themes**: https://github.com/sharkdp/vivid/tree/master/themes
15
16## Getting Documentation
17
18Clone repos for reference when needed:
19
20```bash
21git clone --depth 1 https://github.com/lsd-rs/lsd.git /tmp/lsd-repo
22git clone --depth 1 https://github.com/sharkdp/vivid.git /tmp/vivid-repo
23```
24
25Key reference files:
26- `/tmp/lsd-repo/doc/samples/colors-sample.yaml` - lsd color config example
27- `/tmp/lsd-repo/doc/colors.md` - lsd color documentation
28- `/tmp/vivid-repo/themes/` - vivid theme examples
29
30## File Locations
31
32**Master files (edit these):**
33- `lsd/colors.yaml` - UI metadata colors (user, group, permissions, dates, git status)
34- `lsd/config.yaml` - lsd layout and behavior settings
35- `vivid/themes/warm-graphite.yml` - file type colors via LS_COLORS
36
37**Installed locations:**
38- `~/.config/lsd/colors.yaml`
39- `~/.config/lsd/config.yaml`
40- `~/.config/vivid/themes/warm-graphite.yml`
41
42## Color Palette (ANSI 256)
43
44| Code | Name | Hex | Used For |
45|------|------|-----|----------|
46| 140 | mauve | `#af87d7` | user, symlinks, renamed (lavender) |
47| 243 | gray | `#767676` | group, unmodified |
48| 245 | light gray | `#8a8a8a` | permissions, older dates |
49| 240 | dark gray | `#585858` | no-access, ignored, tree-edge |
50| 223 | peach | `#ffd7af` | hour-old dates, highlights |
51| 174 | rose | `#d78787` | day-old dates, media (salmon) |
52| 186 | tan | `#d7d787` | large files, markup (chartreuse) |
53| 107 | sage | `#87af5f` | executables, git new, source code (lime) |
54| 178 | gold | `#d7af00` | git modified, config, archives (cleaner) |
55| 173 | coral | `#d7875f` | errors, deleted, conflicts (terracotta) |
56| 73 | teal | `#5fafaf` | directories, links, tooling (richer) |
57
58## Workflow
59
601. **Edit** the master files in this repo
612. **Install**: `just install`
623. **Reload**: `source ~/.zshrc`
634. **Test**: `just test`
645. **Commit** changes to git if satisfied
65
66## Testing Colors
67
68To verify ANSI codes are being applied correctly (since terminal output may strip colors):
69
70```bash
71lsd -la --color=always | head -3 | cat -v
72```
73
74This shows raw ANSI escape codes like `^[[38;5;251m` (color 251) so you can verify the config is loaded.
75
76## Color Formats
77
78- **lsd colors.yaml**: ANSI 256 codes (numbers) or named colors
79- **vivid warm-graphite.yml**: Hex colors without # prefix (e.g., "d7af5f")
80
81## Common Tasks
82
83### Change a specific color
841. Find the element in the appropriate file
852. Update the color code/hex value
863. Run `just install && source ~/.zshrc && just test`
87
88### Add a new accent color to vivid
891. Add to `colors:` section in warm-graphite.yml
902. Reference it in the appropriate category (core, text, programming, etc.)
majiayu000