Metadata-Version: 2.4
Name: i3-skip
Version: 0.1.0
Summary: i3 focus motion that treats tabbed/stacked containers as one window
License-Expression: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: i3ipc>=2.2

# i3-skip
i3 focus motion that treats a tabbed or stacked container as a single window rather than navigating between tabs.

AI-generated and unreviewed.

## Motivation
I want two separate forms of motions. One for within tabbed ontainers, the other between visible windows. 
I guess this is because I don't want to futz with my choices for stacked windows while i move around.
Also, it does kind of make sense to move between what is visible.

This program is a companian to i3-glue which glues together certain windows into tabbed containers.

## Usage

```sh
i3-skip left      # focus the window/group to the left, skipping any tabs inside
i3-skip right
i3-skip up
i3-skip down
i3-skip toggle    # cycle focus within the current tabbed/stacked group
```

Bind your motion keys to the directional forms and one key to `toggle`, e.g. in
your i3 config:

```
bindsym $mod+h exec i3-skip left
bindsym $mod+l exec i3-skip right
bindsym $mod+k exec i3-skip up
bindsym $mod+j exec i3-skip down
bindsym $mod+Tab exec i3-skip toggle
```

## Flags

- `--debug` — print the i3 commands sent

## Install (editable, via pipx)

```sh
pipx install i3-skip
```
