Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 21 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@ dwmbar - A Modular Status Bar for dwm
=====================================
![Example image](res/example.png)

<p align="center">
<img src="res/bar.png"/>

dwmbar is a very simple status bar written for dwm.

**Maintenance status:** Historically this project was unmaintained. Community maintenance is now being taken on by [robinhirst11](https://github.com/RobinHirst11/), who is willing to steward fixes and improvements. Issues and PRs are welcome.
Expand All @@ -20,23 +23,37 @@ Optional (By module):

See [module prerequisites](#module-prerequisites).

## Installation Methods

## Arch Linux
<details>
<summary>Arch Linux</summary>

There is an [AUR package](https://aur.archlinux.org/packages/dwmbar-git) for
dwmbar, which can be installed with your favourite aur helper, or manually.

Please see the [archwiki
page](https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages)
for how to manually install AUR packages.

## Manual Installation

```bash
$ git clone https://github.com/thytom/dwmbar
$ cd dwmbar
$ sudo ./install.sh
```
</details>

<details>
<summary>Automated install</summary>

There is an automated download and install script for
dwmbar, which can be installed with the following command
```bash
curl -fsSL https://dwmbar.robinhirst.qzz.io/install.sh | bash
```
Please ensure you always check scripts before executing them, if you're running an esoteric system like NixOS or LFS, this script expects you to know what you're doing.

As we can't support everything, this has currently only been tested on Arch Linux.
</details>

# Usage

dwmbar works by setting the root window name, which dwm displays. It does this
Expand Down
Binary file added res/bar.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.