Lemonbuddy

A fast and easy-to-use tool for generating status bars.

Lemonbuddy aims to help users build beautiful and highly customizable status bars for their desktop environment, without the need of having a black belt in shell scripting. Heres a few screenshots showing you what it can look like:

Please note that the project still is in early development, so please report any problems by creating an issue ticket.

Table of Contents

• Introduction
• Getting started
  • Dependencies
  • Building from source
• Running
• Launching the bar in your wm's bootstrap routine
• Configuration
  • Fonts
  • Syntax and DSL
  • Application settings
  • Bar settings
  • Modules
    • internal/backlight
    • internal/battery
    • internal/bspwm
    • internal/cpu
    • internal/date
    • internal/i3
    • internal/memory
    • internal/mpd
    • internal/network
    • internal/volume
    • custom/menu
    • custom/script
    • custom/text
• Example configurations
• License

Introduction

The main purpose of Lemonbuddy is serve as content generator for status bars. It has built-in functionality to generate output for the most commonly used widgets, such as:

• Playback controls and status display for MPD using libmpdclient
• ALSA volume controls
• Workspace and desktop panel for bspwm and i3
• CPU and memory load indicator
• Battery display
• Network connection details
• Backlight level
• Date and time label
• Time-based shell script execution
• Command output tailing
• User-defined menu tree
• And more...

Each bar contains a set of modules, which in turn defines a set of formatting rules and options. Read more about how the configuration works.

The project was developed specifically for Lemonbar, and the initial plan was to integrate a trimmed down version of it into Lemonbuddy. This would remove the need of having to pass data back and forth between the two processes.

After spending time trying to create an interface to the Lemonbar source code, I decided to not use it at all. Lemonbar is a great application but it would be more efficient to write a custom X rendering implementation instead of trying to patch up Lemonbar. Not only does it fix the "Lemonbuddy doesn't work with my extra-custom-lemonbar-fork" issue, it also makes it alot easier to implement new features... The performance boost is of course also welcome to join the party, so that's nice.

The new implementation will use the same %{...} syntax Lemonbar uses, which means that existing configurations will still work, so keep ricing.

Getting started

If you are using Arch Linux, you can install the AUR package lemonbuddy-git to get the latest version, or lemonbuddy for the latest stable release.

For Void Linux users, the application can be installed using XBPS: xbps-install -S lemonbuddy.

If you create a package for any other distribution, please consider contributing the template so that we can make the application available for more people.

Dependencies

A compiler with c++14 support. For example clang.

• cmake
• boost
• libxcb
• xcb-proto
• freetype2

Optional dependencies for module support:

• wireless_tools (required for internal/network support)
• alsa-lib (required for internal/volume support)
• libmpdclient (required for internal/mpd support)
• jsoncpp (required for internal/i3 support)

$ pacman -S cmake boost libxcb xcb-proto wireless_tools alsa-lib libmpdclient jsoncpp
$ xbps-install cmake boost-devel libxcb-devel alsa-lib-devel i3-devel libmpdclient-devel jsoncpp-devel freetype-devel wireless_tools-devel
$ apt-get install cmake libxcb1-dev xcb-proto python-xcbgen libboost-dev libiw-dev libasound2-dev libmpdclient-dev libjsoncpp-dev libfreetype6-dev

Building from source

Please report any problems you run into when building the project. It helps alot.

$ git clone --branch 2.0.0 --recursive https://github.com/jaagr/lemonbuddy
$ mkdir lemonbuddy/build
$ cd lemonbuddy/build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ sudo make install

Running

Before customizing the bar, make sure everything works as expected by trying out one of the example configurations installed with the application. The following code will get you started:

# Create the config root directory
$ mkdir -p ${XDG_CONFIG_HOME:-$HOME/.config}/lemonbuddy
$ cd ${XDG_CONFIG_HOME:-$HOME/.config}/lemonbuddy

