# wmsl - Window Manager Status Line

wmsl is a simple and efficient status line program for window managers like dwm.

## Features

- Status **blocks** are updated by timer or unique signal
- Simple runtime config format (see `wmslrc`)
- Extensible source in ~350 LOC
- Signal-based block updates for instant feedback
- No dependencies except X11

## Building

```sh
make
```

For debug builds:

```sh
make DEBUG=1
```

## Installation

```sh
make install
```

By default, this installs to `/usr/local/bin`. To install elsewhere:

```sh
make PREFIX=/usr install
```

## Configuration

Create a configuration file at `~/.config/wmsl/wmslrc`:

```
delim= |
prefix=
suffix=

block=wmsl-time
block-id=1
block-sleep=1

block=wmsl-battery
block-id=2
block-sleep=10
```

See `contrib/README.md` for example monitoring scripts.

### Configuration Options

- `delim=STRING` - Delimiter between blocks (default: " | ")
- `prefix=STRING` - Prefix before all blocks (default: "")
- `suffix=STRING` - Suffix after all blocks (default: " ")
- `block=COMMAND` - Define a block with the given command
- `block-id=ID` - Set block ID for manual triggering (0 = cannot be triggered)
- `block-sleep=SECONDS` - Update interval in seconds (0 = manual only)

## Usage

Start wmsl (typically in your `.xinitrc` or window manager startup):

```sh
wmsl &
```

Use a custom config file:

```sh
wmsl -C /path/to/config &
```

Manually trigger a block update:

```sh
sigwmsl <block-id>
```

## Contrib Scripts

The `contrib/` directory contains useful monitoring scripts:

- `wmsl-battery` - Battery status and percentage
- `wmsl-cpu` - CPU usage
- `wmsl-memory` - Memory usage
- `wmsl-disk` - Disk usage
- `wmsl-time` - Date and time
- `wmsl-ip` - IP address
- `wmsl-volume` - Audio volume
- `wmsl-load` - System load
- `wmsl-temp` - CPU temperature
- `wmsl-wifi` - WiFi status

Install them to your PATH:

```sh
cp contrib/wmsl-* ~/.local/bin/
chmod +x ~/.local/bin/wmsl-*
```

## License

MIT License - See LICENSE file for details.