---

A collection of 16 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.

🌅 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.

• Check out the new light theme screenshots.

🚨 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 Desert Night	Moonlight Moonlit Night	Midnight Dark Desert	Abyss Black Desert
Starlight Black Lagoon	Desert Grey	Sol Red	Scorpion Scorched
Canyon Orange	Dune Yellow	Cactus Green	Mirage Teal
Lagoon (Default) Blue	Luna Indigo	Twilight Sunset	Rose Pink

☀️ Light Styles

Light Previews

The examples below use the light style 3.

Night	Moonlight	Midnight	Abyss
Starlight	Desert	Sol	Scorpion
Canyon	Dune	Cactus	Mirage
Lagoon	Luna	Twilight	Rose

✨ Features

• Advanced status line with dynamic mode indicators based on vim for each of tmux's modes.
  • Includes: NORMAL, COMMAND, COPY, VIEW, CHOOSE, CLOCK, OPTIONS, and ZOOM modes.
  • Customizable mode formats: Set @oasis_mode_format to short (single letter), full (complete word), icon (Nerd Font icons), or custom (user-defined labels)
• 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 module configurations (download only what you need)
• Standalone with zero dependencies on any other plugins

📦 Installation

For customization options, please see all configuration options.

Method 1: Tmux Plugin Manager (TPM) - Recommended

Add to your tmux.conf:

set -g @plugin 'uhs-robert/tmux-oasis'
set -g @oasis_flavor "lagoon_dark"  # Optional: defaults to lagoon_dark

Install with TPM: prefix + I

Method 2: Manual Installation

Clone this repository:

git clone https://github.com/uhs-robert/tmux-oasis ~/.tmux/themes/oasis

In your tmux.conf, set your preferred theme style:

set -g @oasis_flavor "lagoon_dark"

Source the main configuration:

source-file "~/.tmux/themes/oasis/oasis_tmux.conf"

Reload tmux: tmux source ~/.tmux.conf

⚙️ Configuration

Oasis offers many different styles to choose from. First, pick a theme!

• Dual-mode themes: abyss, cactus, canyon, desert, dune, lagoon, luna, mirage, midnight, night, rose, scorpion, 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"   # For light variant 3
set -g @oasis_flavor "night"            # Resolves to night_dark

Then set up any additional configuration options for more customization!

🍦 Configuration Options & Defaults

All options below show their default values. Add any of these to your tmux.conf to override:

``$\text{tmux}

\text{Theme} \text{variant} (16 \text{base} \text{styles} \times 6 \text{variants} \text{each})

\text{Options}: [\text{style}]\text{_dark}, [\text{style}]\text{_light_1}, [\text{style}]\text{_light_2}, [\text{style}]\text{_light_3}, [\text{style}]\text{_light_4}, [\text{style}]\text{_light_5}

\text{Styles}: "\text{night}", "\text{moonlight}", "\text{midnight}", "\text{abyss}", "\text{starlight}", "\text{desert}", "\text{sol}", "\text{canyon}", "\text{dune}", "\text{cactus}", "\text{mirage}", "\text{lagoon}", "\text{luna}", "\text{twilight}", "\text{rose}"

\text{set} -\text{g} @\text{oasis_flavor} "\text{lagoon_dark}"

\text{Mode} \text{indicator} \text{display} \text{format}

\text{Options}: "\text{short}" (\text{N}, \text{C}, \text{V}), "\text{full}" (\text{NORMAL}, \text{COPY}, \text{VIEW}), "\text{icon}" (\text{Nerd} \text{Font} \text{icons}), "\text{custom}" (\text{see} \text{below})

\text{set} -\text{g} @\text{oasis_mode_format} "\text{full}"

\text{Custom} \text{mode} \text{labels} (\text{only} \text{used} \text{when} @\text{oasis_mode_format} \text{is} "\text{custom}")