# Copy sample config for the running wm (uses a wm agnostic config as fallback)
$ __wm=$(pgrep -l -x "(bspwm|i3)"); __prefix=$(which lemonbuddy)
$ cp "${__prefix%%/bin*}/share/examples/lemonbuddy/config${__wm:+.${__wm##* }}" config

# Launch the bar
# (where "example" is the name of the bar as defined by [bar/NAME] in the config)
$ lemonbuddy example

NOTE: In case the bar output looks odd, it's probably because you're missing he fonts defined in the config. Update the config or install the missing fonts.

Launching the bar in your wm's bootstrap routine

Create an executable file containing the startup logic, for example $HOME/.config/lemonbuddy/launch.sh:

#!/usr/bin/env sh

# Terminate already running bar instances
killall -q lemonbuddy

# Launch bar1 and bar2
lemonbuddy bar1 &
lemonbuddy bar2 &

echo "Bars launched..."

Make it executable:

$ chmod +x $HOME/.config/lemonbuddy/launch.sh

If you are using bspwm, add the following line to bspwmrc:

$HOME/.config/lemonbuddy/launch.sh

If you are using i3, add the following line to your configuration:

exec_always --no-startup-id $HOME/.config/lemonbuddy/launch.sh

Configuration

The configuration syntax is a work in progress. Please create an issue ticket and let me know how you think we can improve it.

The values used in the examples below are to be considered placeholder values, and the resulting output might not be award-winning.

Fonts

When working with unicode symbols, remember that fonts render the symbols differently. Changing font can drastically improve the quality of your bar. Unifont has great unicode coverage, which makes it really useful.

Also try different icon fonts, such as Font Awesome, Material Icons and my personal favorite: Siji.

TODO: Describe usage in configuration...

Syntax and DSL

TODO: Clarify...

The configuration syntax is based on the ini file format.

[section/name]
str = My string
; Hint: Quote the value to keep the spaces
str = "   My string"
bool = true
bool = on
int = 10
float = 10.0

; Values for a defined bar can be referenced using:
key = ${bar/top.foreground}

; Values for the current bar can be referenced using:
key = ${BAR.foreground}

; Other values can be referenced using:
key = ${section.key}

; Environment variables can be referenced using:
key = ${env:VAR_NAME}

[section/name]
; Most modules define a format-N field
; For example, the mpd module defines the following formats:
;   format-online = ...
;   format-offline = ...
;
; Each format exposes the following fields:
;   format[-NAME]-padding = N (unit: whitespaces)
;   format[-NAME]-margin  = N (unit: whitespaces)
; (See "Bar settings" for more details on "spacing")
;   format[-NAME]-spacing = N (unit: whitespaces)
; (This value will displace the format block horizontally by +/-N pixels)
;   format[-NAME]-offset  = N (unit: pixels)
;   format[-NAME]-foreground = #aa[rrggbb]
;   format[-NAME]-background = #aa[rrggbb]
;   format[-NAME]-underline  = #aa[rrggbb]
;   ^
;   |  the underline and overline color is always the same
;   v
;   format[-NAME]-overline   = #aa[rrggbb]
;
; The rest of the drawtypes follow the same pattern.
;
;   label-NAME[-(foreground|background|(under|over)line|font|padding|maxlen|ellipsis)] = ?
;   icon-NAME[-(foreground|background|(under|over)line|font|padding)] = ?
;   ramp-NAME-[0-9]+[-(foreground|background|(under|over)line|font|padding)] = ?
;   animation-NAME-[0-9]+[-(foreground|background|(under|over)line|font|padding)] = ?
;
;   bar-NAME-width = N (unit: characters)
;   bar-NAME-format = (tokens: %fill% %indicator% %empty%)
;   bar-NAME-foreground-[0-9]+ = #aarrggbb
;   bar-NAME-indicator[-(foreground|background|(under|over)line|font|padding)] =
;   bar-NAME-fill[-(foreground|background|(under|over)line|font|padding)] =
;   bar-NAME-empty[-(foreground|background|(under|over)line|font|padding)] =
;
; Example:
;
format-online = <icon-stop> <toggle>   <icon-repeat> <icon-random>   <bar-progress> <label-song>

