wmtools/README.MD

38 lines
1.4 KiB
Markdown

# A selection of information output tools for dmenu
These are a selection of independant tools for displaying various information
about system status in dmenu. Some of them i.e. `volume` have options (up, down, mute...)
which are selectable options in dmenu.
Example in dmenu:
https://user-images.githubusercontent.com/31094984/166115207-c24e9ec8-136e-4956-9842-bcde496bb743.mp4
Example in rofi:
https://user-images.githubusercontent.com/31094984/166115213-511fdaaa-4c04-461a-9976-38a2e9bd83fe.mp4
They are compiled separately, for example:
```nim
nim c pingclock
```
and then run with
```sh
./pingclock dmenu
or
./pingclock rofi
```
it can also be run without any arguments to receive a i3bar compatible json string
Personally, I have these bound to key combinations in i3. In fact, I have a seperate `bindsym` mode in which all these tools are accessible i.e. `$mod+i` to get to "info" mode then `p` to show pingclock.
There's also an i3bar_tools_threaded folder with tools for use with i3bar/i3blocks which continously update. Currently these are not working as I recently switched from this as primary, to a secondary choice.
These have some configuration variables explicit to me, you'll need to change them for you for them to be useful I imagine.
### Dependencies
- dmenu, rofi, or i3bar (with i3blocks)
I'm aware my code is messy. I'm aware my code is undocumented. But hopefully these things are simple enough to work out.