waybar-updates

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

Features

Sends (optional) notifications about updates.
Supports GNU gettext localization (contribute new po-files!)
Support for custom formats to show only the numbers you want.
Checks updates from AUR using Aurweb RPC, so works independently.
Can check for development packages upstream changes (see -d options)
Shows updates in the tooltip.
Supports two states: pending-updates and updated to use different icons or hide module.
Uses infinite loop to supply Waybar JSON updates.
Configurable interval between checks.

Installation

Using AUR package waybar-updates.
Manually by using make && make install.

Dependencies

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

Usage

~/.config/waybar/config:

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

...

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

~/.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;
}

You can copy compiled mo-files and use TEXTDOMAINDIR="$HOME/.config/waybar/scripts" in case you want to use localization and don't want to store them in /usr/share/locale.

Command-line options

The following options are available:	Option	Value	Default
`-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 600 cycles* = 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

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 }),

Localization

Supported languages:

English
Russian
French
Turkish

Open po/waybar-updates.pot in poedit or any alternative.
Generate po-file for your language.
Translate!
Submit po-file by opening Pull Request!

Inspired by waybar-module-pacman-updates.

savely-krasovsky / waybar-updates

readme