https://github.com/uhs-robert/tmux-oasis
🌵 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.
https://github.com/uhs-robert/tmux-oasis
colors colorscheme oasis-theme tmux tmux-conf tmux-plugin tmux-theme
Last synced: 4 months ago
JSON representation
🌵 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.
- Host: GitHub
- URL: https://github.com/uhs-robert/tmux-oasis
- Owner: uhs-robert
- License: mit
- Created: 2025-09-26T18:02:11.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-12-29T14:10:43.000Z (5 months ago)
- Last Synced: 2026-01-01T16:57:46.038Z (5 months ago)
- Topics: colors, colorscheme, oasis-theme, tmux, tmux-conf, tmux-plugin, tmux-theme
- Language: Shell
- Homepage:
- Size: 4.74 MB
- Stars: 18
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tmux - tmux-oasis
README
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 thenightstyle family.
## 🌙 Dark Styles
Click any card below to view the full preview and syntax sample. [↓ Or click here to view all full previews](#view-all-theme-styles)
### 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](#config-options).
### Method 1: Tmux Plugin Manager (TPM) - Recommended
1. Add to your `tmux.conf`:
```tmux
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:
```bash
git clone https://github.com/uhs-robert/tmux-oasis ~/.tmux/themes/oasis
```
2. In your `tmux.conf`, set your preferred theme style:
```tmux
set -g @oasis_flavor "lagoon_dark"
```
3. Source the main configuration:
```tmux
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:
```tmux
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:
```tmux
# 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__dark.conf`
2. Light variants: Create `themes/light/[1-5]/oasis__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](https://github.com/uhs-robert/oasis.nvim)
> [!IMPORTANT]
> The status line at the top is the TMUX plugin integration.
All styles (click to collapse)
### Dark previews
**Midnight (Dark · Off Black)**
**Starlight (Dark · Black Vivid)**
### Light previews
