Skip to content

🌡 Desert theme with vim inspired status line and 13 styles; warm and readable. Let there be light in the desert and dark in the oasis.

License

Notifications You must be signed in to change notification settings

uhs-robert/tmux-oasis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

62 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

logo


A collection of 13 desert-inspired Tmux colorscheme status lines; with dual light/dark modes.

🎨 Status Bar with Dynamic Modes

Wouldn't it be nice to know what mode you're in? And not just one mode, but for ALL modes like in Vim.

Oasis provides a fully styled status line with a robust dynamic mode indicator for ALL of tmux's modes and 13 unique color schemes.

Normal Mode
Normal Mode

Command Mode
Command Mode

Copy Mode
Copy Mode

View Mode
View Mode

Choose Mode
Choose Mode

Clock Mode
Clock Mode

Options Mode
Options Mode

Note

Previews above all use the lagoon_dark style.

πŸŒ… Overview

Choose from 13 distinct desert-inspired base styles, each with its own personality and color palette. Dual-mode themes now ship with one dark plus five fine-grained light variants.

✨ What's New / 🚨 Breaking Changes
🚨 v2.0: Dual Style Themes / Deprecated Themes

✨ Dual Style Themes

Each style now has 5 light theme variants.

🚨 BREAKING CHANGE: Deprecated Light Theme Migration

The following standalone light themes have been deprecated in favor of the dual-mode system:
Dawn Replaced with night_light_1
Dawnlight Replaced with night_light_2
Day Replaced with night_light_3
Dusk Replaced with night_light_4
Dust Replaced with night_light_5
Note: The migration table above shows direct replacements. All deprecated themes were based on the night style family.

πŸŒ™ Dark Styles

Click any card below to view the full preview and syntax sample. ↓ Or click here to view all full previews

Dark Previews

Night
Night
Night Sky
Midnight
Midnight
Off Black
Abyss
Abyss
Black
Starlight
Starlight
Black Vivid
Desert
Desert
Grey
Sol
Sol
Red
Canyon
Canyon
Orange
Dune
Dune
Yellow
Cactus
Cactus
Green
Mirage
Mirage
Teal
Lagoon
Lagoon (Default)
Blue
Twilight
Twilight
Purple
Rose
Rose
Pink

β˜€οΈ Light Styles

Light Previews

The examples below use the light style 3.

Night (light)
Night Β· Light
Midnight (light)
Midnight Β· Light
Abyss (light)
Abyss Β· Light
Starlight (light)
Starlight Β· Light
Desert (light)
Desert Β· Light
Sol (light)
Sol Β· Light
Canyon (light)
Canyon Β· Light
Dune (light)
Dune Β· Light
Cactus (light)
Cactus Β· Light
Mirage (light)
Mirage Β· Light
Lagoon (light)
Lagoon Β· Light
Twilight (light)
Twilight Β· Light
Rose (light)
Rose Β· Light

✨ Features

  • Advanced status line with dynamic mode indicators based on vim for each of tmux's modes.
    • Includes: NORMAL, COMMAND, COPY, VIEW, CHOOSE, CLOCK, and OPTIONS modes.
  • 13 base styles with granular variants: dual-mode themes provide 1 dark + 5 light levels
  • Automatic theme loading, set @oasis_flavor and the system will handle the rest (suffixes added for you)
  • Modular design with separate theme and status line configurations (download only what you need)
  • Standalone with zero dependencies on any other plugins

πŸ“¦ Installation

Method 1: Tmux Plugin Manager (TPM) - Recommended

  1. Add to your tmux.conf:
set -g @plugin 'uhs-robert/oasis'
set -g @oasis_flavor "lagoon_dark"  # Optional: defaults to lagoon_dark
  1. Install with TPM: prefix + I

Method 2: Manual Installation

  1. Clone this repository:
git clone https://github.com/uhs-robert/oasis ~/.tmux/themes/oasis
  1. In your tmux.conf, set your preferred theme style:
set -g @oasis_flavor "lagoon_dark"
  1. Source the main configuration:
source-file "~/.tmux/themes/oasis/oasis_tmux.conf"
  1. Reload tmux: tmux source ~/.tmux.conf

