dzen-dhall plugins

A curated set of plugins for dzen-dhall.

Refer to the docs for instructions on how to install plugins.

You are welcome to contribute yours via pull requests. The advantage of doing so is that your plugins will be updated by maintainer(s) in case of a breaking API change, and other users will be able to easily discover your code. See CONTRIBUTING.md for instructions.

Catalogue

A list of all available plugins.

amixer-volume

Prints current volume. The output becomes red when the volume is off.

Run dzen-dhall plug amixer-volume to install.

Show usage

let amixer-volume = (./plugins/amixer-volume.dhall)

in  plug (amixer-volume.main amixer-volume.defaults) : Bar

Settings:

let Settings
	: Type
	= { device : Text -- `-D` flag (amixer)
	  , card : Optional Text -- `-c` flag (amixer)
	  , onColor : Color
	  , offColor : Color
	  , scoped : Bool -- whether to wrap the plugin into a separate scope.
	  , updateInterval : Natural
	  }

date

A wrapper over date binary, prints current date formatted according to a given format string.

Run dzen-dhall plug date to install.

Show usage

let date = (./plugins/date.dhall).main

in plug (date "%d.%m.%Y %A - %H:%M:%S")

icons

A pack of XBM icons.

Show detailed previews

Name	Preview
ac_01
ac
alert
arch_10x10
arch
ball
bat_empty_01
bat_empty_02
bat_full_01
bat_full_02
bat_low_01
bat_low_02
battery
bluetooth
bug_01
bug_02
cat
clock
cpu
dish
diskette
empty
envelope
eye_l
eye_r
fox
fs_01
fs_02
full
fwd
half
info_01
info_02
info_03
mail
mem
mouse_01
music
net_down_01
net_down_02
net_down_03
net_up_01
net_up_02
net_up_03
net_wired
next
note
pacman
pause
phones
play
plug
prev
rwd
scorpio
shroom
spkr_01
spkr_02
spkr_03
stop
temp
test
usb_02
usb
volume
wifi_01
wifi_02

Run dzen-dhall plug icons to install.

Show usage

let icons = (./plugins/icons.dhall).main

in	join
  [ plug icons.ac_01
  , plug icons.ac
  , plug icons.alert
  , plug icons.arch_10x10
  , plug icons.arch
  , plug icons.ball
  , plug icons.bat_empty_01
  , plug icons.bat_empty_02
  , plug icons.bat_full_01
  , plug icons.bat_full_02
  , plug icons.bat_low_01
  , plug icons.bat_low_02
  , plug icons.battery
  , plug icons.bluetooth
  , plug icons.bug_01
  , plug icons.bug_02
  , plug icons.cat
  , plug icons.clock
  , plug icons.cpu
  , plug icons.dish
  , plug icons.diskette
  , plug icons.empty
  , plug icons.envelope
  , plug icons.eye_l
  , plug icons.eye_r
  , plug icons.fox
  , plug icons.fs_01
  , plug icons.fs_02
  , plug icons.full
  , plug icons.fwd
  , plug icons.half
  , plug icons.info_01
  , plug icons.info_02
  , plug icons.info_03
  , plug icons.mail
  , plug icons.mem
  , plug icons.mouse_01
  , plug icons.music
  , plug icons.net_down_01
  , plug icons.net_down_02
  , plug icons.net_down_03
  , plug icons.net_up_01
  , plug icons.net_up_02
  , plug icons.net_up_03
  , plug icons.net_wired
  , plug icons.next
  , plug icons.note
  , plug icons.pacman
  , plug icons.pause
  , plug icons.phones
  , plug icons.play
  , plug icons.plug
  , plug icons.prev
  , plug icons.rwd
  , plug icons.scorpio
  , plug icons.shroom
  , plug icons.spkr_01
  , plug icons.spkr_02
  , plug icons.spkr_03
  , plug icons.stop
  , plug icons.temp
  , plug icons.test
  , plug icons.usb_02
  , plug icons.usb
  , plug icons.volume
  , plug icons.wifi_01
  , plug icons.wifi_02
  ]

mpc

MPD integration using MPC. A higher-order plugin with reasonable defaults.

Text fades out when music is paused.

Show usage

let mpc = (./plugins/mpc.dhall)

in	plug (mpc.main mpc.defaults) : Bar

Settings provide ability to customize appearance in three modes:

• music is playing

• music is paused

• the player is off (no tracks)

Inside three Bars that are accepted by the plugin (one for each mode), some events and variables are available (see mpc/demo.dhall for usage example):

let Settings
	: Type
	= { playing : Bar
	  , off : Bar
	  , paused : Bar
	  , events : { Resume : Event, Pause : Event, TurnOff : Event }
	  , variables : { Album : Variable, Artist : Variable, Title : Variable }
	  , updateInterval : Natural
	  , scoped : Bool
	  }

mpc-simple

A minimal mpd status viewer that uses mpc. Prints artist, title and album.

Clicking the output copies it to clipboard (using xclip).

To disable clipboard feature, override the default settings:

(mpc-simple.defaults // { useXClip = False })

Run dzen-dhall plug mpc-simple to install.

Show usage

let mpc-simple = (./plugins/mpc-simple.dhall)

in	plug (mpc-simple.main mpc-simple.defaults) : Bar

plugin-template

A template for new plugins. See plugin development section.

tomato

A digital tomato-timer to increase your productivity.

Allows to set a countdown for some period of time, and run arbitrary shell command when the time is up.

Run dzen-dhall plug tomato to install.

Show usage

let tomato = (./plugins/tomato.dhall).main

in	plug
  ( tomato
	''
	notify-send --urgency critical " *** Time is up! *** "
	''
  )