dwm-bar

A modular statusbar for dwm

Table of Contents

• Current Functions
  • dwm_alsa
  • dwm_pulse
  • dwm_battery
  • dwm_countdown
  • dwm_alarm
  • dwm_keyboard
  • dwm_resources
  • dwm_cmus
  • dwm_mpc
  • dwm_spotify
  • dwm_date
  • dwm_mail
  • dwm_weather
  • dwm_networkmanager
  • dwm_wpa
  • dwm_vpn
  • dwm_ccurse
  • dwm_transmission
  • dwm_backlight
  • dwm_connman
  • dwm_loadavg
  • dwm_currency
  • dwmsolarpanel
• Installation
• Reccomendations
• Usage
• Customizing
• Contributing
• Acknowledgements ### dwmalsa Displays the current master volume of ALSA

  [🔉 55%]
  

  Dependencies:

  alsa-utils

  ### dwmpulse Displays the current master volume of PulseAudio

  [🔉 55%]
  

  Dependencies:

  pamixer

  ### dwmbattery Displays battery level and status

  [🔋 100% full]
  

  ### dwmcountdown Displays the status of countdown

  [⏳ 00:10:00]
  

  Dependencies:

  countdown.sh

  ### dwmalarm Displays upcoming alarms from alarm

  [⏰ 22:30:00]
  

  Dependencies:

  alarm.sh

  ### dwmkeyboard Displays the current keyboard layout

  [⌨ gb]
  

  Dependencies:

  xorg-setxkbmap

  ### dwmresources Displays information regarding memory, CPU temperature, and storage

  [🖥 MEM 1.3Gi/15Gi CPU 45C STO 2.3G/200G: 2%]
  

  ### dwmcmus Displays current cmus status, artist, track, position, duration, and shuffle

  [▶ The Unicorns - Tuff Ghost 0:43/2:56 🔀]
  

  Dependencies:

  cmus

  ### dwmmpc Displays current mpc status, artist, track, position, duration, and shuffle

  [▶ The Unicorns - Tuff Ghost 0:43/2:56 🔀]
  

  Dependencies:

  mpc

  ### dwmspotify Displays current Spotify status, artist, track, and duration

Either the official Spotify client or spotifyd can be used. Unfortunatley, only spotifyd can provide track position and shuffle status

[▶ The Unicorns - Tuff Ghost 0:43/2:56 🔀]

spotify/spotifyd, 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

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]

NetworkManager, curl

dwm_wpa

Displays the current network connection and private IP using wpacli

[襤 My-Wifi 192.168.0.3]

dwm_vpn

Displays the current VPN connections with OpenVPN or Wireguard

[🔒 Sweden - Stockholm]

NetworkManager, NetworkManager-openvpn (for OpenVPN connections)

dwm_ccurse

Displays the next appointment from calcurse

[💡 18/04/19 19:00 20:00 Upload dwm_ccurse]

calcurse

dwm_transmission

Displays the current status of a torrent with transmission-remote

[⏬ archlinux-2019.06.01... | 92% 1min ⬆3.4 ⬇1.5]

transmission-remote

dwm_backlight

Displays the current backlight level with xbacklight

[☀ 80]

xbacklight

dwm_connman

Shows network information IP, SSID, WLan strength (if connected to WLan) using connman.

[🌐 192.169.189.12 HomeNetworkName 53%]

connman

dwm_loadavg

Displays the average system load

[⏱ 0.14 0.17 0.18]

dwmsolarpanel

Displays how much power is being produced from your solar panels

[💡 3.012 W ]

dwm_currency

Displays the current rate of your currency in comparison to the USD provided by rate.sx

[💡 1.225 ]

curl

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:
3. Nerd Fonts
4. Siji
5. Font Awesome

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

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 dwmbar.sh If you want to make your own function, for example dwmmyfunction.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 "$(dwmmyfunction)" sleep 1 done

You can also decide to use unicode or plaintext identifiers for functions by altering the

value. For example, set to

,

will display:

Whereas, if it is not set it will display:

Contributing

See CONTRIBUTING.md before contributing.

Acknowledgements

Code for some functions was modified from: * Klemens Nanni * @boylemic * Parket Johnson * suckless.org * @mcallistertyler95