\text{set} -\text{g} @\text{oasis_mode_custom_normal} "\text{NORMAL}" \text{set} -\text{g} @\text{oasis_mode_custom_command} "\text{COMMAND}" \text{set} -\text{g} @\text{oasis_mode_custom_copy} "\text{COPY}" \text{set} -\text{g} @\text{oasis_mode_custom_view} "\text{VIEW}" \text{set} -\text{g} @\text{oasis_mode_custom_choose} "\text{CHOOSE}" \text{set} -\text{g} @\text{oasis_mode_custom_options} "\text{OPTIONS}" \text{set} -\text{g} @\text{oasis_mode_custom_clock} "\text{CLOCK}" \text{set} -\text{g} @\text{oasis_mode_custom_zoom} "\text{ZOOM}"

\text{Clock} \text{module} \text{settings}

\text{set} -\text{g} @\text{oasis_clock_24h} "\text{on}" # "\text{on}" \text{for} 24-\text{hour} \text{format}, "\text{off}" \text{for} 12-\text{hour} \text{AM}/\text{PM} \text{set} -\text{g} @\text{oasis_clock_icon} "󰥔 " # \text{Icon}/\text{text} \text{shown} \text{before} \text{time}

\text{Folder}/\text{directory} \text{module} \text{settings}

\text{set} -\text{g} @\text{oasis_folder_icon} " " # \text{Icon}/\text{text} \text{shown} \text{before} \text{directory} \text{path}

\text{Session} \text{module} \text{settings}

\text{set} -\text{g} @\text{oasis_session_icon} "󰍹 " # \text{Icon}/\text{text} \text{shown} \text{before} \text{session} \text{name} $``

⚙️ (Devs) Creating New Theme Styles

1. Dark variant: Create themes/dark/oasis_<name>_dark.conf
2. Light variants: Create themes/light/[1-5]/oasis_<name>_light_[1-5].conf (5 brightness levels)
3. Define all the @thm_* color variables in each variant file
4. Set @oasis_flavor to your new variant to test it

👀 View All Theme Styles

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

All styles (click to collapse)

🌕️ Dark Previews

Night (Dark · Desert Night)

↑ Back to Dark Styles

Moonlight (Dark · Moonlit Night)

↑ Back to Dark Styles

Midnight (Dark · Off Black)

↑ Back to Dark Styles

Abyss (Dark · Black)

↑ Back to Dark Styles

Starlight (Dark · Black Vivid)

↑ Back to Dark Styles

Desert (Dark · Grey)

↑ Back to Dark Styles

Sol (Dark · Red)

↑ Back to Dark Styles

Scorpion (Dark · Scorched)

↑ Back to Dark Styles

Canyon (Dark · Orange)

↑ Back to Dark Styles

Dune (Dark · Yellow)

↑ Back to Dark Styles

Cactus (Dark · Green)

↑ Back to Dark Styles

Mirage (Dark · Teal)

↑ Back to Dark Styles

Lagoon (Dark · Default)

↑ Back to Dark Styles

Luna (Dark · Indigo)

↑ Back to dark Styles

Twilight (Dark · Sunset)

↑ Back to Dark Styles

Rose (Dark · Pink)

↑ Back to Dark Styles

🌞 Light Previews

Night (Light)

↑ Back to Light Styles

Moonlight (Light)

↑ Back to Light Styles

Midnight (Light)

↑ Back to Light Styles

Abyss (Light)

↑ Back to Light Styles

Starlight (Light)

↑ Back to Light Styles

Desert (Light)

↑ Back to Light Styles

Sol (Light)

↑ Back to Light Styles

Scorpion (Light · Scorched)

↑ Back to light Styles

Canyon (Light)

↑ Back to Light Styles

Dune (Light)

↑ Back to Light Styles

Cactus (Light)

↑ Back to Light Styles

Mirage (Light)

↑ Back to Light Styles

Lagoon (Light)

↑ Back to Light Styles

Luna (Light)

↑ Back to Light Styles

Twilight (Light)

↑ Back to Light Styles

Rose (Light)

↑ Back to Light Styles