Package: instawow
instawowis an add-on manager for World of Warcraft.
It can be used to install, update and remove add-ons from GitHub,
CurseForge, WoWInterface and Tukui.instawowhas an interoperable CLI and GUI, fuzzy search with download scoring
and several other goodies.InstallationYou can downloadpre-built binariesofinstawowfrom GitHub.binusers can install the CLI binaries by running:bin install github.com/layday/instawowIf you’d prefer to installinstawowfrom source, you are able to choose from:pipx:pipx install instawoworpipx install instawow[gui]for the GUIVanilla pip:python-mpip install-Uinstawoworpython-mpip install-Uinstawow[gui]for the GUINix or NixOS: the CLI-only version ofinstawowis available as theinstawowpackage.CLI operationtl;drBegin by runninginstawow reconcileto register previously-installed add-ons withinstawow(orinstawow reconcile--autoto do the same without user input).
To install add-ons, you can search for them using thesearchcommand:instawow search molinariIn addition,instawowis able to interpret add-on URLs andinstawow-specific
URIs of slugs and host IDs.
All of the following will install Molinari:instawow install https://www.curseforge.com/wow/addons/molinari
instawow install curse:molinari
instawow install curse:20338
instawow install https://github.com/p3lim-wow/Molinari
instawow install github:p3lim-wow/molinariYou canupdateadd-ons andremovethem just as you’d install them.
Ifupdateis invoked without arguments, it will update all of your
installed add-ons.  You canlistadd-ons and view detailed information about
them usinglist--formatdetailed.
Forlistand similarly non-destructive commands, the source can be omitted
and the alias can be shortened, e.g.instawow reveal moliwill bring up the Molinari add-on folder in your file manager.Add-on reconciliationAdd-on reconciliation is not automatic –instawowmakes a point
of not automatically assuming ownership of your add-ons.
However, you can automate reconciliation withreconcile--autoandinstawowwill prioritise add-ons from CurseForge.
Reconciled add-ons are reinstalled because the installed version cannot be
extracted reliably.Add-on searchinstawowcomes with a rudimentarysearchcommand
with results ranked based on edit distance and popularity.
Search uses a collated add-on catalogue which is updatedonce daily.
You can install multiple add-ons directly from search.Install strategiesAdd-ons take a number of options which determine how they are resolved:any_flavourto ignore game version compatibilityany_release_typeto ignore add-on stabilityversion_eq=[VERSION]to install a specific add-on versionIn the CLI, you can pass strategies in the fragment portion of the add-on URI,
separated by a comma, e.g.instawow install curse:molinari#any_release_type,any_flavour.
Strategies are respected byinstallandupdate--retain-strategies.Reverting add-on updatesinstawowkeeps a log of all versions of an add-on it has previously
installed.
Add-on updates can be undone using theinstawow rollbackcommand.
Add-ons which have been rolled back are pinned and will not receive updates.
Rollbacks can themselves be undone withinstawow rollback--undo,
which will install the latest version of the specified add-on using
thedefaultstrategy.Profilesinstawowsupports multiple game versions by means of profiles.
Assuming your default profile is configured for retail,
you can create a pristine profile for classic with:instawow -p classic configure“classic” is simply the name of the profile; you will be asked to select
the game flavour that it corresponds to.  You can have several profiles
of the same flavour (think alpha, beta and PTR).-pis a global option. You can prefix anyinstawowcommand with-p.
For instance, to update your Classic add-ons, you would run:instawow -p classic updateYou can omit-pfor the default profile if one exists.Migrating Classic profilesWith the exception of “Classic Era” profiles
(vanilla_classicininstawowparlance), classic profiles will start
receiving updates for the latest Classic release once it is supported byinstawow.  No user intervention is necessary, save for updatinginstawow.WeakAura updaterinstawowcontains a WeakAura updater modelled afterWeakAuras Companion.  To use the updater
and provided that you have WeakAuras installed:instawow weakauras-companion build
instawow install instawow:weakauras-companionYou will have to rebuild the companion add-on prior to updating
to receive aura updates.  If you would like to check for updates on
every invocation ofinstawow update, install theinstawow:weakauras-companion-autoupdatevariant:instawow install instawow:weakauras-companion-autoupdate
instawow updatePlug-insinstawowcan be extended using plug-ins.  Plug-ins can be used to add support
for arbitrary hosts and add new commands to the CLI.  You will find a sample
plug-in intests/plugin.Metadata sourcingCurseForgeCurseForge is set to retire its unauthenticated add-on API by the end of Q1 2022.
CurseForge will be issuing keys for the new API conditionally and which
add-on managers are obligated to conceal.
The new API is therefore unworkable for add-on managers except through a
proxy service, which the author of this particular add-on manager cannot afford.
At the same time, CurseForge will be providing the option for authors to unlist
their add-ons from the new API, and downloads intitiated through the new API
will not count towards author credits for the ad revenue sharing programme.GitHubinstawowsupports WoW add-onsreleasedon GitHub – that is to say that
the repository must have a release (tags won’t work) and the release must
have an add-on ZIP file attached to it as an asset.instawowwill not install or build add-ons directly from
source, or from tarballs or ‘zipballs’, and will not validate
the contents of the ZIP file.TransparencyWeb requests initiated byinstawowcan be identified by its user agent string.Every 24 hours, on launch,instawowwill queryPyPI–
the canonical Python package index – to check forinstawowupdates.ContributingBug reports and fixes are welcome.  Do open an issue before committing to
making any significant changes.Related workThe author ofstrongboxhas been
cataloguing similar software.  If you are unhappy
withinstawow, you might find one of theseotheradd-on managers more
to your liking.