wmtools/README.MD

# 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.  

## Tools
- `pingclock`   performs a single `ping` to a server and returns the response time
- `battery`     shows the current battery level
- `brightness`  shows the current backlight level and gives options to adjust it
- `volume`      shows the current volume level and gives options to adjust and manage it
- `date`        shows the date
- `fuzzytime`   shows the fuzzytime clock
- `wlan`        shows the state of the wireless network interface. SSID connected to and signal level.
- `nic`         shows the status and/or the ip address of the network interface card
- `temperature` shows the current CPU temperature
- `notes`       a simple one liner note taking tool, displaying notes in dmenu/rofi


### 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

## How to use 
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.  
  
### You can also set the volume and brightness levels by typing a numeric figure into the dmenu/rofi input box  

https://user-images.githubusercontent.com/31094984/166156793-2089cc10-2649-4079-b82d-bba272253dd6.mp4

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.