{"id":15719501,"url":"https://github.com/raimue/flaticron","last_synced_at":"2026-02-22T21:46:29.324Z","repository":{"id":230255710,"uuid":"778908327","full_name":"raimue/flaticron","owner":"raimue","description":"flaticron sends mail notifications for pending Flatpak updates.","archived":false,"fork":false,"pushed_at":"2025-02-03T21:39:39.000Z","size":42,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-14T01:09:56.379Z","etag":null,"topics":["automation","bash","flatpak","mail-notification","monitoring","scripts","sysadmin","update-checker"],"latest_commit_sha":null,"homepage":"https://raimue.blog/2024/03/28/flaticron-send-mail-notifications-for-pending-flatpak-updates/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raimue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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":"2024-03-28T16:40:05.000Z","updated_at":"2025-02-03T21:39:43.000Z","dependencies_parsed_at":"2024-10-24T15:29:04.228Z","dependency_job_id":"947b813e-4924-4393-91d9-6bb927b06b4a","html_url":"https://github.com/raimue/flaticron","commit_stats":null,"previous_names":["raimue/flaticron"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raimue%2Fflaticron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raimue%2Fflaticron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raimue%2Fflaticron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raimue%2Fflaticron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raimue","download_url":"https://codeload.github.com/raimue/flaticron/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248804825,"owners_count":21164135,"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":["automation","bash","flatpak","mail-notification","monitoring","scripts","sysadmin","update-checker"],"created_at":"2024-10-03T21:55:55.408Z","updated_at":"2025-10-30T08:42:55.159Z","avatar_url":"https://github.com/raimue.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# flaticron\n\nflaticron sends daily mail reminders about pending updates for applications and runtimes installed by [Flatpak](https://flatpak.org/). It is similar to the tools apticron[^apticron] for apt on Debian and porticron[^porticron] for portage on Gentoo.\n\n# Prerequisites\n\nflaticron uses [mailx(1)](https://manpages.debian.org/testing/bsd-mailx/mailx.1.en.html) and assumes you have setup an MTA such as exim4 or postfix to send mail. The recommended setup is a satellite system with an external smarthost as mail relay.\n\n# Installation\n\n## Debian\n\nDownload the Debian package from the [latest release](https://github.com/raimue/flaticron/releases/) and install it locally:\n\n```\nwget https://github.com/raimue/flaticron/releases/download/v0.1/flaticron_0.1_all.deb\nsudo apt install ./flaticron_0.1_all.deb\n```\n\n## Manual installation from git repository\n\nInstall dependencies:\n```\n# Build dependencies\nsudo apt install git scdoc\n# Runtime dependencies\nsudo apt install flatpak bash\n```\n\nInstall flaticron:\n```\ngit clone https://github.com/raimue/flaticron.git\ncd flaticron\nsudo make install\n```\n\n# Quick start\n\n## System installation\n\nIf you use the recommended system-wide installation, no special setup is necessary. Make sure you receive mail for the user *root* by configuring your address in /etc/aliases accordingly. As an alternative, set the mail address for your user in the config file at `/etc/flaticron/flaticron.conf`.\n\nFor automatic daily update checks, enable the systemd timer in the system-wide installation:\n```\nsudo systemctl enable --now flaticron.timer\n```\n\nFor a manual run, just run the `flaticron` script to send a mail. Alternatively, use the `--stdout` argument on command line to view the report directly in your terminal:\n```\nflaticron --stdout\n```\n\n## User installation\n\nIf you prefer `flatpak --user`, you can configure the email address for your user in the config file in ~/.config/flaticron/flaticron.conf. Otherwise it will be delivered to the local mailbox,\n\n```\nEMAIL=\"you@example.org\"\n```\n\nThen enable the systemd timer unit for your user session:\n```\nsystemctl --user enable --now flaticron.timer\n```\n\n## Additional custom Flatpak installations\n\nIf you are using [custom Flatpak installations](https://docs.flatpak.org/en/latest/tips-and-tricks.html#adding-a-custom-installation) with `flatpak --installation=extra`, you can also enable system-wide systemd timers with template units.\n\nTo enable the systemd timer unit for a custom installation named \"extra\":\n```\nsudo systemctl enable --now flaticron@extra.timer\n```\n\n# Detailed usage\n\nThe systemd timers as provided with flaticron run once a day by default.\nIf you prefer classic cron over systemd, you can also add a manual command to the crontab:\n\n```\nflaticron\n  --config \u003cfile\u003e      Read this additional config file\n  --stdout             Print the report to standard output instead of sending mail\n  --user               Show only pending updates for user installation\n  --system             Show only pending updates for system installation\n  --installation=NAME  Show only pending updates for a non-default system-wide installation\n  --help               Show this help text\n```\n\nBy default, flaticron operates the same as flatpak and reports pending updates for both the system and user installation. If you install applications and runtimes to the Flatpak user installation, simply run the command as your own user. If you use the recommended system-wide installation, you can run the flaticron command from your crontab or use the provided systemd units.\n\nflaticron is configured with builtin defaults, which can be overriden from the following configuration files. They are read in this order, in which later files may override earlier options:\n\n  - /etc/flaticron/flaticron.conf\n  - ${XDG\\_CONFIG\\_HOME}/flaticron/flaticron.conf (by default $HOME/.config/flaticron/flaticron.conf)\n\nLook at the system-wide file for the detailed description of available options.\n\n# Packaging\n\nWhile this repository contains supporting files to package flaticron for Debian, it can also be used on any other distribution. You are welcome to package flaticron for your Linux distribution of choice.\n\n# License\n\nflaticron is published under the same license as the Flatpak framework. See COPYING for the full license text.\n\nSPDX-License-Identifier: LGPL-2.1-or-later\n\n# References\n\n[^apticron]: https://salsa.debian.org/debian/apticron\n[^porticron]: https://github.com/gentoo/porticron\n\n[modeline]: # ( vim: set et sw=2 ts=2 tw=0 wrap: )\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraimue%2Fflaticron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraimue%2Fflaticron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraimue%2Fflaticron/lists"}