{"id":18679692,"url":"https://github.com/savely-krasovsky/waybar-updates","last_synced_at":"2025-04-12T03:13:52.928Z","repository":{"id":160780054,"uuid":"635594865","full_name":"savely-krasovsky/waybar-updates","owner":"savely-krasovsky","description":"Tiny Waybar module to check Arch Linux updates from official repositories and AUR.","archived":false,"fork":false,"pushed_at":"2025-04-08T08:24:16.000Z","size":77,"stargazers_count":43,"open_issues_count":4,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-12T03:13:46.685Z","etag":null,"topics":["arch-linux","arch-linux-package","archlinux","aur","i3-status","i3-status-module","pacman","waybar","waybar-module","waybar-scripts"],"latest_commit_sha":null,"homepage":"https://aur.archlinux.org/packages/waybar-updates","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/savely-krasovsky.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-03T03:12:12.000Z","updated_at":"2025-04-08T08:24:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"2ae4aca4-2a9d-4475-a647-8a771ff3acca","html_url":"https://github.com/savely-krasovsky/waybar-updates","commit_stats":null,"previous_names":["savely-krasovsky/waybar-updates"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savely-krasovsky%2Fwaybar-updates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savely-krasovsky%2Fwaybar-updates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savely-krasovsky%2Fwaybar-updates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/savely-krasovsky%2Fwaybar-updates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/savely-krasovsky","download_url":"https://codeload.github.com/savely-krasovsky/waybar-updates/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248510002,"owners_count":21116130,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arch-linux","arch-linux-package","archlinux","aur","i3-status","i3-status-module","pacman","waybar","waybar-module","waybar-scripts"],"created_at":"2024-11-07T09:45:39.749Z","updated_at":"2025-04-12T03:13:52.918Z","avatar_url":"https://github.com/savely-krasovsky.png","language":"Shell","funding_links":[],"categories":["archlinux"],"sub_categories":[],"readme":"# waybar-updates\n\n[![ShellCheck](https://github.com/L11R/waybar-updates/actions/workflows/shellcheck.yml/badge.svg)](https://github.com/L11R/waybar-updates/actions/workflows/shellcheck.yml)\n\nTiny Waybar module to check Arch Linux updates from official repositories and AUR.\n\n## Features\n- Sends (optional) notifications about updates.\n- Supports GNU gettext localization (contribute new po-files!)\n- Support for [custom formats](#formatting) to show only the numbers you want.\n- Checks updates from AUR using Aurweb RPC, so works independently.\n- Can check for development packages upstream changes (see -d [options](#command-line-options))\n- Shows updates in the tooltip.\n- Supports two states: `pending-updates` and `updated` to use different icons or hide module.\n- Uses infinite loop to supply Waybar JSON updates.\n- Configurable interval between checks.\n\n## Installation\n\n1. Using AUR package `waybar-updates`.\n2. Manually by using `make \u0026\u0026 make install`.\n\n## Dependencies\n\n- pacman-contrib\n- gettext\n- curl\n- jq\n- libnotify\n- git (if using `--devel` [option](#command-line-options))\n\n## Usage\n\n`~/.config/waybar/config`:\n\n```json\n\"modules-left\": [\n  ...\n  \"custom/pacman\",\n  ...\n],\n\n...\n\n\"custom/pacman\": {\n  \"format\": \"{icon}{0}\",\n  \"return-type\": \"json\",\n  \"format-icons\": {\n    \"pending-updates\": \" \",\n    \"updated\": \"\"\n  },\n  \"exec-if\": \"which waybar-updates\",\n  \"exec\": \"waybar-updates\"\n}\n```\n\n`~/.config/waybar/style.css`\n\n```css\n@keyframes blink-update {\n\tto {\n\t\tbackground-color: dodgerblue;\n\t}\n}\n\n#custom-pacman {\n\tanimation-timing-function: linear;\n\tanimation-iteration-count: infinite;\n\tanimation-direction: alternate;\n}\n#custom-pacman.pending-updates {\n\tanimation-name: blink-update;\n\tanimation-duration: 3s;\n}\n```\n\nYou can copy compiled mo-files and use `TEXTDOMAINDIR=\"$HOME/.config/waybar/scripts\"` in case you want\nto use localization and don't want to store them in `/usr/share/locale`.\n\n### Command-line options\nThe following options are available:\n| Option | Value | Default | Description |\n|--------|-------|---------|-------------|\n| `-f`, `--format` | `string` | `{total}` | Custom format used for main output text (see [Formatting](#formatting)) |\n| `-t`, `--tooltip` | `string` |  | Custom tooltip format (see [Formatting](#formatting)) |\n| `-i`, `--interval` | `int` | `6` | Interval (in seconds) between checks |\n| `-c`, `--cycles` | `int` | `600` | Cycles between online checks (e.g. 6s *interval* * 600 *cycles* = 3600s = 1h) |\n| `-l`, `--packages-limit` | `int` | `10` | Maximum number of packages to be shown in notifications and tooltip |\n| `-d`, `--devel` | `none` | `off` | Also check for upstream changes in development packages |\n| `-n`, `--notify` | `none` | `off` | Turns on notifications for updates |\n\n#### Formatting\n\nThe tooltip and main text formatters can both use \"labels\" to format their output.\n\nIn `--tooltip`, the `{}` label will be replaced with the package list. In `--format`, it's an alias for `{total}`.\n\nSupported 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:\n* Values **must** be separated with a colon (`:`)\n* Values **may** contain newlines and tabs (`\\n`, `\\r` and `\\t`)\n* Values **cannot** contain braces (`{` or `}`), \n\n\n## Localization\n\nSupported languages:\n\n- English\n- Russian\n- French\n- Turkish\n\n1. Open `po/waybar-updates.pot` in poedit or any alternative.\n2. Generate po-file for your language.\n3. Translate!\n4. Submit po-file by opening Pull Request!\n\n---\n\nInspired by [waybar-module-pacman-updates](https://github.com/coffebar/waybar-module-pacman-updates).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavely-krasovsky%2Fwaybar-updates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsavely-krasovsky%2Fwaybar-updates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsavely-krasovsky%2Fwaybar-updates/lists"}