bspcq, q for query
bspc
analyzer (utility for bspwm)
A 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
Usage
# 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!