sensorario / ttmux

A script that make easy tmux configuration bootstrap of a project

ttmux

A script that make easy tmux configuration bootstrap of a project

Install ttmux

To make ttmux executable from everywhere, add a symbolic link your /usr/local/bin folder

# cd /usr/local/bin
# ln -s ~/path/to/sensorario/ttmux/ttmux .

tmux configuration

Add these lines to your tmux.conf file, ore create it if not exists.

# start windows and panes at 1, not 0
set -g base-index 1
set -g pane-base-index 1

configuration

This example create a basic configurtion where, ...

• github checkout master branch
• session is named "ttmux"
• workspace windows will have a 20% pane, on the bottom

declare -A window_list=()
declare -A horizontal_panes=()
declare -A horizontal_panes_command=()
declare -A horizontal_panes_command_position=()

session_name="ttmux"
project_path='/path/to/project/folder'

window_list+=([workspace]="cd $project_path; vim")
window_list+=([mysql]="mysql -uroot sensorario")
window_list+=([console]="cd $project_path")

horizontal_panes+=([workspace]="")
horizontal_panes_command+=([workspace]="")
horizontal_panes_command_position+=([workspace]=2)

ordered_windows=(
    workspace
    mysql
    console
)

Tmux snippets

• open horizontal pane Ctrl-b + "
• open vertical pane Ctrl-b + %

ttmux's Issues

Suggest available branches, or create new one

Does not work on MacOsX

Due to a bash scripting version, ttmux does not work inside MacOsX terminal. This shell does not support associative arrays like:

declare -A window_list=()

And all generated windows in ordered_windows list, are created like the first one.

Create ttmux configuration from current session

• write a question on stackoverflow
• do something

Create default configuration for symfony projects

Create base configuration file

$ ttmux init

this command could create a base configuration file for current project. Depending on the kind of project, we could create a configuration file that tail php log if the project is a php project.

• create a configuration file for php project
• define a workspace file with all repositories and path related (eventually) to this project

Split pane horizontally

• define a way to create horizontal panes

Auto-load unique configuration file

When there is only one configuration file ...

cannot find ttmux:1

Seems that the first tmux windows has to be windows 0, suggest to change from start=1 to start=0 in line 94

Rename project and extensions to ttmux

Is a nice name than startmux and is shorter. Finally, is easier to write ttmux XD

Introduce workspaces

Should be available an unique window_list source file (a sort of worspace) and different ttmux order combination

• define all window list
• define all repositories
• add check to li/utils function for configuration consistency

Dont check working directory

Add a parameter to skip checks of working directories

--no-commit

First command, is not executed O_o

Log actions

Log all actions done for debug purpose

multiple configurations/behaviors

ordered_windows is the list of windows that will be opened. Instead of change them each time, ... just create some preset and select them asking to users which one to use in this session. Use select command of bash scripts

Old readme file

Manage branches

It should be possibile to work in different respositories during the same time. Even if a repository wont be loaded, it should be placed in the desired branch name.

TODO:

• create a branch if not exists
• check current branch in all related repositories
• open all panes and windows with the same branch
• fetch and pull master

Create command to update branch without edit .ttmux file

each configuration should have its own repositories to update

a configuration, have its own repositories and window list

declare: -A: invalid option

Does not work on MacOsX?

Session name configurable

• documentation

Insetad of define a list of command, customize preset of functions

• just go to a path
• run a generic command
• listen php log

In case of remote working, any local repository is needed

ttmux should update all repositories ONLY if next session is of development. In case of mantaining session or hotfix or something like that (no development needed) any repository should be updated

Define layouts for windows

• workspace layout for main development

Configuration file consistency

A configuration file must contain all of this definitions:

• window_list
• vertical_panes
• pane_command
• pane_command_position
• order

display an appropriate message when a variable is missing

Missing suggested tmux configuration

According to #34 issue, add suggested tmux configuration inside README file

# Start windows and panes at 1, not 0
set -g base-index 1
set -g pane-base-index 1

Installer

Define a branch that should be opened inside a window/pane

• open all panes and windows with the same branch
• check in workspace if there are some dirty working directory

tmux: command not found

./startmux: line 26: tmux: command not found
./startmux: line 32: tmux: command not found
./startmux: line 36: tmux: command not found
./startmux: line 34: tmux: command not found
./startmux: line 36: tmux: command not found
./startmux: line 39: tmux: command not found
./startmux: line 40: tmux: command not found

Delete already merged branches

ls: cannot access *.startmux: No such file or directory

chain of panes createed even if session already exists

When ttmux starts add pane to a session but does not check if this already exists. This cause a strange behavior: panes are opened again and again ...

Json/TOML/Ini configuration file

To me would make more sense if the config.startmux configuration file was only a configuration file and not an actual piece of bash code used to create an array.

I googled about "ini to bash array" and found this Unix StackExchange question http://unix.stackexchange.com/questions/149702/how-do-i-add-an-associative-array-to-a-variable-from-an-external-ini-file

Any thoughts?