RanXom/rx-tmux
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Custom lightweight tmux configuration.
28 commits 4 branches 0 tags 49 KiB
  • Shell 100%
Find a file
Exact
Saiyed Shizain 2b25cac6bc
 Merge pull request #4 from RanXom/feat/qol 
Feat/qol: add pane-aware splits and api window icon
2026-09-23 16:30:12 +05:30
conf feat(keybinds): add keybind for vertical and horizon split 2026-09-18 17:57:39 +05:30
scripts fix(theme): ensure transparency is preserved on hot reload 2026-09-01 16:45:47 +05:30
themes feat(icon): add window icon for api 2026-09-18 17:58:38 +05:30
.gitignore feat(plugins): add tpm, resurrect, continuum and prefixless 2026-09-01 23:34:04 +05:30
README.md chore(documentation): create professional README.md 2026-09-01 23:55:38 +05:30
tmux.conf feat(plugins): add tpm, resurrect, continuum and prefixless 2026-09-01 23:34:04 +05:30

README.md

rx-tmux

A clean, modular, and professional Tmux configuration designed specifically to complement the rx-neovim ecosystem.

This configuration emphasizes maintainability by splitting settings into logically separated modules, integrates automated session management, and provides a polished, dynamic status line.

Dependencies

This configuration relies on external color palettes generated dynamically.

  • Noctalia v5: Used as the primary theme generator for the status line and window elements.
    • Note: The scripts parse Noctalia's generated configuration file (themes/noctalia.conf). If you prefer, you can easily modify the extraction scripts to use Matugen or simply hardcode your own hex values directly into themes/status.tmux.

Plugins

This configuration uses the Tmux Plugin Manager (TPM) to handle plugins. The following plugins are pre-configured:

  • TPM (Tmux Plugin Manager)
    • Manages the installation and loading of all other plugins.
  • tmux-resurrect
    • Saves the complete state of your Tmux environment (sessions, windows, panes) so it survives system restarts.
  • tmux-continuum
    • Provides continuous background saving of your Tmux environment (using tmux-resurrect) and automatically restores your last saved session when Tmux starts.
  • tmux-prefixless
    • Streamlines navigation by mapping common Tmux operations directly to Alt key combinations, entirely bypassing the need for a prefix key.

Keymaps

Thanks to tmux-prefixless, navigating your Tmux environment is fast and intuitive.

By holding Alt (or Option), you can use the following bindings without pressing your prefix key:

  • Alt + h / j / k / l - Navigate between panes
  • Alt + H / L - Navigate between windows
  • Alt + J / K - Navigate between sessions
  • Alt + i - Disable prefixless bindings (useful when you need these bindings in terminal applications like Neovim)
  • Alt + o - Re-enable prefixless bindings

You can view the full list of prefixless bindings at any time by running:

tmux list-keys -T prefixless

Structure

The configuration is modularly split:

  • tmux.conf: The main entrypoint that sources all other configurations.
  • conf/general.conf: Core Tmux settings, terminal overrides, and mouse behavior.
  • conf/theme.conf: Sourcing logic for themes and status line styling.
  • conf/plugins.conf: Plugin declarations and TPM initialization.
  • themes/status.tmux: The shell script responsible for constructing the transparent status line and applying color variables.

Installation

  1. Clone this repository into your Tmux configuration directory:
git clone https://github.com/RanXom/rx-tmux.git ~/.config/tmux
  1. Start Tmux.
  2. Install plugins by pressing <Prefix> + I (or install manually if tpm was not cloned automatically).