Skip to content

Latest commit

 

History

History
133 lines (100 loc) · 2.93 KB

README.md

File metadata and controls

133 lines (100 loc) · 2.93 KB

TMux Ex Machina

A Star Wars-inspired tmux configuration with intelligent pane management and status handling.

Status Bar Preview

Features

  • 🎨 Star Wars-inspired color scheme with deep space background and dataterm accents
  • 🖥️ Dynamic pane title management
  • 📊 Intelligent status bar with system metrics
  • 🔄 Vim integration for context-aware pane titles
  • 🚀 ZSH plugins for enhanced status management
  • ⌨️ Vim-style keybindings for navigation
  • 🖱️ Mouse mode support for easy navigation

Components

Theme

  • Star Wars dataterm-inspired color palette
  • Powerline-style status indicators
  • System resource monitoring
  • Session and window management

Pane Title Manager

  • Automatic updates based on current activity
  • Integration with Vim/Neovim
  • Git branch information display
  • Command context awareness

Status Plugin

  • Custom status message support
  • Integration with Powerlevel10k
  • Persistent status across commands
  • Automatic cleanup on exit

Installation

Quick Install

git clone https://github.com/yourusername/tmux-ex-machina.git
cd tmux-ex-machina
./install.sh

Manual Installation

  1. Clone the repository:
git clone https://github.com/yourusername/tmux-ex-machina.git
cd tmux-ex-machina
  1. Install the theme:
mkdir -p ~/.tmux/themes
cp themes/exmachina.tmux.conf ~/.tmux/themes/
cp config/.tmux.conf ~/.tmux.conf
  1. Install the ZSH plugins:
mkdir -p ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/tmux-ex-machina
cp -r plugins/* ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/tmux-ex-machina/
  1. Add the plugin to your .zshrc:
plugins=(... tmux-ex-machina)
  1. Install the Vim plugin:
# For Vim
mkdir -p ~/.vim/plugin
cp plugins/pane-title/vim-pane-title.vim ~/.vim/plugin/

# For Neovim
mkdir -p ~/.config/nvim/plugin
cp plugins/pane-title/vim-pane-title.vim ~/.config/nvim/plugin/

Configuration

Theme Customization

The Ex Machina theme can be customized by modifying the color variables in ~/.tmux/themes/exmachina.tmux.conf:

# Deep Space Background: #0A1428
# Bright Interface Blue: #7CB7FF
# Dataterm Cyan: #00F1FF
# Mid-space Blue: #1C2F45
# Light Interface Blue: #5CC2F2

Status Plugin

The status plugin can be used to set custom status messages:

# Set a status message
status "Debugging authentication service"

# Clear the status
clear_status

Vim Integration

Customize the Vim pane title format in your .vimrc:

let g:vim_pane_title_format = 'vim: %f%m [%Y]%r'

Requirements

  • tmux >= 3.0
  • Zsh
  • Oh My Zsh (recommended)
  • Vim >= 8.0 or Neovim >= 0.5.0
  • (Optional) Powerlevel10k for enhanced status integration
  • (Optional) vim-fugitive for git integration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Credits

Color scheme inspired by Star Wars dataterminal aesthetics and modern terminal themes.