apragacz / tmuxp-combine

A tool for combining tmuxp configs

tmuxp-combine

A tool for combining tmuxp configs.

Why?

tmux is a great tool. In some cases, you would like to start it with preconfigured windows instead of creating them manually each time. tmuxp is a great tool for doing that.

I found out that in some cases I wanted to load only a subset of particular windows, so I wrote simple tool which combines the configs and calls tmuxp with combined config.

Sample config

~/.tmuxp-combine/mysession/base.yml:

session_name: mysession
start_directory: ~/projects/myproject

~/.tmuxp-combine/mysession/windows/docker.yml:

window_name: docker
layout: main-vertical
panes:
- shell_command:
  - cd .
  focus: true
- shell_command:
  - docker-compose up

~/.tmuxp-combine/mysession/windows/nodejs.yml:

window_name: nodejs
layout: main-vertical
panes:
- shell_command:
  - cd .
  focus: true
- shell_command:
  - npm run serve

Running the mysession in tmux only with nodejs window:

tmuxp-combine load mysession -w nodejs

Running the mysession in tmux only with nodejs and docker windows:

tmuxp-combine load mysession -w nodejs -w docker

Running the mysession in tmux with all windows:

tmuxp-combine load mysession