terminal

Slatewave for LSD

A Slatewave palette for LSD — the next-gen ls, tinted slate and teal.

Latest release
0.0.2 · last month
Last commit
last month
~/Development/getslatewave⎇ mainlsd-la--git--tree--depth=2
.drwxr-xr-xkevin.langleyjrstaff512 BMon Apr 27 00:09:29 2026── .
.-rw-r--r--kevin.langleyjrstaff347 BMon Apr 27 00:09:29 2026├── .env.example
.drwxr-xr-xkevin.langleyjrstaff384 BMon Apr 27 00:09:29 2026├── .git
!-rw-r--r--kevin.langleyjrstaff316 BMon Apr 27 00:09:29 2026│ ├── config
!-rw-r--r--kevin.langleyjrstaff 73 BMon Apr 27 00:09:26 2026│ ├── description
!-rw-r--r--kevin.langleyjrstaff 21 BMon Apr 27 00:09:26 2026│ ├── HEAD
!drwxr-xr-xkevin.langleyjrstaff512 BMon Apr 27 00:09:29 2026│ ├── hooks
!-rw-r--r--kevin.langleyjrstaff8.8 KBMon Apr 27 00:09:29 2026│ ├── index
!drwxr-xr-xkevin.langleyjrstaff 96 BMon Apr 27 00:09:26 2026│ ├── info
!drwxr-xr-xkevin.langleyjrstaff128 BMon Apr 27 00:09:29 2026│ ├── logs
!drwxr-xr-xkevin.langleyjrstaff128 BMon Apr 27 00:09:26 2026│ ├── objects
!-rw-r--r--kevin.langleyjrstaff112 BMon Apr 27 00:09:29 2026│ ├── packed-refs
!drwxr-xr-xkevin.langleyjrstaff160 BMon Apr 27 00:09:26 2026│ └── refs
.drwxr-xr-xkevin.langleyjrstaff 96 BMon Apr 27 00:09:29 2026├── .github
.drwxr-xr-xkevin.langleyjrstaff 96 BMon Apr 27 00:09:29 2026│ └── workflows
.-rw-r--r--kevin.langleyjrstaff264 BMon Apr 27 00:09:29 2026├── .gitignore
.drwxr-xr-xkevin.langleyjrstaff128 BMon Apr 27 00:09:29 2026├── .vscode
.-rw-r--r--kevin.langleyjrstaff 87 BMon Apr 27 00:09:29 2026│ ├── {}extensions.json
.-rw-r--r--kevin.langleyjrstaff207 BMon Apr 27 00:09:29 2026│ └── {}launch.json
.-rw-r--r--kevin.langleyjrstaff626 BMon Apr 27 00:09:29 2026├── JSastro.config.mjs
.drwxr-xr-xkevin.langleyjrstaff 96 BMon Apr 27 00:09:29 2026├── docs
.drwxr-xr-xkevin.langleyjrstaff 96 BMon Apr 27 00:09:29 2026│ └── roadmap
.-rw-r--r--kevin.langleyjrstaff479 BMon Apr 27 00:09:29 2026├── LICENSE
.-rw-r--r--kevin.langleyjrstaff871 BMon Apr 27 00:09:29 2026├── {}package.json
!-rw-r--r--kevin.langleyjrstaff139 KBMon Apr 27 00:09:29 2026├── YMLpnpm-lock.yaml
.drwxr-xr-xkevin.langleyjrstaff256 BMon Apr 27 00:09:29 2026├── public
.-rw-r--r--kevin.langleyjrstaff 16 KBMon Apr 27 00:09:29 2026│ ├── apple-touch-icon.png
.drwxr-xr-xkevin.langleyjrstaff192 BMon Apr 27 00:09:29 2026│ ├── brand
.-rw-r--r--kevin.langleyjrstaff2.4 KBMon Apr 27 00:09:29 2026│ ├── favicon-32.png
.-rw-r--r--kevin.langleyjrstaff 24 KBMon Apr 27 00:09:29 2026│ ├── favicon.png
.-rw-r--r--kevin.langleyjrstaff 20 KBMon Apr 27 00:09:29 2026│ ├── icon-192.png
.-rw-r--r--kevin.langleyjrstaff552 BMon Apr 27 00:09:29 2026│ └── site.webmanifest
.-rw-r--r--kevin.langleyjrstaff2.7 KBMon Apr 27 00:09:29 2026├── README.md
.drwxr-xr-xkevin.langleyjrstaff288 BMon Apr 27 00:09:29 2026├── src
.drwxr-xr-xkevin.langleyjrstaff224 BMon Apr 27 00:09:29 2026│ ├── components
.drwxr-xr-xkevin.langleyjrstaff128 BMon Apr 27 00:09:29 2026│ ├── content
.-rw-r--r--kevin.langleyjrstaff2.7 KBMon Apr 27 00:09:29 2026│ ├── TScontent.config.ts
.drwxr-xr-xkevin.langleyjrstaff128 BMon Apr 27 00:09:29 2026│ ├── layouts
.drwxr-xr-xkevin.langleyjrstaff288 BMon Apr 27 00:09:29 2026│ ├── lib
.drwxr-xr-xkevin.langleyjrstaff320 BMon Apr 27 00:09:29 2026│ ├── pages
.drwxr-xr-xkevin.langleyjrstaff192 BMon Apr 27 00:09:29 2026│ └── styles
.-rw-r--r--kevin.langleyjrstaff201 BMon Apr 27 00:09:29 2026└── {}tsconfig.json
~/Development/getslatewave⎇ main

