|
|
@ -1,8 +1,110 @@ |
|
|
|
# dwm-bar |
|
|
|
A modular statusbar for DWM thrown together in sh |
|
|
|
A modular statusbar for DWM |
|
|
|
## Table of Contents |
|
|
|
- [Current Functions](#current-functions) |
|
|
|
- [dwm_alsa](#dwm_alsa) |
|
|
|
- [dwm_countdown](#dwm_countdown) |
|
|
|
- [dwm_keyboard](#dwm_keyboard) |
|
|
|
- [dwm_resources](#dwm_resources) |
|
|
|
- [dwm_cmus](#dwm_cmus) |
|
|
|
- [dwm_date](#dwm_date) |
|
|
|
- [dwm_mail](#dwm_mail) |
|
|
|
- [dwm_weather](#dwm_weather) |
|
|
|
- [Installation](#installation) |
|
|
|
- [Usage](#usage) |
|
|
|
- [Customizing](#customizing) |
|
|
|
- [Acknowledgements](#acknowledgements) |
|
|
|
- [More to come!](#more-to-come) |
|
|
|
## Current Functions |
|
|
|
### dwm_alsa |
|
|
|
Displays the current master volume of ALSA |
|
|
|
``` |
|
|
|
[🔉 55] |
|
|
|
``` |
|
|
|
Dependencies: ```alsa-utils``` |
|
|
|
### dwm_countdown |
|
|
|
Displays the status of [countdown](https://github.com/joestandring/countdown) |
|
|
|
``` |
|
|
|
[⏳ 00:10:00] |
|
|
|
``` |
|
|
|
Dependeincies: ```[countdown](https://github.com/joestandring/countdown)``` |
|
|
|
### dwm_keyboard |
|
|
|
Displays the current keyboard layout |
|
|
|
``` |
|
|
|
[⌨ gb] |
|
|
|
``` |
|
|
|
Dependencies: ```xorg-setxkbmap``` |
|
|
|
### dwm_resources |
|
|
|
Displays information regarding memory, CPU temperature, and storage |
|
|
|
``` |
|
|
|
[🖥 MEM 1.3Gi/15Gi CPU 45C STO 2.3G/200G: 2%] |
|
|
|
``` |
|
|
|
### dwm_cmus |
|
|
|
displays current cmus status, artist, track, position, duration, and shuffle |
|
|
|
``` |
|
|
|
[▶ The Unicorns - Tuff Ghost 0:43/2:56 🔀] |
|
|
|
``` |
|
|
|
Dependencies: ```cmus``` |
|
|
|
### dwm_date |
|
|
|
Displays the current date and time |
|
|
|
``` |
|
|
|
[🕰 Mon 06-05-19 21:31:58] |
|
|
|
``` |
|
|
|
### dwm_mail |
|
|
|
Displays the current number of emails in an inbox |
|
|
|
``` |
|
|
|
[📫 2] |
|
|
|
``` |
|
|
|
### dwm_weather |
|
|
|
Displays the current weather provided by [wttr.in](https://wttr.in) |
|
|
|
``` |
|
|
|
[☀ +20°C] |
|
|
|
``` |
|
|
|
## Installation |
|
|
|
1. Clone and enter the repository: |
|
|
|
``` |
|
|
|
$ git clone https://github.com/joestandring/dwm-bar |
|
|
|
$ cd dwm-bar |
|
|
|
``` |
|
|
|
2. Make the script executable |
|
|
|
``` |
|
|
|
$ chmod +x dwm_bar.sh |
|
|
|
``` |
|
|
|
## Usage |
|
|
|
Simply run the script and dwm should display your bar: |
|
|
|
``` |
|
|
|
$ ./dwm_bar.sh |
|
|
|
``` |
|
|
|
If you would like your bar to be displayed when X starts, add this to your .xinitrc file before launching dwm. For example, if the script is located in /home/$USER/dwm-bar/: |
|
|
|
``` |
|
|
|
# Statusbar |
|
|
|
/home/$USER/dwm-bar/dwm_status.sh & |
|
|
|
|
|
|
|
# Start dwm |
|
|
|
exec dwm |
|
|
|
``` |
|
|
|
## Customizing |
|
|
|
dwm-bar is completley modular, meaning you can mix and match functions to your hearts content. It's functions are located in the functions/ subdirectory and included in dwm_bar.sh |
|
|
|
If you want to make your own function, for example dwm_myfunction.sh, you should create it in the functions/ subdirectory before including it in dwm_bar.sh and adding it to the xsetroot command: |
|
|
|
``` |
|
|
|
# Import the modules |
|
|
|
. "$DIR/functions/dwm_myfucntion" |
|
|
|
|
|
|
|
while true |
|
|
|
do |
|
|
|
xsetroot -name "$(dwm_myfunction)" |
|
|
|
sleep 1 |
|
|
|
done |
|
|
|
``` |
|
|
|
## Acknowledgements |
|
|
|
Code for some functions was modified from: |
|
|
|
* [Klemens Nanni](https://notabug.org/kl3) |
|
|
|
* [@boylemic](https://github.com/boylemic/configs/blob/master/dwm_status) |
|
|
|
* [Parket Johnson](https://github.com/ronno/scripts/blob/master/xsetcmus) |
|
|
|
* [suckless.org](https://dwm.suckless.org/status_monitor/) |
|
|
|
## More to come! |
|
|
|
* Ability to choose between showing unicode charachters or plaintext for identifiers in the bar |
|
|
|
* dwm_pulse function to control pulseaudio sound |
|
|
|
* dwm_bat function to display battery percentage and status |
|
|
|
* dwm_notifs function to show the last recieved notification in the bar |
|
|
|
* The ability to show network speeds and SSID in dwm_network |