waybar-updates

Tiny Waybar module to check Arch Linux updates from official repositories, AUR and Flatpak.

Setup

1. Copy the waybar-updates.sh script to your waybar config directory:

   cp waybar-updates.sh ~/.config/waybar/
   chmod +x ~/.config/waybar/waybar-updates.sh
   

2. Update your waybar config to use the script (see Usage).

Dependencies

• pacman-contrib
• curl
• jq
• libnotify
• git (if using --devel option)
• flatpak (if using --flatpak option)

Usage

~/.config/waybar/config:

"modules-left": [
  ...
  "custom/pacman",
  ...
],

...

"custom/pacman": {
  "format": "{icon}{0}",
  "return-type": "json",
  "format-icons": {
    "pending-updates": " ",
    "updated": ""
  },
  "exec": "./waybar-updates.sh"
}

~/.config/waybar/style.css

@keyframes blink-update {
  to {
    background-color: dodgerblue;
  }
}

#custom-pacman {
  animation-timing-function: linear;
  animation-iteration-count: infinite;
  animation-direction: alternate;
}
#custom-pacman.pending-updates {
  animation-name: blink-update;
  animation-duration: 3s;
}

Command-line options

The following options are available:

Option	Value	Default	Description
-f, --format	string	{total}	Custom format used for main output text (see Formatting)
-t, --tooltip	string		Custom tooltip format (see Formatting)
-i, --interval	int	6	Interval (in seconds) between checks
-c, --cycles	int	600	Cycles between online checks (e.g. 6s interval 600cycles* = 3600s = 1h)
-l, --packages-limit	int	10	Maximum number of packages to be shown in notifications and tooltip
-d, --devel	none	off	Also check for upstream changes in development packages
-n, --notify	none	off	Turns on notifications for updates
-k, --kernel	none	off	Enable check running kernel with latest stable version from kernel.org
-p, --flatpak	none	off	Enable Flatpak update check

Formatting

The tooltip and main text formatters can both use "labels" to format their output.

In --tooltip, the {} label will be replaced with the package list. In --format, it's an alias for {total}.

Supported custom count labels are {aur}, {dev}, {pacman} and {total}. These labels support a custom prefix and/or suffix which can be used to define icons, for example {A :aur:\n}, however keep in mind:

• Values must be separated with a colon (:)
• Values may contain newlines and tabs (\n, \r and \t)
• Values cannot contain braces ({ or }),

---

• Forked from waybar-updates
• Inspired by waybar-module-pacman-updates