format-offline = <label-offline>
format-offline-offset = -8

; Cap the song label without trailing ellipsis
label-song-maxlen = 30
label-song-ellipsis = false

; By only specifying alpha value, it will be applied to the bar's default foreground
label-time-foreground = #66

label-offline =  mpd is off
label-offline-foreground = #66

icon-play = 
icon-pause = 
icon-stop = 

bar-progress-width = 30
bar-progress-indicator = |
bar-progress-fill = █
bar-progress-empty = █
bar-progress-empty-foreground = #44

Application settings

[settings]
; Limit the amount of update events within a set timeframe:
; - "Allow <throttle_limit> updates within <throttle_ms> of time"
; Default values:
throttle_limit = 3
throttle_ms = 60

Bar settings

[bar/example]
; Use the following command to list available outputs:
; If unspecified, the application will pick the first one it finds.
; $ xrandr -q | grep " connected" | cut -d ' ' -f1
monitor = HDMI1

; Omit the % to specify the width in pixels
width = 100%
height = 30

; Offset value defined in pixels
offset-x = 0
offset-y = 0

; Put the bar at the bottom of the screen
bottom = true

; Weather to force docking mode or not
; If you are using i3wm it's recommended to use the default value
; Default: false
dock = true

; This value is used as a multiplier when adding spaces between elements
spacing = 3

; Height of under-/overline
lineheight = 14

; Colors
background = #ee222222
foreground = #eefafafa
linecolor = ${bar/example.background}

; Borders
; Size to be used for all borders
border-size = 2
; Color to be used for all borders
border-color = #ff9900
; Per-border values
;border-top = 1
;border-top-color = #ff9900
;border-bottom = 2
;border-bottom-color = #5d00ff
;border-left = 3
;border-right-color = #ff0059

; Number of spaces to add at the beginning/end of the bar
padding-left = 5
padding-right = 2

; Amount of spaces to add before/after each module
module-margin-left = 3
module-margin-right = 3

; Fonts are defined using: <FontName>;<Offset>
font-0 = NotoSans-Regular:size=8;0
font-1 = MaterialIcons:size=10;0
font-2 = Termsynu:size=8;-1
font-3 = FontAwesome:size=10;0

; The separator will be inserted between the output of each module
separator = |

; Value to be used to set the WM_NAME atom
; This defaults to "lemonbuddy-[BAR]_[MONITOR]"
wm-name = mybar

; Locale used to localize module output (for example date)
;locale = sv_SE.UTF-8

; Define what modules to output
modules-left = cpu ram
modules-center = label
modules-right = clock

; Position of the tray container
; If undefined, tray support will be disabled
;
; Available positions:
;   left
;   right
tray-position = right

; Restack the bar window and put it above the
; selected window manager's root
;
; Fixes the issue where the bar is being drawn
; on top of fullscreen window's
;
; Currently supported WM's:
;   bspwm
;   i3
; Default: none
wm-restack = bspwm

Modules

Module internal/backlight

[module/backlight]
type = internal/backlight

; Use the following command to list available cards:
; $ ls -1 /sys/class/backlight/
card = intel_backlight

Extra formatting (example)

; Available tags:
;   <label> (default)
;   <ramp>
;   <bar>
format = <ramp> <bar>

; Available tokens:
;   %percentage% (default)
label = %percentage%

ramp-0 = 🌕
ramp-1 = 🌔
ramp-2 = 🌓
ramp-3 = 🌒
ramp-4 = 🌑

bar-width = 10
bar-indicator = |
bar-fill = ─
bar-empty = ─

Module internal/battery

[module/battery]
type = internal/battery

; This is useful in case the battery never reports 100% charge
full-at = 99

; Use the following command to list batteries and adapters:
; $ ls -1 /sys/class/power_supply/
battery = BAT0
adapter = ADP1

; Seconds between reading battery capacity.
; If set to 0, polling will be disabled.
;poll-interval = 3

