colson-tmux
v1.0.9
Published
Colson Tmux: Tmux + ZSH for Software Engineers!
Downloads
481
Maintainers
Readme
Tmux Configuration with Zsh Goodness (colson-tmux npm)
Unlock the full potential of your terminal with this meticulously crafted tmux configuration, accompanied by a versatile Zsh script for effortlessly launching websites and applications. 🔥
Installation through NPM
Ensure Tmux is installed on your machine!Tmux leader key
: <ctrl>+<space>
$ npx colson-tmux
$ cd ~/.config/tmux
$ nvim .
Navigate to tmux.conf
Execute this command in normal mode!
<leader>+shit+i
Restart terminal to load Tmux!
$ zshrl
$ tmuxrl
If you've already installed this before then for the latest pull, do:
$ npx colson-tmux@latest
NOTE
: Read the documentation below for indepth wisdom on proper installation and uses!
Table of Contents
Features
- Enhanced Tmux Configuration: Elevate your terminal experience with a comprehensive tmux setup tailored for efficiency.
- Web and App Launcher: Seamlessly launch websites and applications through an intuitive Zsh script.
- Plugin Management with TPM: Utilizes Tmux Plugin Manager (TPM) for hassle-free tmux plugin management.
- Catppuccin Theme: Elevate aesthetics with the visually pleasing Catppuccin theme.
Screenshots
✨ New Look (Colson TMUX)
💎 Old Look (Colson TMUX)
Prerequisites
Before diving in, ensure you have the following prerequisites:
- tmux: Ensure tmux is installed on your system.
- fzf: Install the fuzzy finder tool for interactive selection.
Getting Started
Installation
Begin by installing TPM (Tmux Plugin Manager):
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
Clone this repository into your home directory:
git clone https://github.com/colson0x1/colson-tmux ~/.config/tmux
Reload your tmux environment to apply the configuration:
tmux source-file ~/.config/tmux/tmux.conf
Make the
goto.sh
script executable:chmod +x ~/.config/tmux/goto.sh
Add
.zshrc
to root on your machine:cat ~/.config/tmux/.zshrc >> ~/.zshrc
Restart your Terminal.
$ source ~/.zshrc $ zshrl $ tmuxrl
You're all set! Launch websites and applications using
goto.sh
.<leader>+o
NOTE: Leader in tmux is:
Ctrl+Space
Install Tmux Plugins
- Open tmux:
tmux
- Navigate to the tmux directory:
cd ~/.config/tmux
- Use Neovim to open the configuration:
nvim .
- Go to
tmux.conf
:
(Note: Leader key isleader+shift+i
Ctrl+Space
, so useCtrl+Space
andShift+i
)
Usage
- Press
ctrl+space
to activate the leader key. - Switch between windows with
M-K
andM-J
. - Split the terminal horizontally (
leader + -
) and vertically (leader + |
). - Launch websites and apps with
leader + o
. - Customize website and app choices in
goto.sh
.
Key Bindings
Master these key bindings for efficient tmux navigation:
- Leader Key:
ctrl+space
- Window Switching:
Shift+Alt+j
andShift+Alt+k
- Horizontal Split:
leader + -
- Vertical Split:
leader + |
- Launch Websites and Apps:
leader + o
Customization
Tailor your tmux configuration and the list of websites and applications in goto.sh
to match your preferences. Dive into the endless possibilities of customization and make your terminal truly yours. Additionally, explore the power of Zsh with a rich set of aliases and Git shortcuts in the included .zshrc
file.
Peace!