About this theme

LSD splits its output into column roles — owner, permissions, size, date, git status, tree edges — and Slatewave recolors each so the row reads at a glance. Teal for read, amber for write, rose for exec; teal for fresh dates, slate for old; tree edges recede and filenames lead.

Slatewave for LSD recolors the column roles LSD already exposes — owner, group, permissions, size, date, git status, tree edges — so the row reads spatially: teal for read, amber for write, rose for exec; teal-300 for hour-old dates fading to slate-400 for older ones; slate for small files warming to amber for large.

File-type colors (directories, symlinks, archives, media) are driven by LS_COLORS, so Slatewave composes with whatever LS_COLORS generator you already use — vivid, trapd00r/LS_COLORS, or the default. The theme tunes against LSD 1.0+, which accepts #rrggbb hex alongside the legacy named colors and ANSI 256 indices.

Pair with a Nerd Font

Optional — set icons.theme to fancy in ~/.config/lsd/config.yaml for the icon glyphs. Falls back to unicode cleanly when no Nerd Font is installed.

Pair with LS_COLORS

Slatewave handles the column roles; LS_COLORS handles file-type colors. A common combination:

export LS_COLORS="$(vivid generate molokai)"

Install

Don't have the CLI yet? Install the Slatewave CLI →

  • Slatewave CLI

    Install with the Slatewave family CLI — one command, every theme.

                          slatewave install lsd
                        
  • curl

    Drop colors.yaml into ~/.config/lsd/ without cloning. Requires LSD ≥ 1.0 (hex color support in colors.yaml).

                          mkdir -p ~/.config/lsd && curl -fsSL https://raw.githubusercontent.com/kevinlangleyjr/lsd-slatewave/main/colors.yaml -o ~/.config/lsd/colors.yaml
                        
  • Clone

    Clone the repo and symlink colors.yaml into LSD's config directory.

    1. git clone https://github.com/kevinlangleyjr/lsd-slatewave.git ~/.config/lsd-slatewave
    2. mkdir -p ~/.config/lsd
    3. ln -sf ~/.config/lsd-slatewave/colors.yaml ~/.config/lsd/colors.yaml
  • Activate

    LSD only consults colors.yaml when told to use a custom theme — edit ~/.config/lsd/config.yaml.

    1. Open or create ~/.config/lsd/config.yaml
    2. Add: color.when set to auto
    3. Add: color.theme set to custom
    4. Run lsd -la --git --tree --depth 2 to verify