Skip to content

Commit 68e9201

Browse files
committed
v2.0.3
1 parent fe0249a commit 68e9201

4 files changed

Lines changed: 15 additions & 15 deletions

File tree

README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Lightweight tmux command/layout composer · 1 shell script · 0 dependencies exc
1616

1717
**Contents** - [Usage](https://github.com/evnp/tmex#usage) | [Layout](https://github.com/evnp/tmex#layout) | [npm](https://github.com/evnp/tmex#npm) | [Install](https://github.com/evnp/tmex#install) | [Tests](https://github.com/evnp/tmex#tests) | [License](https://github.com/evnp/tmex#license)
1818

19-
**New in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2)** 🐣 <br> [Multi-window management](https://github.com/evnp/tmex#multi-window-management-new-in-v2-) | [Focused-pane control](https://github.com/evnp/tmex#focused-pane-control-new-in-v2-) | [Multi-digit pane counts](https://github.com/evnp/tmex#multi-digit-pane-counts-new-in-v2-) | [Top-level sizing](https://github.com/evnp/tmex#top-level-layout-sizing-new-in-v2-) | [Grid sub-layouts](https://github.com/evnp/tmex#grid-sub-layouts-new-in-v2-)
19+
**New in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3)** 🐣 <br> [Multi-window management](https://github.com/evnp/tmex#multi-window-management-new-in-v2-) | [Focused-pane control](https://github.com/evnp/tmex#focused-pane-control-new-in-v2-) | [Multi-digit pane counts](https://github.com/evnp/tmex#multi-digit-pane-counts-new-in-v2-) | [Top-level sizing](https://github.com/evnp/tmex#top-level-layout-sizing-new-in-v2-) | [Grid sub-layouts](https://github.com/evnp/tmex#grid-sub-layouts-new-in-v2-)
2020

2121
If you'd like to jump straight to installing tmex, please go to the [Install](https://github.com/evnp/tmex#install) section or try one of these:
2222
```sh
@@ -181,14 +181,14 @@ tmex your-session-name --layout={152}1[2{13}1]4{4112}
181181
```
182182
Note that the sublayout `[2{13}1]` is treated as a single column when sizing is applied, so that set of panes as a whole receives `5` as its width relative to the other columns.
183183

184-
Top-level layout sizing (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
184+
Top-level layout sizing (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
185185
----------------------------------------------------------------------------------------------------
186186
Since a sizing clause like `{123}` always _follows_ a pane count number within a layout, you may be wondering how sizing could be applied to the "top level" columns (or rows) of a layout. For example, given the layout `234`, how could you:
187187
- make the first column `2` fill half the screen
188188
- make the second column `3` fill a third of the screen
189189
- make the third column `4` fill the remainder (one sixth) of the screen
190190

191-
This special case is handled by placing the sizing clause at the _start_ of the layout (prior to [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2), this would result in an invalid layout error):
191+
This special case is handled by placing the sizing clause at the _start_ of the layout (prior to [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3), this would result in an invalid layout error):
192192
```sh
193193
tmex your-session-name --layout={321}234
194194
>>>
@@ -213,7 +213,7 @@ tmex your-session-name --layout=[[234]{321}] # also equivalent
213213
```
214214
These may be functionally equivalent, but they're a far cry from intuitive! Feel free to use whichever of the three forms makes the most logical sense to you though.
215215

216-
Grid sub-layouts (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
216+
Grid sub-layouts (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
217217
---------------------------------------------------------------------------------------------
218218

219219
Sometimes you might want a row/column of your layout to contain a grid of N panes, laid out using the default algorithm. This is done by placing `{+}` _after_ a number of panes in the layout. This can be thought of as "requesting a grid layout" for the preceeding number of panes – `+` is a visual mnemonic in that it separates the space within `{ }` in a grid-like formation.
@@ -240,7 +240,7 @@ tmex your-session-name --layout=31224
240240
```
241241
because `5{+}` is expanded to `122`, which is the default grid layout when 5 panes are required. You can experiment with commands such as `tmex your-session-name --layout=7{+}` to see what default grid layout is produced for each number of panes. In general, each default grid layout attempts to equalize pane sizes, widths, and heights as much as possible, keeping the largest pane on the left with odd numbers of panes.
242242

243-
Multi-digit pane counts (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
243+
Multi-digit pane counts (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
244244
----------------------------------------------------------------------------------------------------
245245
For any of the layouts above, pane counts 10 and greater can be achieved by separating digits with `.` characters. For example:
246246
```sh
@@ -264,7 +264,7 @@ tmex your-session-name --layout=11.[23]45[6.7]8.
264264
```
265265
`11.` is treated as multi-digit, and produces a column 11 panes. `23` are treated as a sublayout of single-digit pane counts, producing 5 panes total. `45` have no adjacent `.` characters so they produce columns of 4 and 5 panes. `6.7` are treated as multi-digit, but still produce separate rows (in their sublayout) of 6 and 7 panes respectively – the `.` has no effect. Finally, `8.` is treated as multi-digit due to the adjacent `.` but still produces a column of 8 panes – the `.` has no effect).
266266

267-
Focused Pane Control (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
267+
Focused Pane Control (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
268268
-------------------------------------------------------------------------------------------------
269269

270270
There are a few different ways to select a specific pane to be "focused" – with cursor active inside it – when your layout is initialized.
@@ -294,7 +294,7 @@ tmex your-session-name -f=-10 1357 # shorthand argument + shorthand
294294
# this happens to be equivalent to --layout=135---7 from above
295295
```
296296

297-
Multi-window management (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
297+
Multi-window management (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
298298
----------------------------------------------------------------------------------------------------
299299

300300
You may want to create multiple tmux windows within your tmux session, and navigate between them using **CTRL+B→N** (next), **CTRL+B→P** (previous), **CTRL+B→[0-9]** (select by index).
@@ -328,7 +328,7 @@ tmex your-session-name --window '' 123 --window '' 44 # equivalent
328328

329329
**NOTE** that you must _always_ specify a top-level session name when using multiple windows, even if `--npm` / `-n` is specified. This is because npm-mode will be applied on a per-window basis, not to the session as a whole -- necessary if you want to run commands in _some_ windows as NPM scripts, but not commands in _all_ windows.
330330

331-
Usage within tmux sessions (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
331+
Usage within tmux sessions (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
332332
---------------------------------------------------------------------------------------------
333333
You can use tmex within an existing tmux session to split panes or create additional windows, using the full suite of layout features. Usage within a tmux session will be automatically detected by tmex, and it will avoid spawning a nested tmux session. You may omit session name from the tmex command in these cases (otherwise it will be ignored):
334334
```sh
@@ -344,7 +344,7 @@ tmex "cmd a" "cmd b" "cmd c" # INCORRECT - "cmd a" treated as session name and
344344
tmex -- "cmd a" "cmd b" "cmd c" # CORRECT - "cmd a" treated as shell command
345345
```
346346

347-
Kill command (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.2) 🐣)
347+
Kill command (new in [v2](https://github.com/evnp/tmex/releases/tag/v2.0.3) 🐣)
348348
---------------------------------------------------------------------------------------------
349349

350350
You can kill a tmux session from anywhere using
@@ -407,11 +407,11 @@ read -rp $'\n'"Current \$MANPATH:"$'\n'"${MANPATH//:/ : }"$'\n\n'"Enter a direct
407407
Verify installation:
408408
```sh
409409
tmex -v
410-
==> tmex 2.0.2
410+
==> tmex 2.0.3
411411

412412
brew test tmex
413413
==> Testing tmex
414-
==> /opt/homebrew/Cellar/tmex/2.0.2/bin/tmex test --print 1234 hello world
414+
==> /opt/homebrew/Cellar/tmex/2.0.3/bin/tmex test --print 1234 hello world
415415
```
416416

417417
If you see the output `Warning: tmux is not yet installed, tmex will not work without tmux.` you'll need to install tmux as well.

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "tmex",
3-
"version": "2.0.2",
3+
"version": "2.0.3",
44
"description": "tmux-execute – a lightweight tmux command & layout composer",
55
"main": "tmex",
66
"files": [

tmex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#!/usr/bin/env bash
22

3-
# tmex 2.0.2
3+
# tmex 2.0.3
44

55
set -euo pipefail
66

0 commit comments

Comments
 (0)