A `bspc` analyzer & a utility for bspwm
Project description
bspcq, q for query
A bspc
analyzer (utility for bspwm)
This is a small program that prints a user friendly, visual representation, of
your current bsp
tree.
The aim is to assist in using bspwm
so new users have an easier time getting
into tiling window managers, and have some toys to play with.
It's essentially the same as running:
bspc query -M -m <monitor-name> | jq
Except there are fewer parameters, a less complex syntax to remember and an intuitive visual.
Installation
python -m pipx install bspcq
```#
# Upgrade
```sh
python -m pipx upgrade bspcq
```#
## Usage
```sh
# Prints the full tree, including output from all monitors.
bspcq
# Provides a simpler view, perfect for finding window class names.
bspcq -s
# Grabs info on all nodes that belong to the specified domain.
bspcq -M/D/N
# Passes through a query to `bspc query` and prints our tree.
bspcq -m/d/n <monitor/desktop/node-identifier>
Preview
Plans
My goals currently are to:
- Align
bspcq
as closely as possible withbspc query
. I would like forbspcq
to behave almost identically tobspc query
- it just adds a visual element. - Remain as lean as possible. A nice-to-have feature would be 0 reliance on
external libraries, so I'd like to remove
rich
and implement a way to display thetree
myself.
This was just an afternoon project that's turning into a week long project since it's quite a lot of fun!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
bspcq-0.1.52.tar.gz
(6.3 kB
view hashes)
Built Distribution
bspcq-0.1.52-py3-none-any.whl
(6.7 kB
view hashes)