Metadata-Version: 2.1
Name: riverwm-utils
Version: 0.0.4
Summary: Utilities for the River Wayland compositor
Home-page: https://github.com/NickHastings/riverwm-utils
Author: Nick Hastings
Author-email: nicholaschastings@gmail.com
License: GPLv3
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: pywayland (>=0.4.7)

# riverwm-utils
Utilities for the River Wayland compositor. Currently just one utility is included.

## Install

### Development version
Clone the repository:
```
git clone https://github.com/NickHastings/riverwm-utils.git
```
Install locally with pip
```
python3 -m pip install ./riverwm-utils
```
### Stable realeases
```
python3 -m pip install riverwm-utils
```

## Usage

# cycle-focused-tags

Change to either the next or previous focused tags.

Note that this functionality could easily be [built into
river](https://github.com/riverwm/river/pull/506), but because of the
plan to separate the window management to a separate client, such new
addictions are not being accepted.

The script takes two arguments: the first is being the direction
next|previous, the second being the maximum number of tags at which
the cycling should wrap back to the first tag (or to the last tag from
the first tag).

If the second argument is omitted the maximum number of tags is
assumed to be 32.  If both arguments are ommited the direction,
next, will be used.

The script can be called using spawn in the users init file. For example:
```
riverctl map normal Mod4 Up spawn "cycle-focused-tags previous 9"
riverctl map normal Mod4 Down spawn "cycle-focused-tags next 9"
```


