diff --git a/README.md b/README.md index 008b0f4..1eb0f41 100644 --- a/README.md +++ b/README.md @@ -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