TUI/CLI addon updater for World of Warcraft.
The latest release can be found here.
Please be aware that Linux (.gz) and macOS (.zip) versions are not thoroughly tested.
Windows 10+, Ubuntu 20.04+, Debian 11+ and macOS 11+ are supported.
Place CurseBreaker binary inside the directory containing Wow.exe, WowClassic.exe or World of Warcraft.app.
Read the instructions at the top of the screen.
Already installed addons will not be recognized by CurseBreaker, and they need to be reinstalled.
This process can be partially automated by using the import command.
Retail, Mists of Pandaria Classic and Classic clients are supported. The client version is detected automatically.
By default CurseBreaker will create backups of the entire WTF directory.
- TUI will look a lot better if the application is started by something else than the default Windows command prompt. Windows Terminal is recommended.
- Many of the fields are links if used terminal emulator supports them.
- On Windows command
uri_integrationcan be used to enable integration with the Wago Addons and Wago page. - Most of the commands support the space-separated list of addons.
installcommand has an optional-iflag that can be used to disable the client version check.- Environment variable
CURSEBREAKER_PATHcan be used to set the custom location of WoW client. - The application can be run in non-interactive mode by providing commands directly as a parameter.
- When the application is started with a
headlessparameter entire addon and Wago upgrade process plus WTF backup should be executed in the background. Log file CurseBreaker.html will be created in the same directory as the application.
- Wago Addons:
https://addons.wago.io/addons/[addon_name],wa:[addon_name] - WoWInterface:
https://www.wowinterface.com/downloads/[addon_name],wowi:[addon_id] - Tukui:
ElvUI,Tukui - GitHub: Development versions of multiple addons. Slugs are suffixed with
:Dev. - GitHub Releases:
https://github.com/[username]/[repository_name],gh:[username]/[repository_name] - Wago: CurseBreaker can update auras and Plater profiles/scripts like WeakAuras Companion.
To use Wago Addons as addon source user needs to provide a personal API key. It is a paid feature.
The key can be obtained here and needs to be added to the application configuration by using the set wago_addons_api command.
Providing personal access token greatly increase speed of bulk version check and solve possible issues with rate limiting.
Both classic and fine-grained tokens are supported. No additional permissions are required.
Token can be added to application by using the set gh_api command.
CurseBreaker by default will try to update all detected WeakAuras and Plater profiles/scripts. The process works the same as WeakAuras Companion.
All updates will still need to be applied in-game in the WeakAuras/Plater option menu.
Command toggle wago can be used to set a single author name that will be ignored during the update.
Additionally Wago API key can be set with the set wa_api command so non-public entries will also be upgradeable.
- Using WoWInterface projects that provide multiple addon releases (example) will always install a retail version of the addon. It can't be fixed as WoWInterface API doesn't support this type of project.
- Some WoWInterface addon categories (e.g. Compilations, Optional) are not handled by their API. Addons in these categories can't be installed.
- WoWInterface projects that need to install files outside the
Interface\AddOnsdirectory are not supported.
CurseBreaker is a free software/open source and is distributed under the GNU General Public License v3.
Icon made by Nikita Golubev is licensed by CC 3.0 BY.
