56 lines
1.5 KiB
Markdown
56 lines
1.5 KiB
Markdown
# dwmstatus
|
|
## Description
|
|
A simple, customizable status bar for Dynamic Window Manager(dwm)
|
|
|
|
Exports status bar to X11 root window via xcb instead of xlib
|
|
|
|
Output:
|
|
```
|
|
/* charging */
|
|
<---> │ 0.94GHz │ 39°C │ [100%+] │ Vol: 50% │ 1:09 │ Thu 10/29 4:20
|
|
/* discharging */
|
|
<---> │ 0.94GHz │ 39°C │ [99%] │ Vol: 50% │ 1:69 │ Thu 10/29 4:20
|
|
/* AC power */
|
|
<---> │ 0.94GHz │ 39°C │ [0%] │ Vol: 50% │ 1:48 │ Thu 10/29 4:20
|
|
```
|
|
|
|
## Requirements
|
|
- c compiler
|
|
- [xcb-util](https://xcb.freedesktop.org/) [For exporting status bar to root X11 window]
|
|
- Kernel options:
|
|
- `CONFIG_SYSFS`: sysfs file system support [Where most information will be parsed from]
|
|
- `CONFIG_THERMAL_HWMON`: Expose thermal sensors as hwmon device [For getting cpu temps]
|
|
|
|
## Installation
|
|
Installation using **make**:
|
|
```
|
|
$ cd dwmstatus/src
|
|
$ make
|
|
# make install
|
|
```
|
|
Alternatively, you can install using **meson**:
|
|
```
|
|
$ cd dwmstatus
|
|
$ meson build
|
|
$ ninja -C build
|
|
# ninja -C build install
|
|
```
|
|
|
|
## Running
|
|
```
|
|
$ dwmstatus_std # for outputting to stdout
|
|
$ dwmstatus_xcb # for outputting to X11 root window
|
|
```
|
|
|
|
## Configuration
|
|
All configurations are done through `config.def.h`/`config.h`
|
|
to keep the program simple and fast(?).
|
|
Note: some functions may be commented from my usages.
|
|
Uncomment to use them.
|
|
|
|
## Features
|
|
- Displays date, uptime, battery percentage
|
|
- Displays a single cpu's frequency and temperature
|
|
- Displays network connections
|
|
- only if connected to access point, not internet access
|