mirror of
https://github.com/kolunmi/dwlb.git
synced 2025-09-08 12:24:44 +00:00
54 lines
2.2 KiB
Markdown
54 lines
2.2 KiB
Markdown
# dwlb
|
|
|
|
|
|
|
|
|
|
dwlb is a feature-complete bar for [dwl](https://github.com/djpohly/dwl).
|
|
|
|
## Dependencies
|
|
* libwayland-client
|
|
* libwayland-cursor
|
|
* pixman
|
|
* fcft
|
|
* uthash
|
|
|
|
## Installation
|
|
```bash
|
|
git clone https://github.com/kolunmi/dwlb
|
|
cd dwlb
|
|
make
|
|
make install
|
|
```
|
|
|
|
## Usage
|
|
Pass `dwlb` as an argument to dwl's `-s` flag. This will populate each connected output with a bar. For example:
|
|
```bash
|
|
dwl -s 'dwlb -font "monospace:size=16"'
|
|
```
|
|
|
|
## Ipc
|
|
If dwl is patched appropriately, dwlb is capable of communicating directly with dwl. When ipc is enabled with `-ipc`, dwlb does not read from stdin, and clicking tags functions as you would expect. Ipc can be disabled with `-no-ipc`.
|
|
|
|
## Commands
|
|
Command options send instructions to existing instances of dwlb. All commands take at least one argument to specify a bar on which to operate. This may be zxdg_output_v1 name, "all" to affect all outputs, "selected" for the current output, or "first" for the first output in the internal list.
|
|
|
|
### Status Text
|
|
The `-status` command is used to write status text. The text may contain in-line commands in the following format: `^cmd(argument)`.
|
|
|
|
| In-Line Command | Description |
|
|
|---------------------|-----------------------------------------------------------------------------|
|
|
| `^fg(HEXCOLOR)` | Sets foreground color to `HEXCOLOR`. |
|
|
| `^bg(HEXCOLOR)` | Sets background color to `HEXCOLOR`. |
|
|
| `^lm(SHELLCOMMAND)` | Begins or terminates left mouse button region with action `SHELLCOMMAND`. |
|
|
| `^mm(SHELLCOMMAND)` | Begins or terminates middle mouse button region with action `SHELLCOMMAND`. |
|
|
| `^rm(SHELLCOMMAND)` | Begins or terminates right mouse button region with action `SHELLCOMMAND`. |
|
|
|
|
A color command with no argument reverts to the default value. `^^` represents a single `^` character. Status commands can be disabled with `-no-status-commands`.
|
|
|
|
## Other Options
|
|
Run `dwlb -h` for a full list of options.
|
|
|
|
## Acknowledgements
|
|
* [dtao](https://github.com/djpohly/dtao)
|
|
* [somebar](https://sr.ht/~raphi/somebar/)
|