AddonGet - lightweight command line updater for non-technical people [Mac and Windows]

Von Camellia256 Letztes Update: 22.06.2020 Änderungsprotokoll Patch: 8.3.0

Inhaltsverzeichnis
Wertung:

WARNING:

AddonGet and this guide has not been tested on a Mac yet because this author does not have one. If you want to help me test it, please contact me. You help is very welcome!
AddonGet is still new. Backup your addons folder before you use it, and use it at your own risk.

If you don't know about addons, please read AddOns: How to Install and Maintain by Keldesh first

See ElvUI Addon Guide by Jaydaa for information about ElvUI and Tukui Client

Introduction

Update: Twitch Sells CurseForge to Overwolf

Twitch App is packed with many features not related to WoW. Although it can be configured to focus on WoW addons, I still hear people complaining it as "bloatware". And personally, I agree with them. One should not need such a behemoth when all he/she wants is to install and update WoW addons

The popular ElvUI, which I am one of the many users, is only available from tukui.org or Tukui Client (that does not support Mac yet). If you, like me, use it, then you'll have to either use two clients or resort to manual installations. For me, this is not good user experience

wow-addon-updaterIntroducing AddonGet

Lightweight and not buggy. The script itself takes up less than 40KB

Easy install and guide configuration

Support both Windows 10 and macOS

Support both CurseForge and Tukui

Support automatic installation and update

Support WTF folder backup

List installed addons

Update addons

Install AddonGet1. Check your OS version2. Install dependencies7-zip websiteHomebrewhttps://raw.githubusercontent.com/Homebrew/install/master/install.sh

The first command downloads and runs Homebrew's official installer. The installer will explain what it will do and ask for confirmation. Read it if you want.

The second command updates Homebrew's database so that it knows what can be installed.

The third command installs p7zip, a macOS and Linux port of the popular WIndows program 7-Zip. This program is used by AddonGet to compress and decompress ZIP files.

The last command installs PowerShell 7, Microsoft's newest shell programming language interpreter. AddonGet is written in PowerShell, so it will need this interpreter. Windows PowerShell 5.1 is pre-installed on Windows 10, but not macOS.

3. Download AddonGet

Security WARNING:

NEVER run any script as Admin/root unless you know what you are doing
ONLY download and run PowerShell scripts from trusted sources
ONLY download PowerShell scripts via HTTPS links
If you can, inspect the script before running it

https://raw.githubusercontent.com/camellia256/AddonGet/master/AddonGet.ps1

The first command creates a new folder named "AddonGet" inside your user's home folder, typically "C:/Users/<Your Username>".

The second command downloads AddonGet from its GitHub repository and saves it as a file named "AddonGet.ps1" inside the just created "AddonGet" folder.

The third command changes PowerShell's script execution policy for the current user to "RemoteSigned". This allows you to run PowerShell scripts locally, but any downloaded script have to contain a valid digital signature.

The fourth command creates your PowerShell profile file with any missing parent folder.

The last command adds two lines to your PowerShell profile so that your can use the shorthand "adt" to run "~/AddonGet/AddGet.ps1"

https://raw.githubusercontent.com/camellia256/AddonGet/master/AddonGet.ps1

The first command creates a new folder named "AddonGet" inside your user's home folder, typically "/Users/<Your Username>".

The second command downloads AddonGet from its GitHub repository and saves it as a file named "AddonGet.ps1" inside the just created "AddonGet" folder.

The third command will launch PowerShell 7 (installed from step 2) in your Terminal. You should see that the prompt is changed from "$" to ">"

The fourth command creates your PowerShell profile file with any missing parent folder.

The last command adds two lines to your PowerShell profile so that your can use the shorthand "adt" to run "~/AddonGet/AddGet.ps1"

4. Configure AddonGet

AddonGet will try to detect 7-Zip automatically. If not, a window will pop up asking you to locate it.

AddonGet will try to detect retail WoW automatically. If not, a window will pop up asking you to locate it. If you have no idea where it is, see Keldesh's guide Backing up Important WoW Data and You!

