A Decky Loader plugin to discover, install and update World of Warcraft addons on a Steam Deck. You do it all from Game Mode, in the Quick Access Menu, without a desktop addon manager or copying folders around.
Built with AI. LLM agents wrote most of this plugin's code.
You need a Steam Deck (SteamOS) with Decky Loader
installed, and World of Warcraft on the device. WoWDeck finds it under
Steam/Proton, Lutris or ~/Applications, on an SD card, or at a custom
path.
-
Open the Quick Access Menu (the
button) → Decky →
Settings → General and turn on Developer mode. Then switch to the Developer tab and, under Third-Party Plugins, pick one of these:
-
Install Plugin from ZIP File → Browse. First download WoWDeck.zip from the latest release, either in Desktop Mode's browser or on any computer, and copy it over. Desktop Mode saves it to
~/Downloads. Browse opens Decky's file picker in your home folder, showing only folders and zip files. OpenDownloadsand pickWoWDeck.zip. -
Install Plugin from URL. Type the short link:
is.gd/wowdeckIt is an is.gd redirect to the long link below, and much easier to type on the Deck's keyboard:
https://github.com/sigboe/wowdeck/releases/latest/download/WoWDeck.zipDecky adds
https://itself if you leave it off.
-
-
Decky now shows its warning for third-party plugins, titled Third-Party Plugin Installation and printed in red on the Deck. It says:
- The Decky Loader team has not reviewed this plugin. It may contain - malware, such as software to steal your Steam account or harm your - device. By installing this plugin, you agree you have assumed all - risks to your device.
Every plugin installed outside the Decky store gets this warning, and Continue stays greyed out for five seconds while you read it. The zip comes from this repository's GitHub Releases.
-
First run: open Decky →
WoWDeck. It finds your WoW installation and flavor (retail, classic, era and so on) or asks you to point at it. Search and installs work without any setup, and you can set your own CurseForge key in Options if you prefer.
Open Get Addons and pick the WoW installation you want to add to. Browse Latest for recently updated addons or Popular for the source's popular picks, or use Search to find an addon by name. The Source picker lets you choose which addon catalog to browse.
Open an addon to read its description, then press
to install it.
Installed addons appear in My Addons, where you can check for updates
and manage them.
If you already have an addon link, choose Manual Install and paste its CurseForge, GitHub or WowInterface URL, or a direct archive link.
The plugin is not in the official Decky store, so updates come from
GitHub Releases. WoWDeck checks about once a day, when the plugin loads
or the Deck wakes. When a newer release is out, you get one toast for
that version, an orange dot on the Options tab, and a panel at
the top of Options with the Update button.
- Update downloads the release and verifies it, then hands it to Decky's own installer. Decky asks you to confirm and reloads the plugin.
- Press
on the Update button, or on the WoWDeck row under Options → Updates, to read what's new before you update.
- Press
on either of them to check again right away.
- The
button on the WoWDeck row picks the update channel. Stable is for most players. Beta is built from every merged change, so it gets new features first and may have bugs.
- By hand. Repeat the Install steps above. The same zip or link installs over the running version.
- Finds WoW in Lutris,
~/Applications,~/Games, Steam Proton prefixes, SD cards and custom paths, and lets you pick the flavor (retail, classic, era and so on). - Lists installed addons, including folders you copied in by hand, and matches them to their source by TOC ids and WowUp fingerprints.
- Finds an online source for a hand-copied folder and manages it from then on. WoWDeck keeps the hand-copied files so you can roll back.
- Searches and installs from CurseForge, WowUp Hub, TukUI, GitHub Releases and WowInterface.
- Installs straight from a CurseForge, GitHub or WowInterface URL, or from an https link to a .zip, .rar or .7z file. The system's 7-Zip or unrar, which SteamOS ships, unpacks RAR and 7z files. Addons installed from such a link have no update source.
- Browses the Popular and Latest lists of CurseForge and WowUp Hub, and CurseForge's categories.
- Detects updates by release id first, then by version. Updates one addon or all of them, in every installation at once if you like. One failed update does not stop the rest.
- Removes addons, or ignores their updates.
- Filters My Addons by name, folder, author or source. It tags libraries (addons installed only because another addon needs them) and can hide them.
- Rolls back an update. WoWDeck keeps the previous version, and Options shows the space those copies use and can clear it.
- Updates addons automatically if you turn it on. It is off by default and never runs while WoW is running.
- Shows waiting addon updates on WoW's game page in the Steam library, with Update all, Check for updates and Open buttons. Link the game in Options first.
- Follows a release channel (Stable, Beta or Alpha) per addon on CurseForge and WowUp Hub.
- Imports and exports addon lists in WowUp's export format.
- Backs up and restores the WTF folder (keybinds, macros, UI layout), or
copies those settings from one WoW version to another, such as Forever
Beta into Forever.
docs/wtf-backup.mdhas the details. - Leaves the previous version in place when an install fails.
- Copies its diagnostics to the clipboard in one tap.
- Logs live at
~/homebrew/logs/wowdeck/on the Deck (engine.logandplugin.log). Options → About → Diagnostics shows versions and recent errors, and Copy puts them on the clipboard. - No WoW installation found. Press Add WoW folder on My Addons
or under Options → WoW installations, then pick the folder that holds
_retail_,_classic_or another flavor folder. - CurseForge errors (403 or 429). Set your own key under Options → CurseForge.
- Options → Updates names a new version but shows no Update panel.
That release has no zip attached yet. Press
on the WoWDeck row to check again later, or update by hand as described above.
- Anything else. Open an issue and include the logs and your SteamOS and Decky versions.
- The plugin contacts addon sources and nothing else: CurseForge
(
api.curseforge.com), WowUp Hub (hub.wowup.io), TukUI (api.tukui.org), GitHub (api.github.com), WowInterface/MMOUI (api.mmoui.com), plus the providers' download servers when you install. - No telemetry, crash reporting or analytics. The only outbound traffic is addon searches, installs and update checks. On top of that, WoWDeck checks for its own new version once a day and, when you update the plugin, downloads it from GitHub Releases.
- WoWDeck Addon Manager is licensed under GPL-3.0.
Third-party notices are in
THIRD_PARTY_NOTICES.md. - Derived from WowUp (GPL-3.0) and
adapted for the Steam Deck independently.
docs/wowup-provenance.mdrecords where each file came from. - Not affiliated with or endorsed by Blizzard Entertainment, the WowUp project, or SteamDeckHomebrew/Deckbrew. "World of Warcraft" and Blizzard Entertainment are trademarks of Blizzard Entertainment, Inc.
- Report bugs and ideas in Issues,
with the logs from
~/homebrew/logs/wowdeck/. Troubleshooting says how to copy them. - PRs target
next.mainequals the newest published release and only receivesnextat release time, so a PR againstmaincannot merge. - Branch off
next, keep commits small and functional with imperative subjects, and expect a merge commit rather than a squash. - A change players can see gets its line in
CHANGELOG.mdin the same commit.docs/changelog.mddescribes the format. - CI runs lint, typecheck, tests and the build on every PR. Development below lists the commands.
WoWDeck has three parts: a TypeScript frontend in the Quick Access Menu, a Python backend that Decky runs, and the addon engine, a standalone binary that the Python backend starts and supervises.
flake.nix lists the dependencies. With Nix, make uses its dev shell
(nix develop). Without Nix, install the same packages from your distro
and add USE_NIX=0:
make setup
make lint typecheck test buildMerging next into main publishes a release, tag included.
docs/development.md describes the whole release flow, and AGENTS.md
holds the project policy.
make build package # -> "build/WoWDeck.zip"The zip keeps the name WoWDeck.zip on purpose. The release workflow
attaches it under that name and WoWDeck's own updater looks for it, so
keep the name when repackaging.
Install it in any of these ways:
- Decky (
button) →
Settings → Developer → Install Plugin from ZIP File.
sudo unzip "build/WoWDeck.zip" -d /home/deck/homebrew/plugins, then restart Decky.python3 tools/package.py --keep-stagealso keeps the unzipped plugin folder,build/wowdeck/. Copy it onto a test device file by file, or into~/homebrew/dev/plugins/wowdeckto iterate in dev mode.
The engine binary is self-contained. Plugin data lives in
~/homebrew/data/wowdeck/state.json. WoWDeck changes addon folders only
inside the selected installation's Interface/AddOns.
GPL-3.0. See LICENSE and THIRD_PARTY_NOTICES.md.