| @ -1,8 +1,110 @@ | |||||
| # dwm-bar | # 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 | ## Acknowledgements | ||||
| Code for some functions was modified from: | Code for some functions was modified from: | ||||
| * [Klemens Nanni](https://notabug.org/kl3) | * [Klemens Nanni](https://notabug.org/kl3) | ||||
| * [@boylemic](https://github.com/boylemic/configs/blob/master/dwm_status) | * [@boylemic](https://github.com/boylemic/configs/blob/master/dwm_status) | ||||
| * [Parket Johnson](https://github.com/ronno/scripts/blob/master/xsetcmus) | * [Parket Johnson](https://github.com/ronno/scripts/blob/master/xsetcmus) | ||||
| * [suckless.org](https://dwm.suckless.org/status_monitor/) | * [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 | |||||