Package Exports
- colson-tmux
- colson-tmux/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (colson-tmux) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
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+iRestart terminal to load Tmux!
$ zshrl
$ tmuxrlIf you've already installed this before then for the latest pull, do:
$ npx colson-tmux@latestNOTE: 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/tpmClone this repository into your home directory:
git clone https://github.com/colson0x1/colson-tmux ~/.config/tmuxReload your tmux environment to apply the configuration:
tmux source-file ~/.config/tmux/tmux.conf
Make the
goto.shscript executable:chmod +x ~/.config/tmux/goto.shAdd
.zshrcto root on your machine:cat ~/.config/tmux/.zshrc >> ~/.zshrc
Restart your Terminal.
$ source ~/.zshrc $ zshrl $ tmuxrlYou're all set! Launch websites and applications using
goto.sh.<leader>+oNOTE: 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+SpaceandShift+i)
Usage
- Press
ctrl+spaceto activate the leader key. - Switch between windows with
M-KandM-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+jandShift+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!