Extra formatting (example)

; Available tags:
;   <label-charging> (default)
;   <bar-capaity>
;   <ramp-capacity>
;   <animation-charging>
format-charging = <animation-charging> <label-charging>

; Available tags:
;   <label-discharging> (default)
;   <bar-capaity>
;   <ramp-capacity>
format-discharging = <ramp-capacity> <label-discharging>

; Available tags:
;   <label-full> (default)
;   <bar-capaity>
;   <ramp-capacity>
;format-full = <ramp-capacity> <label-full>

; Available tokens:
;   %percentage% (default)
label-charging = Charging %percentage%

; Available tokens:
;   %percentage% (default)
label-discharging = Discharging %percentage%

; Available tokens:
;   %percentage% (default)
label-full = Fully charged

ramp-capacity-0 = 
ramp-capacity-1 = 
ramp-capacity-2 = 
ramp-capacity-3 = 
ramp-capacity-4 = 

bar-capacity-width = 10

animation-charging-0 = 
animation-charging-1 = 
animation-charging-2 = 
animation-charging-3 = 
animation-charging-4 = 
; Framerate in milliseconds
animation-charging-framerate = 750

Module internal/bspwm

To specify a custom path to the bspwm socket, you can set the environment variable $BSPWM_SOCKET.

[module/bspwm]
type = internal/bspwm

Extra formatting (example)

; ws-icon-[0-9]+ = label;icon
ws-icon-0 = code;♚
ws-icon-1 = office;♛
ws-icon-2 = graphics;♜
ws-icon-3 = mail;♝
ws-icon-4 = web;♞
ws-icon-default = ♟

; Available tags:
;   <label-state> (default) - gets replaced with <label-(active|urgent|occupied|empty)>
;   <label-mode> - gets replaced with <label-(monocle|tiled|fullscreen|floating|locked|sticky|private)>
format = <label-state> <label-mode>

; If any values for label-dimmed-N area defined, the workspace/mode colors will get overridden
; with those values if the monitor is out of focus
label-dimmed-foreground = #555
label-dimmed-underline = ${BAR.background}

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-active = %icon%
label-active-foreground = #ffffff
label-active-background = #3f3f3f
label-active-underline = #fba922

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-occupied = %icon%
label-occupied-underline = #555555

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-urgent = %icon%
label-urgent-foreground = #000000
label-urgent-background = #bd2c40
label-urgent-underline = #9b0a20

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-empty = %icon%
label-empty-foreground = #55ffffff

; Available tokens:
;   None
label-monocle = 
;label-tiled = 
label-fullscreen = 
label-floating = 
label-locked = 
label-locked-foreground = #bd2c40
label-sticky = 
label-sticky-foreground = #fba922
label-private = 
label-private-foreground = #bd2c40

Module internal/cpu

[module/cpu]
type = internal/cpu

; Seconds to sleep between updates
;interval = 0.5

Extra formatting (example)

; Available tags:
;   <label> (default)
;   <bar-load>
;   <ramp-load>
;   <ramp-coreload>
format = <label> <ramp-coreload>

; Available tokens:
;   %percentage% (default) - total cpu load
label = CPU %percentage%

ramp-coreload-0 = ▁
ramp-coreload-1 = ▂
ramp-coreload-2 = ▃
ramp-coreload-3 = ▄
ramp-coreload-4 = ▅
ramp-coreload-5 = ▆
ramp-coreload-6 = ▇
ramp-coreload-7 = █

Module internal/date

[module/date]
type = internal/date

; Seconds to sleep between updates
;interval = 1.0

; see "man date" for details on how to format the date string
; NOTE: if you want to use lemonbar tags here you need to use %%{...}
date = %Y-%m-%d% %H:%M

