Skip to main content

​
Prerequisites

Before installing WeakAuras, ensure you have:
World of Warcraft: Wrath of the Lich King (3.3.5a) installed
Access to your WoW installation directory
Ability to extract ZIP archives
WeakAuras is compatible with all WotLK 3.3.5a clients, including popular private server distributions.

​
Installation Methods

Choose your preferred installation method:

​
Addon Components

WeakAuras consists of multiple addon components:

WeakAuras (Core)

Required - The main addon containing all core functionality.File: WeakAuras.toc
WeakAuras.toc
## Interface: 30300
## Title: WeakAuras
## Author: The WeakAuras Team
## Version: 5.21.2
## Notes: A powerful, comprehensive utility for displaying graphics
##        and information based on buffs, debuffs, and other triggers.
This component includes:
  • Core engine and display system
  • Trigger system (buffs, cooldowns, combat events)
  • Region types (icons, bars, text, models)
  • Animation and condition systems
  • Performance optimizations
Required - The configuration interface.Provides the powerful GUI for:
  • Creating and editing auras
  • Managing groups
  • Importing/exporting
  • Trigger configuration
  • Display customization
This addon is loaded on demand when you type /wa
Required - Model file path database.Contains paths to WoW model files for:
  • 3D model displays
  • Model selection in the configuration UI
  • Custom model animations
Required - Pre-made aura templates.Includes templates for:
  • Class abilities
  • Common buffs/debuffs
  • Cooldown tracking
  • Resource monitoring
Templates are a great starting point for creating your own auras!
Optional - Wago.io integration.Enables:
  • Automatic aura updates from Wago.io
  • One-click imports
  • Version checking
Automatically enabled by WeakAuras. Works with the WeakAuras Companion App.
Optional - Aura storage and backup.Provides:
  • Local aura storage
  • Version history
  • Backup functionality
Automatically enabled by WeakAuras.

​
Dependencies & Optional Addons

WeakAuras has several optional dependencies that enhance functionality:

​
Included Libraries

These libraries are embedded in WeakAuras:
  • LibStub: Library management
  • CallbackHandler-1.0: Event handling
  • AceTimer-3.0: Timer management
  • AceSerializer-3.0: Data serialization
  • AceComm-3.0: Network communication

SharedMedia

Adds more bar textures and fonts (retail version)Alternative: bKader Shared Media (popular WotLK version)

SharedMediaAdditionalFonts

Expands available font library for text displays

WeakAuras_StopMotion

Adds stop motion animation region type

ColorPickerAdvanced

Enhanced color picker with class templates and copy/pasteDownload from Google Drive

MerfinPlus

Predefined TTS, sounds, status bars, fonts and moreDownload from Google Drive
Industry-standard boss mod for WotLK raids and dungeons.Integration Features:
  • Boss ability timers as triggers
  • Phase change detection
  • Raid warning integration
Requires DBM-Core with revision >= 20250929200404

​
Post-Installation Setup

​
First Launch

1

Open WeakAuras

Type /wa or /weakauras in chat, or click the minimap icon
2

Configure Settings

Click the Options button (gear icon) to configure:
  • Frame strata
  • Tooltip behavior
  • Minimap icon position
  • Update checking
3

Test Installation

Create a simple test aura:
  1. Click New
  2. Select Icon type
  3. Choose Status > Health
  4. Click Done
You should see an icon appear showing your health status!

​
Minimap Icon

The WeakAuras minimap icon provides quick access:
  • Left-click: Open configuration window
  • Right-click: Quick options menu
  • Drag: Reposition around minimap
You can hide the minimap icon in the WeakAuras options if you prefer using /wa command.

​
Troubleshooting

Possible causes:
  • Folders not in correct location
  • TOC file missing or corrupted
  • Wrong WoW version
Solutions:
  1. Verify folders are in Interface\AddOns (not in a subfolder)
  2. Check that WeakAuras.toc exists in the WeakAuras folder
  3. Ensure you’re running WotLK 3.3.5a (Interface: 30300)
Possible causes:
  • Incomplete installation
  • Corrupted download
  • Conflicting addon
Solutions:
  1. Re-download and extract the full archive
  2. Ensure all WeakAuras folders are present
  3. Disable other addons temporarily to test
  4. Check the in-game error message for specific library name
Possible causes:
  • WeakAurasOptions not installed
  • Lua error preventing load
Solutions:
  1. Verify WeakAurasOptions folder exists
  2. Check for Lua errors (install BugSack addon to view)
  3. Try /reload to refresh the UI
Possible causes:
  • Too many active displays
  • Inefficient custom triggers
  • Memory limitations
Solutions:
  1. Use load conditions to limit when auras are active
  2. Apply the Large Address Aware patch
  3. Review custom code for performance issues
  4. Disable unnecessary auras
If you encounter errors about missing libraries like LibStub, LibSharedMedia-3.0, or others, ensure you’ve copied all folders from the download, not just the WeakAuras folder.

​
Updating WeakAuras

To update to a newer version:
1

Backup Your Auras

Your auras are saved in WTF\Account\[AccountName]\SavedVariables\WeakAuras.luaMake a backup copy before updating!
2

Download New Version

Download the latest release from GitHub
3

Replace Folders

Delete old WeakAuras folders and install new ones following the installation steps
4

Test In-Game

Launch WoW and verify all auras work correctly
WeakAuras automatically handles data migration when updating. Your saved auras will be preserved.

​
Next Steps

Now that WeakAuras is installed, you’re ready to start creating auras!

Quick Start Guide

Create your first aura in minutes

Client Extensions

Enhance performance and unlock features
Join the Discord community for help with installation issues or general support!

Build docs developers (and LLMs) love

Get started for freeTalk to us