AddonGet will ask you for a backup location. If you plan to backup your WTF folder via AddonGet, in the pop up window select a folder to save backup. Personally, I use a folder in my OneDrive. (If you don't know what is WTF folder, see Keldesh's guide Backing up Important WoW Data and You!) If not, simply press Cancel.

AddonGet will ask you for your retail WoW location. If yours is in the default location, simply press Enter. Else, enter the path. If you have no idea where it is, see Keldesh's guide Backing up Important WoW Data and You!

AddonGet will ask you for a backup location. If you plan to backup your WTF folder via AddonGet, in the pop up window select a folder to save backup. Personally, I use a folder in my OneDrive. (If you don't know what is WTF folder, again see Keldesh's guide Backing up Important WoW Data and You!) If not, simply press Enter.

Use AddonGet

WARNING: before you start using AddonGet, please make sure your addons folder does not contain anything that will be installed via AddonGet. I recommend move everything to another location, and after you have installed everything via AddonGet, move them back while NOT allowing overwriting. This way, anything that isn't managed by AddonGet will remain in place.

Launch PowerShell

For macOS, open Terminal App, type "pwsh" and press Enter. You should see that the prompt is changed from "$" to ">"

For Windows, search "Windows PowerShell" in you start menu and click to run

Supported URLs

CurseForge
This is the same as the addon's project home page "https://www.curseforge.com/wow/addons/<project name>"

https://www.curseforge.com/wow/addons/details
https://www.curseforge.com/wow/addons/deadly-boss-mods

Tukui UIs (for ElvUI and Tukui only)

https://www.tukui.org/download.php?ui=elvui
https://www.tukui.org/download.php?ui=tukui

Tukui Addons
Please note, `https://www.tukui.org/api.php?addon=<project ID>` is tukui.org's public network API, not the addons' project page, which is `https://www.tukui.org/addons.php?id=<porject ID>`

https://www.tukui.org/api.php?addon=3

Install Addons Using URL Fileshttps://www.curseforge.com/wow/addons/detailshttps://www.curseforge.com/wow/addons/deadly-boss-modshttps://www.tukui.org/download.php?ui=elvuihttps://www.curseforge.com/wow/addons/method-dungeon-toolshttps://www.curseforge.com/wow/addons/exorsus-raid-toolshttps://www.curseforge.com/wow/addons/copypastahttps://www.tukui.org/api.php?addon=3Install Addons Using URLshttps://www.curseforge.com/wow/addons/deadly-boss-modshttps://www.tukui.org/download.php?ui=elvuihttps://www.curseforge.com/wow/addons/family-familiar-helperhttps://www.curseforge.com/wow/addons/rematchShow Installed AddonsRemove Addons

CurseForge

adt r deadly-boss-mods details

Tukui addons

adt r 3 -Source Tukui

ElvUI or Tukui

adt r elvui tukui -Source TukuiUI

Update Addons

Update addons that are marked as frequent

adt u

Update all installed addons

adt u -All

Backup WTF foldersExport installed URLsFinal wordsGitHub project pageAbout authorAcknowledgements

Thanks Keldesh for his amazing guides on Addons and Tools

wow-addon-updater is currently maintained by grrttedwards and licensed under GNU GPLv3

Windows PowerShell and PowerShell are developed and copyrighted by Microsoft Corporation

Homebrew is a great package manager for macOS, developed by the Homebrew Project

curl is a command line tool developed by the curl project at https://curl.haxx.se/, distributed with Windows 10 and macOS

7-Zip is a file archiver developed by Igor Pavlov, licensed under GNU LGPL

p7zip is a POSIX port of 7-Zip

Addons installed via AddonGet are hosted by CurseForge.com and tukui.org, created and copyrighted by their authors

AddonGet is developed by this author and licensed under GNU GPLv3

Kommentare

Kommentar von SprosboldJenkins

Style: Very well written and comprehensive guide - was easily able to follow the steps in theory.

Unfortunately the AddonGet.ps1contents show as:

404: Not Found

,
meaning I'm unable to proceed. Your linked Github project is also not found. Is this addon/project still going, or is it not in the repository anymore? I'd be really keen to give it a go.

AddonGet - lightweight command line updater for non-technical people [Mac and Windows]

Beitragen