amipkg - install, update and remove software on your Amiga
==========================================================
amipkg is a package manager for classic AmigaOS 3.x - think "apt/Homebrew
for your Amiga". It installs, updates and removes software from
a curated catalog of 200+ freely-distributable classics and tools (players,
commodities, internet apps, dev tools, games), resolved and downloaded
straight on your Amiga.
FEATURES
* Curated, CRYPTOGRAPHICALLY SIGNED catalog: the index is Ed25519-signed
offline and verified on your Amiga; every download is checked against a
SHA-256 pinned in that signed catalog. A tampered index or archive is
refused. No other Amiga tool does this.
* Dependency resolution: installs what a package needs first, picking the
right CPU build for your machine (68000..68060 via AttnFlags).
* Clean removal: a receipt database records every file and boot-script
change; `amipkg remove` deletes only what it installed and strips its
User-Startup blocks. `amipkg doctor` audits your installs.
* Three front-ends, one logic: a fast CLI (list/avail/info/install/
upgrade/remove/update/doctor, DRYRUN preview), a zero-dependency
GadTools GUI, and a MUI GUI (3.8+) - browse, search, category filter,
newest-first, one-click install with live progress, Run and Adopt.
* MULTIPLE REPOSITORIES: install from the curated catalog, from your
club's, or from your own. A repository is two static files on any web
server; sign yours and your users get the same on-Amiga verification the
official one gets. Order decides which repo wins a package, and
`repo:package` asks a specific one. See HOSTING.md in the source repo.
* Self-updating: `amipkg upgrade amipkg`.
* Runs on a stock 68000 with AmigaOS 3.0+; guaranteed 128 KB stack via
StackSwap regardless of your Shell settings.
REQUIREMENTS
* AmigaOS 3.0+ (GadTools); C:lha (standard on almost every system)
* A TCP/IP stack with bsdsocket.library for downloads only - Roadshow,
AmiTCP, Miami, or an emulator's built-in bsdsocket. Browsing the bundled
catalog works offline.
* Optional: AmiSSL 5.x enables downloads from https-only hosts (GitHub);
everything on Aminet works without it.
INSTALL
Extract into a drawer of your choice - amipkg LIVES in that drawer (like
MUI:), with the signed catalog seeded for offline browsing. Double-click
"Install" (self-contained: nothing outside the drawer is ever touched;
uninstall = delete the drawer) or "Install-System" (additionally adds the
AMIPKG: assign + Shell path to S:User-Startup as one marked block).
QUICK START
amipkg avail mod ; search the catalog
amipkg install hippoplayer
amipkg check ; anything outdated?
amipkg upgrade ; update everything
Package submissions are pull requests (pure Python tooling, no Amiga or Mac
needed) reviewed and signed by a maintainer - Homebrew-style:
https://github.com/thomas-luebker/amiga-pkg
amipkg is part of the Amiga Imager project (https://amiga-imager.com) but
runs on ANY AmigaOS 3.x system - no Amiga Imager required.
|