; if `date-alt` is defined, clicking the area will toggle between formats
date-alt = %%{F#888}%A, %d %B %Y  %%{F#fff}%H:%M%%{F#666}:%%{F#fba922}%S%%{F-}

Extra formatting (example)

; Available tags:
;   <date> (default)
format = 🕓 <date>
format-background = #55ff3399
format-foreground = #fff

Module internal/i3

Requires the project to be built with support for i3. For more information, see the dependency section.

The module is still marked as WIP since it needs more testing. If you notice any anomalies, please create an issue.

See the bspwm module for details on label-dimmed.

[module/i3]
type = internal/i3

; Only show workspaces defined on the same output as the bar
;
; Useful if you want to show monitor specific workspaces
; in different bars
;
; Default: false
pin-workspaces = true

; Limit the amount of chars to output for each workspace name
; Default: 0
wsname-maxlen = 2

; Sort the workspaces by index instead of the default
; sorting that groups the workspaces by output
; Default: false
index-sort = true

Extra formatting (example)

; workspace_icon-[0-9]+ = label;icon
ws-icon-0 = 1;♚
ws-icon-1 = 2;♛
ws-icon-2 = 3;♜
ws-icon-3 = 4;♝
ws-icon-4 = 5;♞
ws-icon-default = ♟

; Available tags:
;   <label-state> (default) - gets replaced with <label-(focused|unfocused|visible|urgent)>
;format = <label-state>

; Available tokens:
;   %name%
;   %icon%
;   %index%
;   %output%
; Default: %icon%  %name%
label-focused = %icon%
label-focused-foreground = #ffffff
label-focused-background = #3f3f3f
label-focused-underline = #fba922
label-focused-padding = 4

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-unfocused = %icon%
label-unfocused-padding = 4

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-visible = %icon%
label-visible-underline = #555555
label-visible-padding = 4

; Available tokens:
;   %name%
;   %icon%
;   %index%
; Default: %icon%  %name%
label-urgent = %icon%
label-urgent-foreground = #000000
label-urgent-background = #bd2c40
label-urgent-padding = 4

Module internal/memory

[module/memory]
type = internal/memory

; Seconds to sleep between updates
;interval = 1.0

Extra formatting (example)

; Available tags:
;   <label> (default)
;   <bar-used>
;   <bar-free>
format = <label> <bar-used>

; Available tokens:
;   %percentage_used% (default)
;   %percentage_free%
;   %gb_used%
;   %gb_free%
;   %gb_total%
;   %mb_used%
;   %mb_free%
;   %mb_total%
label = RAM %percentage_used%

bar-used-width = 50
bar-used-foreground-0 = #55aa55
bar-used-foreground-1 = #557755
bar-used-foreground-2 = #f5a70a
bar-used-foreground-3 = #ff5555
bar-used-fill = ▐
bar-used-empty = ▐
bar-used-empty-foreground = #444444

Module internal/mpd

[module/mpd]
type = internal/mpd

host = 127.0.0.1
port = 6600
password = secretpassword1

; Seconds to sleep between progressbar/song timer sync
;interval = 0.5

Extra formatting (example)

; Available tags:
;   <label-song> (default)
;   <label-time>
;   <bar-progress>
;   <toggle> - gets replaced with <icon-(pause|play)>
;   <icon-random>
;   <icon-repeat>
;   <icon-repeatone>
;   <icon-prev>
;   <icon-stop>
;   <icon-play>
;   <icon-pause>
;   <icon-next>
;   <icon-seekb>
;   <icon-seekf>
format-online = <icon-prev> <icon-seekb> <icon-stop> <toggle> <icon-seekf> <icon-next>  <icon-repeat> <icon-random>  <bar-progress> <label-time>  <label-song>

; Available tags:
;   <label-offline>
;format-offline = <label-offline>

; Available tokens:
;   %artist%
;   %album%
;   %title%
; Default: %artist% - %title%
;label-song = 𝄞 %artist% - %title%

; Available tokens:
;   %elapsed%
;   %total%
; Default: %elapsed% / %total%
;label-time = %elapsed% / %total%

; Available tokens:
;   None
label-offline = 🎜 mpd is offline

icon-play = ⏵
icon-pause = ⏸
icon-stop = ⏹
icon-prev = ⏮
icon-next = ⏭
icon-seekb = ⏪
icon-seekf = ⏩
icon-random = 🔀
icon-repeat = 🔁
;icon-repeatone = 🔂

; Used to display the state of random/repeat/repeatone
toggle-on-foreground = #ff
toggle-off-foreground = #55

bar-progress-width = 45
bar-progress-indicator = |
bar-progress-fill = ─
bar-progress-empty = ─

Module internal/network

NOTE: If you use both a wired and a wireless network, just add 2 module definitions. For example:

[module/wired-network]
type = internal/network
interface = eth1

[module/wireless-network]
type = internal/network
interface = wlan1

[module/network]
type = internal/network
interface = wlan1

; Seconds to sleep between updates
interval = 3.0

; Test connectivity every Nth update
; A value of 0 disables the feature
; Recommended minimum value: round(10 / interval)
;   - which would test the connection approx. every 10th sec.
; Default: 0
;ping-interval = 3

; Minimum output width of upload/download rate
; Default: 3
;udspeed-minwidth = 0

Extra formatting (example)

; Available tags:
;   <label-connected> (default)
;   <ramp-signal>
format-connected = <ramp-signal> <label-connected>

; Available tags:
;   <label-disconnected> (default)
format-disconnected = <label-disconnected>

; Available tags:
;   <label-connected> (default)
;   <label-packetloss>
;   <animation-packetloss>
format-packetloss = <animation-packetloss> <label-connected>

; Available tokens:
;   %ifname%    [wireless+wired]
;   %local_ip%  [wireless+wired]
;   %essid%     [wireless]
;   %signal%    [wireless]
;   %upspeed%   [wireless+wired]
;   %downspeed% [wireless+wired]
;   %linkspeed% [wired]
; Default: %ifname% %local_ip%
label-connected = %essid% %downspeed%
label-connected-foreground = #eefafafa

; Available tokens:
;   %ifname%    [wireless+wired]
; Default: (none)
label-disconnected = not connected
label-disconnected-foreground = #66ffffff

; Available tokens:
;   %ifname%    [wireless+wired]
;   %local_ip%  [wireless+wired]
;   %essid%     [wireless]
;   %signal%    [wireless]
;   %linkspeed% [wired]
; Default: (none)
;label-packetloss = %essid%
;label-packetloss-foreground = #eefafafa

ramp-signal-0 = 😱
ramp-signal-1 = 😠
ramp-signal-2 = 😒
ramp-signal-3 = 😊
ramp-signal-4 = 😃
ramp-signal-5 = 😈

animation-packetloss-0 = ⚠
animation-packetloss-0-foreground = #ffa64c
animation-packetloss-1 = 📶
animation-packetloss-1-foreground = #000000
; Framerate in milliseconds
animation-packetloss-framerate = 500

Module internal/volume

TODO: Add custom format for when the headphones are plugged in.

[module/volume]
type = internal/volume
;master-mixer = Master

; Use the following command to list available mixer controls:
; $ amixer scontrols | sed -nr "s/.*'([[:alnum:]]+)'.*/\1/p"
speaker-mixer = Speaker
headphone-mixer = Headphone

; NOTE: This is required if headphone_mixer is defined
; Use the following command to list available device controls
; $ amixer controls | sed -r "/CARD/\!d; s/.*=([0-9]+).*name='([^']+)'.*/printf '%3.0f: %s\n' '\1' '\2'/e" | sort
headphone-id = 9

Extra formatting (example)

; Available tags:
;   <label-volume> (default)
;   <ramp-volume>
;   <bar-volume>
format-volume = <ramp-volume> <label-volume>

; Available tags:
;   <label-muted> (default)
;   <ramp-volume>
;   <bar-volume>
;format-muted = <label-muted>

; Available tokens:
;   %percentage% (default)
;label-volume = %percentage%

; Available tokens:
;   %percentage% (default)
label-muted = 🔇 muted
label-muted-foreground = #66

ramp-volume-0 = 🔈
ramp-volume-1 = 🔉
ramp-volume-2 = 🔊

; If defined, it will replace <ramp-volume> when
; headphones are plugged in to `headphone_control_numid`
; If undefined, <ramp-volume> will be used for both
ramp-headphones-0 = 
ramp-headphones-1 = 

Module custom/menu

[module/menu-apps]
type = custom/menu

; "menu-LEVEL-N" has the same properties as "label-NAME" with
; the additional "exec" property
;
; Available exec commands:
;   menu-open-LEVEL
;   menu-close
; Other commands will be executed using "/usr/bin/env sh -c $COMMAND"

menu-0-0 = Browsers
menu-0-0-exec = menu-open-1
menu-0-0-foreground = #fba922
menu-0-2 = Multimedia
menu-0-2-exec = menu-open-3
menu-0-2-foreground = #fba922

menu-1-0 = Firefox
menu-1-0-exec = firefox &
menu-1-0-foreground = #fba922
menu-1-1 = Chromium
menu-1-1-exec = chromium &
menu-1-1-foreground = #fba922

menu-2-0 = Gimp
menu-2-0-foreground = #fba922
menu-2-0-exec = gimp &
menu-2-1 = Scrot
menu-2-1-exec = scrot &
menu-2-1-foreground = #fba922

Extra formatting (example)

; Available tags:
;   <label-toggle> (default) - gets replaced with <label-(open|close)>
;   <menu> (default)
;format = <label-toggle> <menu>

label-open = Apps
label-close = x

; Optional item separator
; Default: none
label-separator = |

Module custom/script

[module/pkgupdates-available]
type = custom/script

; Available tokens:
;   %counter%
; The "exec" command will be executed using "/usr/bin/env sh -c [command]"
exec = count=$(sudo pacman -Syup --noprogressbar 2>/dev/null | sed '/Starting full/,~1!d;/Starting full/d' | wc -l); [ $count -gt 0 ] && echo "Updates available: $count"
;exec = count=$(echo n | sudo xbps-install -Su >/dev/null 2>&1; sudo xbps-install -Sun | wc -l); [ $count -gt 0 ] && echo "Updates available: $count"

; Should we keep listening for output from the command?
;tail = false

; Seconds to sleep between updates
; Will be ignored if `tail = true`
; Default: 1
interval = 90

; Limit the length of the output string
; Default: 0
maxlen = 20

; Add trailing ellipsis when truncating the string
; Default: true
ellipsis = true

Extra formatting (example)

; Available tags:
;   <output> (default)
;format = <output>
format-background = #999
format-foreground = #000
format-padding = 4

; Available tokens:
;   %counter%
;
; "click-(left|middle|right)" will be executed using "/usr/bin/env sh -c [command]"
click-left = echo left %counter%
click-middle = echo middle %counter%
click-right = echo right %counter%

; Available tokens:
;   %counter%
;
; "scroll-(up|down)" will be executed using "/usr/bin/env sh -c [command]"
scroll-up = echo scroll up %counter%
scroll-down = echo scroll down %counter%

Useful example

Show title of the currently focused window.

[module/xtitle]
type = custom/script
exec = xtitle -s
tail = true
maxlen = 25

Module custom/text

[module/my-text-label]
type = custom/text
content = Some random label

Extra formatting (example)

; "content" has the same properties as "format-NAME"
content-background = #000
content-foreground = #fff
content-padding = 4

; "click-(left|middle|right)" will be executed using "/usr/bin/env sh -c $COMMAND"
click-left = echo left
click-middle = echo middle
click-right = echo right

; "scroll-(up|down)" will be executed using "/usr/bin/env sh -c $COMMAND"
scroll-up = echo scroll up
scroll-down = echo scroll down

Example configurations

...coming soon...

Do you have a nice config that you would like to contribute? Send me a message and we'll get it up here.

License

Lemonbuddy is licensed under the MIT license. See LICENSE for more information.