πŸš€ Status Line Features

The status line is inspired from lualine in Neovim. It includes:

  • Dynamic mode indicators: Visual indicators for prefix mode, copy mode, command mode, tree mode etc.
  • Session information: Current session name with icons
  • Current directory: Abbreviated path display
  • Real-time clock: Hours, minutes, seconds with AM/PM
  • Color-coded states: Different colors for all of the different tmux modes

🎯 Picking a Theme Variant

  • Dual-mode themes: abyss, cactus, canyon, desert, dune, lagoon, mirage, midnight, night, rose, sol, starlight, twilight
    • Variants: _dark and _light_1 … _light_5
    • Short names auto-expand to dark: setting set -g @oasis_flavor "lagoon" loads lagoon_dark

Examples:

set -g @oasis_flavor "canyon_light_3"
set -g @oasis_flavor "night"          # resolves to night_dark

βš™οΈ (Devs) Creating New Theme Styles

  1. Add a new directory: themes/<name>/
  2. Place variants as themes/<name>/oasis_<name>_<variant>.conf (e.g., _dark, _light_1 … _light_5)
  3. Define all the @thm_* color variables in each variant file
  4. Set @oasis_flavor to your new variant to test it

Tip

Dual-mode themes should ship with one _dark and five _light_[1-5] files for consistent UX.

πŸ‘€ View All Theme Styles

All screenshots below show how the theme looks with the companion theme in neovim

Important

The status line at the top is the TMUX plugin integration.

All styles (click to collapse)

Dark previews

Night (Dark Β· Night Sky)

night-dark-dashboard

↑ Back to Dark Styles

Midnight (Dark Β· Off Black)

midnight-dark-dashboard

↑ Back to Dark Styles

Abyss (Dark Β· Black)

abyss-dark-dashboard

↑ Back to Dark Styles

Starlight (Dark Β· Black Vivid)

starlight-dark-dashboard

↑ Back to Dark Styles

Desert (Dark Β· Grey)

desert-dark-dashboard

↑ Back to Dark Styles

Sol (Dark Β· Red)

sol-dark-dashboard

↑ Back to Dark Styles

Canyon (Dark Β· Orange)

canyon-dark-dashboard

↑ Back to Dark Styles

Dune (Dark Β· Yellow)

dune-dark-dashboard

↑ Back to Dark Styles

Cactus (Dark Β· Green)

cactus-dark-dashboard

↑ Back to Dark Styles

Mirage (Dark Β· Teal)

mirage-dark-dashboard

↑ Back to Dark Styles

Lagoon (Dark Β· Default)

lagoon-dark-dashboard

↑ Back to Dark Styles

Twilight (Dark Β· Purple)

twilight-dark-dashboard

↑ Back to Dark Styles

Rose (Dark Β· Pink)

rose-dark-dashboard

↑ Back to Dark Styles

Light previews

Night (Light)

night-light-3-dashboard

↑ Back to Light Styles

Midnight (Light)

midnight-light-3-dashboard

↑ Back to Light Styles

Abyss (Light)

abyss-light-3-dashboard

↑ Back to Light Styles

Starlight (Light)

starlight-light-3-dashboard

↑ Back to Light Styles

Desert (Light)

desert-light-3-dashboard

↑ Back to Light Styles

Sol (Light)

sol-light-3-dashboard

↑ Back to Light Styles

Canyon (Light)

canyon-light-3-dashboard

↑ Back to Light Styles

Dune (Light)

dune-light-3-dashboard

↑ Back to Light Styles

Cactus (Light)

cactus-light-3-dashboard

↑ Back to Light Styles

Mirage (Light)

mirage-light-3-dashboard

↑ Back to Light Styles

Lagoon (Light)

lagoon-light-3-dashboard

↑ Back to Light Styles

Twilight (Light)

twilight-light-3-dashboard

↑ Back to Light Styles

Rose (Light)

rose-light-3-dashboard

↑ Back to Light Styles

About

🌡 Desert theme with vim inspired status line and 13 styles; warm and readable. Let there be light in the desert and dark in the oasis.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Languages