This file ( 3kB ) exceeds the allowed full mode (48 kb) size.
The editor full hight is disabled, only scrolling is allowed..
If you wish to edit a file, it is recommended to use the scroll mode as some users do not like the full height
mode, although some users like it.
Create side and top bars in tmux easily, along with a "devour" style command.
![TDAB logo](https://github.com/uriel1998/tdab/raw/master/tdab-open-graph.png "logo")
![TDAB demo](https://raw.githubusercontent.com/uriel1998/tdab/master/tdab_example.gif "demo")
You can see a larger version of the demo with the [included MKV file](https://github.com/uriel1998/tdab/blob/master/tdab_example.mkv?raw=true).
## 1. About
These three scripts (called `TDAB` for short) will create side or top bars
(or a "devour" style new pane) that run a command inside tmux. See the image
above to get an idea of what this means.
The name is a play on "A *blank* walks into a bar", because puns.
## 2. License
This project is licensed under the MIT License. For the full license, see `LICENSE`.
## 3. Prerequisites
These scripts will *probably* work in other shells, but I don't know for sure.
## 4. Installation
Clone or download the repository. Put the scripts (or symlinks to the scripts)
in your `$PATH`. (In the example above, I've symlinked them to `sidebar`,
`topbar`, and `devour`.)
If you wish to change the width or height of the sidebar/topbar, you will
need to edit this line:
`tmux resize-pane -t "$c_pane" -R 30`
which actually resizes the *larger* pane from the center line. My screen that
I used for the demo is 194 columns wide, so when it's first split, it's 97/96
columns wide, then resizes it *to the right* an additional 30 columns so that
I end up with a 127/67 split. The same thing goes for the topbar, except it
resizes upward (-U). Adjust so that they work for your terminal size.
### Tip for `Devour`
I find a binding like the following *very* useful when using `devour`:
`bind-key -n C-/ select-pane -R \;\`
This will allow you to cycle among the zoomed panes - and will zoom each as you
go through it. Very nice for programs like [emojin](https://github.com/peterjschroeder/emojin).
## 5. Usage
`SCRIPTNAME [program to run]`
For example, `tmux-sidebar.sh man man` will show you the man page for man in
If you run the scripts outside of tmux, it will just run the command.
Launch a process in a new pane, zoom the pane, kill the pane when done.
Create a sidebar (e.g. for reading manpages) and kill when done.
Create a vertical split and kill when done.
## 6. TODO
* Have a configurable size modifier so nobody needs to edit the script.