Tmux Oasis

A collection of 18 desert-inspired Tmux colorscheme status lines; warm, readable, and configurable.

🎨 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 18 unique color schemes.

Normal Mode

Command Mode

Copy Mode

View Mode

Choose Mode

Clock Mode

Options Mode

Note

Previews above all use the lagoon style.

🌅 Overview

Choose from 18 distinct desert-inspired styles, each with its own personality and color palette:

Night Purple 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	Dawn Beige	Dawnlight Golden Beige	Day Gold
Dusk Peach Gold	Dust Golden Sand

Tip

Click any card above to see the full preview example.

↓ Click here to view all full previews.

✨ 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.
• 18 theme styles, a rainbow of desert-inspired options
• Automatic theme loading, set @oasis_flavor and the system will handle the rest
• 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/tmux-oasis'
set -g @oasis_flavor "lagoon"  # Optional: defaults to lagoon

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/tmux-oasis

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

set -g @oasis_flavor "lagoon"

3. Source the main configuration:

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

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

⚙️ (Devs) Creating New Theme Styles

1. Create a new file in themes/oasis_[name].conf
2. Define all the @thm_* color variables
3. Use set -g @oasis_flavor "[name]" in your tmux.conf

Tip

Feel free to add your own styles by creating themes/oasis_[style].conf files

👀 View All Theme Styles

Important

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

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

All styles (click to collapse)

Night (Purple Night Sky)

Deep desert night sky with purple-indigo undertones, a deeper purple than twilight for those who prefer soft darkness

↑ Back to Overview

Midnight (Off Black)

Deep slate and navy tones of the desert at midnight, a tinted-black lighter than abyss

↑ Back to Overview

Abyss (Black)

Deep, dark style with mysterious depths

↑ Back to Overview

Starlight (Black Vivid)

Desert abyss illuminated by brilliant starlight with vivid accent colors

↑ Back to Overview

Desert (Grey)

Inspired by the classic vim desert theme, neutral sand and earth tones

↑ Back to Overview

Sol (Red)

Hot, scorching desert sun with intense red tones

↑ Back to Overview

Canyon (Orange)

Rich oranges of desert canyon walls

↑ Back to Overview

Dune (Yellow)

Sandy beiges and warm yellow earth tones

↑ Back to Overview

Cactus (Green)

Fresh greens of desert vegetation

↑ Back to Overview

Mirage (Teal)

Cool teals of shimmering desert mirages

↑ Back to Overview

Lagoon (Blue)

The original Oasis theme, cool blues of the oasis lagoon

↑ Back to Overview

Twilight (Purple)

Evening desert with purple and indigo hues

↑ Back to Overview

Rose (Pink)

Soft pinks of the warm desert rose

↑ Back to Overview

Dawn (Beige)

Ah, the morning sun. Don't forget your sunglasses! (Lightness = 91)

↑ Back to Overview

Dawnlight (Golden Beige)

Slightly warmer than dawn, a golden morning glow (Lightness = 88)

↑ Back to Overview

Day (Gold)

Full daylight warmth with rich golden saturation - the default light style (Lightness = 85)

↑ Back to Overview

Dusk (Peach Gold)

Warm sky at sunset, peachy-golden tones for extended coding sessions (Lightness = 77)

↑ Back to Overview

Dust (Golden Sand)

From dusk to dust, warmest golden-sand tones with earthy richness (Lightness = 70)

↑ Back to Overview