---

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

Command Mode

Copy Mode

View Mode

Choose Mode

Zoom Mode

Options Mode

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

• 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 Night Sky	Midnight Off Black	Abyss Black	Starlight Black Vivid
Desert Grey	Sol Red	Canyon Orange	Dune Yellow
Cactus Green	Mirage Teal	Lagoon (Default) Blue	Twilight Purple
Rose Pink

☀️ Light Styles

Light Previews

The examples below use the light style 3.

Night · Light	Midnight · Light	Abyss · Light	Starlight · Light
Desert · Light	Sol · Light	Canyon · Light	Dune · Light
Cactus · Light	Mirage · Light	Lagoon · Light	Twilight · 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, 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

1. Add to your tmux.conf:

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

2. Install with TPM: prefix + I

Method 2: Manual Installation

1. Clone this repository:

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

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

set -g @oasis_flavor "lagoon_dark"

3. Source the main configuration:

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

4. 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, 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"   # 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:

# Theme variant (13 base styles × 6 variants each = 78 total themes)
# Options: [style]_dark, [style]_light_1, [style]_light_2, [style]_light_3, [style]_light_4, [style]_light_5
# Styles: abyss, cactus, canyon, desert, dune, lagoon, mirage, midnight, night, rose, sol, starlight, twilight
set -g @oasis_flavor "lagoon_dark"

# Mode indicator display format
# Options: "short" (N, C, V), "full" (NORMAL, COPY, VIEW), "icon" (Nerd Font icons), "custom" (see below)
set -g @oasis_mode_format "full"

# Custom mode labels (only used when @oasis_mode_format is "custom")
set -g @oasis_mode_custom_normal "NORMAL"
set -g @oasis_mode_custom_command "COMMAND"
set -g @oasis_mode_custom_copy "COPY"
set -g @oasis_mode_custom_view "VIEW"
set -g @oasis_mode_custom_choose "CHOOSE"
set -g @oasis_mode_custom_options "OPTIONS"
set -g @oasis_mode_custom_clock "CLOCK"
set -g @oasis_mode_custom_zoom "ZOOM"

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

# Folder/directory module settings
set -g @oasis_folder_icon " "    # Icon/text shown before directory path

# Session module settings
set -g @oasis_session_icon "󰍹 "  # Icon/text shown before session 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

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)

↑ 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

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

Twilight (Dark · Purple)

↑ Back to Dark Styles

Rose (Dark · Pink)

↑ Back to Dark Styles

Light previews

Night (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

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

Twilight (Light)

↑ Back to Light Styles

Rose (Light)

↑ Back to Light Styles