{"repo":"junegunn/heytmux","free":true,"listed":false,"github":"https://github.com/junegunn/heytmux","clone":"git clone https://github.com/junegunn/heytmux.git","description":"Tmux scripting made easy","language":"Ruby","stars":148,"topics":["tmux"],"license":"MIT","category":"cli-tools","readme_excerpt":"Hey tmux! ========= Tmux scripting made easy. Installation ------------ Heytmux requires Ruby 2.0+ and tmux 2.3+. As Ruby gem - Installs heytmux executable As Vim plugin Using vim-plug: - Registers :Heytmux command - No need to install Gem if you only use Heytmux inside Vim - But if you want it to be globally available, Plug 'junegunn/heytmux', { 'do': 'gem install heytmux' } Usage ----- Create a YAML file that describes a desired tmux workspace. Then run heytmux workspace.yml . Instead of creating a new session from scratch, Heytmux looks at the current session and only creates windows and panes that are not found. So you can repeatedly run the same input file only to issue commands on the existing panes. Heytmux identifies windows and panes by their names and titles, so renaming them can confuse Heytmux. Duplicate names are okay as long as you don't reorder windows or panes of the same names. More examples can be found here. Heytmux can read STDIN, so cat workspace.yml heytmux is also [valid][caat]. It may seem pointless, but it allows you to do :w !heytmux with a visual selection in Vim. [caat]: http://porkmail.org/era/unix/award.html Step-by-step tutorial --------------------- List of window names In the simplest case, input file only has to contain the names of windows as the top-level list. Create workspace.yml and add the following lines. heytmux workspace.yml will create 3 windows with the given names. If you re-run the same command, you'll notice Heytmux doesn't crea","default_branch":null,"files":null,"tree":[],"storefront":"/r/junegunn","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/junegunn/heytmux/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}