Expand description
Declarative AppImage manager.
fp-appimage-updater keeps a set of AppImages current from a tree of YAML
recipes, without root, without a GUI, and without a database. You describe
each application and where its updates come from; the tool resolves versions,
downloads what is newer, and integrates the result into your desktop menu,
icons and PATH.
§Getting started
# Write the global config
fp-appimage-updater init --global
# Scaffold a recipe for an app published as a GitHub release
fp-appimage-updater init --app hydra-launcher --strategy forge
# Confirm the recipe parses, then see whether anything is newer
fp-appimage-updater validate
fp-appimage-updater check
# Install it
fp-appimage-updater update§How it fits together
cliparses arguments and, more importantly, carries the user-facing documentation for every command in its doc comments.configholds the shapes ofconfig.ymland of an app recipe. The doc comments on its fields are the published configuration reference.parserfinds and reads that YAML;validatorchecks it.resolversdecide what the newest version is: a forge release, a direct URL checked by ETag or Last-Modified, or a script you supply.downloaderfetches it, through a delta path, segmented range requests, or a plain download.integratorextracts the.desktopentry and icon and installs them;disintegratorreverses that.updateorchestrates all of the above concurrently;stateremembers what was installed.
§Where the documentation lives
The command reference is the doc comments in cli; the configuration
reference is the doc comments in config. Those same comments are
rendered as --help, as a man page, and on
docs.rs. There is no separate
documentation tree to drift out of date — see help for how the three
are derived from one source.
Modules§
- cli
- Command-line surface.
- commands
- config
- Configuration types, and the published configuration reference.
- disintegrator
- doctor
- Local health checks, reported by the
doctorcommand. - downloader
- extractor
- help
--helprendering.- initializer
- integrator
- lock
- output
- parser
- resolvers
- self_
updater - state
- update
- validator