# dwm-bar A modular statusbar for dwm ![screenshot](sshot.png) [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/J3J11S7DZ) ## Table of Contents - [Current Functions](#current-functions) - [dwm_alsa](#dwm_alsa) - [dwm_pulse](#dwm_pulse) - [dwm_battery](#dwm_battery) - [dwm_countdown](#dwm_countdown) - [dwm_alarm](#dwm_alarm) - [dwm_keyboard](#dwm_keyboard) - [dwm_resources](#dwm_resources) - [dwm_cmus](#dwm_cmus) - [dwm_mpc](#dwm_mpc) - [dwm_spotify](#dwm_mpc) - [dwm_date](#dwm_date) - [dwm_mail](#dwm_mail) - [dwm_weather](#dwm_weather) - [dwm_networkmanager](#dwm_networkmanager) - [dwm_wpa](#dwm_wpa) - [dwm_vpn](#dwm_vpn) - [dwm_ccurse](#dwm_ccurse) - [dwm_transmission](#dwm_transmission) - [dwm_backlight](#dwm_backlight) - [dwm_connman](#dwm_connman) - [dwm_loadavg](#dwm_loadavg) - [Installation](#installation) - [Reccomendations](#reccomendations) - [Usage](#usage) - [Customizing](#customizing) - [Contributing](#contributing) - [Acknowledgements](#acknowledgements) ### dwm_alsa Displays the current master volume of ALSA ``` [🔉 55%] ``` Dependencies: ```alsa-utils``` ### dwm_pulse Displays the current master volume of PulseAudio ``` [🔉 55%] ``` Dependencies: ```pamixer``` ### dwm_battery Displays battery level and status ``` [🔋 100% full] ``` ### dwm_countdown Displays the status of [countdown](https://github.com/joestandring/countdown) ``` [⏳ 00:10:00] ``` Dependencies: ```countdown.sh``` ### dwm_alarm Displays upcoming alarms from [alarm](https://github.com/joestandring/alarm) ``` [⏰ 22:30:00] ``` Dependencies: ```alarm.sh``` ### 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_mpc Displays current mpc status, artist, track, position, duration, and shuffle ``` [▶ The Unicorns - Tuff Ghost 0:43/2:56 🔀] ``` Dependencies: ```mpc``` ### dwm_spotify Displays current Spotify status, artist, track, and duration Unfortunatley a method to display the track position and shuffle status have not been found ``` [▶ The Unicorns - Tuff Ghost 2:56] ``` Dependencies: ```spotify, playerctl``` ### 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) Please remember wttr.in has a limited number of requests, so this module may occasionally not be able to recieve weather information when experiencing high traffic. ``` [☀ +20°C] ``` ### dwm_networkmanager Displays the current network connection, private IP, and public IP using NetworkManager ``` [🌐 enp7s0: 192.168.0.1/24 | 185.199.109.153] ``` Dependencies: ```NetworkManager, curl``` ### dwm_wpa Displays the current network connection and private IP using wpa_cli ``` [襤 My-Wifi 192.168.0.3] ``` Dependancies: ```wpa_cli``` ### dwm_vpn Displays the current VPN connection ``` [🔒 Sweden - Stockholm] ``` Dependencies: ```NetworkManager-openvpn``` ### dwm_ccurse Displays the next appointment from calcurse ``` [💡 18/04/19 19:00 20:00 Upload dwm_ccurse] ``` Dependencies: ```calcurse``` ### dwm_transmission Displays the current status of a torrent with transmission-remote ``` [⏬ archlinux-2019.06.01... | 92% 1min ⬆3.4 ⬇1.5] ``` Dependencies: ```transmission-remote``` ### dwm_backlight Displays the current backlight level with xbacklight ``` [☀ 80] ``` Dependencies: ```xbacklight``` ### dwm_connman Shows network information IP, SSID, WLan strength (if connected to WLan) using connman. ``` [🌐 192.169.189.12 HomeNetworkName 53%] ``` Dependencies: ```connman``` ### dwm_loadavg Displays the average system load ``` [⏱ 0.14 0.17 0.18] ``` ## 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 ``` ## Recommendations To make the most out of unicode support, consider using a font that inludes many unicode charachters. For example: * [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts) * [Siji](https://github.com/stark/siji) * [Font Awesome](https://fontawesome.com/) While not always neccessary, it's a good idea to specify these fonts in your dwm config. ## Quick Start Simply run the script and dwm should display your bar: ``` $ ./dwm_bar.sh ``` Most likely, you will need to change some values for functions to get them to work - these are outlined with a comment for functions where this is likely the case. 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_bar.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 bar-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 bar-functions/ subdirectory before including it in dwm_bar.sh and adding it to the xsetroot command: ``` # Import the modules . "$DIR/bar-functions/dwm_myfucntion" while true do xsetroot -name "$(dwm_myfunction)" sleep 1 done ``` You can also decide to use unicode or plaintext identifiers for functions by altering the ```$IDENTIFIER``` value. For example, set to ```"unicode"```, ```dwm_mail``` will display: ``` [📫 0] ``` Whereas, if it is not set it will display: ``` [MAIL 0] ``` ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md) before contributing. ## 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/) * [@mcallistertyler95](https://github.com/mcallistertyler95/dwm-bar)