Skip to main content
WeakAuras Companion is a desktop application that bridges the gap between Wago.io and your in-game WeakAuras, enabling easy updates and management of your aura collection.

​
Overview

WeakAuras Companion provides:

Automatic Updates

One-click updates for all your Wago.io auras

Update Notifications

Alerts when new versions are available

Bulk Operations

Install and update multiple auras at once

Collection Management

Organize and track your imported auras

​
Installation

​
Download

1

Visit WeakAuras.wtf

Go to https://weakauras.wtf
2

Download for Your OS

Available for:
  • Windows (exe installer)
  • macOS (dmg)
  • Linux (AppImage)
3

Install the Application

Run the installer and follow the setup wizard
4

Configure WoW Path

Point the app to your WoW installation directory:
C:\Program Files (x86)\World of Warcraft\_classic_

​
First-Time Setup

When you first launch the Companion app:
  1. Select Game Version: Choose “Wrath of the Lich King (3.3.5)”
  2. Choose Account: Select your WoW account folder
  3. Scan Auras: The app will scan your existing WeakAuras
  4. Link Wago.io (Optional): Connect your Wago account for personalized collections
The Companion app works without a Wago.io account, but linking provides additional features like saved collections.

​
Using the Companion

​
Main Interface

The Companion app has several key sections:
Shows auras with available updates:
  • Aura Name: The name of your installed aura
  • Current Version: Your installed version
  • Latest Version: Available version on Wago.io
  • Changelog: What’s new in the update
  • Actions: Update individual or update all
Update Process:
  1. Click “Update” next to an aura
  2. Review the changelog
  3. Confirm the update
  4. The app modifies your SavedVariables
  5. Reload WoW to see changes

​
Updating Auras

1

Check for Updates

Click “Check for Updates” or wait for automatic check
2

Review Available Updates

The Updates tab shows auras with new versions
3

Update Selected

  • Update individual auras: Click “Update” next to the aura
  • Update all: Click “Update All” at the top
4

Reload WoW

Type /reload in-game to load the updated auras
Before Updating:
  • Exit World of Warcraft (or at least be at character select)
  • The Companion modifies SavedVariables files
  • Updates overwrite your local customizations

​
Installing New Auras

1

Browse Wago.io

Use the Browse tab or visit wago.io directly
2

Find an Aura

Search for auras by:
  • Class/Spec
  • Content type (raid, PvP, leveling)
  • Specific bosses or features
3

Install

Via Companion App:
  • Click “Install” in the Browse tab
Via Wago.io:
  • Click “Install with Companion” button on the aura page
4

Load In-Game

/reload in WoW to load the new aura

​
Features

​
Automatic Update Checks

The Companion automatically checks for updates:
  • Default: Every 4 hours while running
  • Configurable: Change in Settings
  • Manual: Click “Check for Updates”

​
Backup & Restore

The app can backup your WeakAuras: 
Settings -> Backup
- Create backup before updates: [x]
- Backup location: C:\Users\...\WeakAurasBackup
- Manual backup: Click "Create Backup Now"
Restore from backup:
  1. Settings -> Backup
  2. Click “Restore from Backup”
  3. Select backup date
  4. Confirm restoration

​
Version History

View past versions of auras:
  1. Click an aura in the Installed tab
  2. Click “Version History”
  3. See all previous versions
  4. Downgrade to older version if needed

​
Collections

Link your Wago.io account to:
  • Save favorite auras
  • Create custom collections
  • Share collections with others
  • Quick-install entire collections

​
How It Works

​
Technical Details

The Companion app:
  1. Scans SavedVariables: Reads WeakAurasSaved.lua to find installed auras
  2. Identifies Wago Auras: Matches UIDs to Wago.io entries
  3. Fetches Updates: Queries Wago.io API for new versions
  4. Modifies SavedVariables: Updates the Lua file with new aura data
  5. Preserves Settings: Keeps your position/size customizations when possible

​
File Locations

WeakAuras SavedVariables: 
World of Warcraft\_classic_\WTF\Account\ACCOUNT_NAME\SavedVariables\WeakAuras.lua
Companion Data: 
Windows: %APPDATA%\weakauras-companion
macOS: ~/Library/Application Support/weakauras-companion  
Linux: ~/.config/weakauras-companion

​
Troubleshooting

Solution:
  1. Settings -> WoW Path
  2. Browse to your WoW folder:
    • Windows: C:\Program Files (x86)\World of Warcraft\_classic_
    • macOS: /Applications/World of Warcraft/_classic_
  3. Ensure _classic_ folder is selected (for WotLK)
Possible Causes:
  • Wrong account folder selected
  • WeakAuras not installed in-game
  • No auras from Wago.io installed
Solution:
  1. Verify account selection in Settings
  2. Install at least one aura from Wago.io manually
  3. Rescan in the Companion app
Solution:
  • Make sure WoW is closed or at character select when updating
  • Type /reload after Companion finishes updating
  • Check if update actually completed (green checkmark in Companion)
Cause: WoW is running with a character loadedSolution:
  • Log out to character select before updating
  • Or close WoW completely
  • The Companion needs write access to SavedVariables
Why: Updates overwrite aura data completelySolution:
  • Make a copy of customized auras (export string)
  • Unlink from Wago.io to prevent auto-updates
  • Or manually merge changes after updating

​
Best Practices

Regular Updates

Check for updates weekly, especially before raid nights

Review Changelogs

Read what changed before updating, especially for major updates

Backup Before Updates

Enable automatic backups in Settings

Test After Updating

Test updated auras before important content

Close WoW for Updates

Exit to character select or close WoW before updating

Keep Companion Running

Leave it running in the background for automatic update checks

​
Advanced Usage

​
Command Line Interface

The Companion supports CLI for automation: 
# Check for updates
weakauras-companion check

# Update all auras
weakauras-companion update --all

# Install specific aura by Wago ID
weakauras-companion install <wago-id>

# Export installed auras list
weakauras-companion list --export auras.json

​
Batch Installation

Install multiple auras from a list:
  1. Create a text file with Wago IDs (one per line)
  2. Use the import feature in Companion
  3. Click “Install All”
Useful for setting up new characters or fresh installs.

​
Selective Updates

Pause updates for specific auras:
  1. Right-click aura in Installed tab
  2. Select “Ignore Updates”
  3. Manual updates still available
Useful for heavily customized auras.

​
Integration with Wago.io

​
Linking Your Account

1

Create Wago Account

Sign up at wago.io
2

Get API Key

Account Settings -> API Key
3

Link in Companion

Settings -> Wago.io -> Enter API Key
4

Sync Collections

Your favorites and collections now sync

​
Benefits of Linking

  • Saved Collections: Access your curated aura lists
  • Favorites Sync: Star auras on Wago.io, install via Companion
  • Upload Support: Upload auras directly from Companion
  • Private Auras: Access your private/unlisted uploads

​
Alternatives

If the Companion app doesn’t work for you:
  1. Copy import string from Wago.io
  2. /wa in-game
  3. Click Import
  4. Paste string
Pros: No external app needed Cons: Manual process, no auto-updates

​
Support & Resources

Website

Download and documentation

GitHub

Source code and issues

Discord

Community support

​
Next Steps

Import/Export

Learn about manual import/export

Creating Auras

Create your own auras

Wago.io

Browse aura collections

Build docs developers (and LLMs) love

Get started for freeTalk to us