Skip to main content
Version: Next

Updates

This module provides information about available updates for the system.

To configure this module, you need to specify a command that will check for new system updates and a command that will launch the system updates.

info

Without this configuration, the module will not appear in the status bar.

The module automatically checks for updates on a configurable interval (defaults to once per hour). You can also manually check for updates using the "Check now" button in the menu.

Configuration

FieldDescription
check_cmdCommand that outputs pending updates (one per line).
update_cmdCommand that launches your system updates workflow.
intervalOptional polling interval in seconds (minimum 60, default 3600).

The check command should return a list of updates, one package per line in the following format:

package_name version_from -> version_to

Output Example

calf 0.90.7-1 -> 0.90.8-1
hyprutils 0.8.0-1 -> 0.8.1-1
lazygit 0.52.0-1 -> 0.53.0-1

Example

In this example, I am using an Arch Linux distribution, with paru as my AUR package manager and alacritty as a terminal emulator.

[updates]
check_cmd = "checkupdates; paru -Qua"
update_cmd = 'alacritty -e bash -c "paru; echo Done - Press enter to exit; read" &'
interval = 3600