0.0
No commit activity in last 3 years
No release in over 3 years
Generate tmux configurations for your projects
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 0
 Project Readme

Tmuxification

Generator for tmux configurations. The default template starts a tmux session with two windows in your project root, vim is started in the first window.

Tested on

  • Ruby 1.9
  • zsh & fish shells

Installation

$ gem install tmuxification

Usage

Create a new tmux project

$ cd ~/code/my_project
$ tmuxification create

You will need to reload your shell config file. The easiest way is to replace the current process with a new instance of your shell, e.g exec zsh.

Start the project (from any directory)

$ start_my_project

Note: The above will also autocomplete.

List all your projects

$ tmuxification list

Delete a project

$ cd ~/code/my_project
$ tmuxification destroy

Templates

You can create your own templates, just drop them in ~/.tmuxinator with a filename such as basic.tmux.erb and specify your template as such:

$ tmuxification create --template-name=basic

You can also edit the default.{zsh,fish}.tmux.erb templates which are used when no template-name is specified.

The default template is chosen based on the default shell.

Project name

By default the tmux project is named after the root directory of the project, you can specify a different project name as such:

$ cd ~/code/my_project
$ tmuxification create --project-name=foobar
$ start_foobar

Warning

Every project created will append a line per project to .projects, .zshrc or config.fish file. The .projects is used if it exists otherwise the rc file for the current shell is used.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request