LCARS ZSH Theme

A Star Trek: The Next Generation LCARS-inspired theme for Oh My Zsh with modern powerline-style segments and authentic color palette.

Features

• 🚀 OS-specific icon - Automatically displays for macOS, for Linux, or for Windows
• 📁 Directory display with bright orange LCARS color
• 🔀 Git integration - Shows branch name, dirty/clean status, and detailed change indicators:
  • + Added/staged files
  • * Modified files
  • - Deleted files
  • ? Untracked files
  • → Renamed files
  • ‡ Conflicts/unmerged files
• 🔋 Battery status (when plugin enabled) - Visual icon that changes based on charge level
• 🕐 Clock display - Shows current time in HH:MM:SS format
• 🚨 Red Alert Mode - All segments turn red when a command fails
• 🎨 Authentic LCARS color palette - Using the official colors from Star Trek: TNG

Requirements

• Oh My Zsh
• A Nerd Font
• Zsh shell

Installation

Method 1: Manual Installation

1. Clone or download this repository:

   git clone https://github.com/lgulliver/lcars-zsh-theme.git

2. Copy the theme file to your Oh My Zsh custom themes directory:

   cp lcars-zsh-theme/lcars.zsh-theme ~/.oh-my-zsh/custom/themes/

3. Set the theme in your ~/.zshrc:

   ZSH_THEME="lcars"

4. Reload your shell:

   source ~/.zshrc

Method 2: Symlink (for development)

ln -s /path/to/lcars-zsh-theme/lcars.zsh-theme ~/.oh-my-zsh/custom/themes/lcars.zsh-theme

Optional: Enable Battery Display

To show battery status, add the battery plugin to your ~/.zshrc:

plugins=(... battery)

Color Palette

The theme uses authentic LCARS colors from Star Trek: The Next Generation:

• Orange (#FF9966) - Primary segment color for directory
• Blue (#9999CC) - Git status segment
• Pink (#CC99CC) - Battery display
• Purple (#CC99FF) - Time display
• Peach/Salmon (#FFCC99) - Status indicators
• Red Alert (#FF6666) - Error state

Customization

You can customize the theme by editing ~/.oh-my-zsh/custom/themes/lcars.zsh-theme. The color definitions are at the top of the file:

# Color definitions (LCARS palette - authentic colors)
LCARS_ORANGE="%F{208}"
LCARS_PINK="%F{213}"
LCARS_BLUE="%F{111}"
LCARS_PURPLE="%F{183}"
# ...

Troubleshooting

Icons not showing

• Ensure you have a Nerd Font installed and set in your terminal
• Terminal.app on macOS: Preferences → Profiles → Font → Select a Nerd Font
• iTerm2: Preferences → Profiles → Text → Font → Select a Nerd Font

Colors look different

• Make sure your terminal supports 256 colors
• Check your terminal color scheme isn't overriding the theme colors

License

MIT License - See LICENSE file for details

Credits

Inspired by the LCARS (Library Computer Access/Retrieval System) interface from Star Trek: The Next Generation.

---

Live long and prosper! 🖖