dwlb/README.md
2023-02-20 12:51:08 -07:00

1.9 KiB

dwlb

screenshot 1 screenshot 2

dwlb is a simple bar for dwl. It is a modified version of dtao.

Dependencies

  • libwayland-client
  • libwayland-cursor
  • pixman
  • fcft
  • uthash

Installation

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:

dwl -s 'dwlb -font "monospace:size=16"'

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.