https://github.com/aidenlangley/bspcq
A user friendly bspc analyzer.
https://github.com/aidenlangley/bspcq
bspwm cli linux
Last synced: about 1 year ago
JSON representation
A user friendly bspc analyzer.
- Host: GitHub
- URL: https://github.com/aidenlangley/bspcq
- Owner: aidenlangley
- License: mit
- Created: 2022-01-24T13:00:34.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-05-10T03:45:02.000Z (about 4 years ago)
- Last Synced: 2024-08-09T02:24:32.361Z (almost 2 years ago)
- Topics: bspwm, cli, linux
- Language: Python
- Homepage: https://pypi.org/project/bspcq/
- Size: 247 KB
- Stars: 11
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bspcq, q for query
## A `bspc` analyzer (utility for [bspwm](https://github.com/baskerville/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:
```sh
bspc query -M -m | jq
```
Except there are fewer parameters, a less complex syntax to remember and an
intuitive visual.
## Installation
I'd recommend just copying the script from the root of this directory, `bspcq`,
and changing the shebang.
```sh
git clone https://github.com/aidenlangley/bspcq
mv bspcq/bspcq ~/bin/bspcq # or ~/.local/bin/bspcq
chmod +x ~/bin/bspcq
```
Then edit the shebang - my shebang:
```sh
#! /usr/bin/env python3.10
```
Your shebang might need to be be:
```sh
#! /usr/bin/env python3
```
### Dependencies
In addition, some Python modules are required, as is `xtitle`.
#### [`rich`](https://pypi.org/project/rich/)
`rich` is responsible for the nicely formatted tree.
```
python -m pip install rich
```
#### [`xtitle`](https://github.com/baskerville/xtitle)
`xtitle` assists in getting the title name of a node/window in X.
Requires C/C++ development tools, varies by distro.
```
git clone https://github.com/baskerville/xtitle
cd xtitle
make && make install
```
I've actually included it here, under contrib, so you can just copy it to `~/bin`.
### Via `pipx`
https://pypi.org/project/bspcq/
```sh
python -m pipx install bspcq
```
## Upgrade
```sh
python -m pipx upgrade bspcq
```
## Usage
```sh
# Prints the full tree, including output from all monitors.
bspcq
```
```sh
# Provides a simpler view, perfect for finding window class names.
bspcq -s
```
```sh
# Grabs info on all nodes that belong to the specified domain.
bspcq -M/D/N
# For a simplified view.
bspcq -M/D/N -s
```
```sh
# Passes through a query to `bspc query` and prints our tree, valid identifiers
# are names, ID's or the address output by `bspc -M/D/N`.
bspcq -m/d/n
```
### Preview
### Plans
My goals currently are to:
- Align `bspcq` as closely as possible with `bspc query`. I would like for
`bspcq` to behave almost identically to `bspc 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
the `tree` myself.
This was just an afternoon project that's turning into a week long project since
it's quite a lot of fun!