<div align="center">

# WeakAuras

[![Build Status](https://github.com/WeakAuras/WeakAuras2/workflows/CI/badge.svg)](https://github.com/WeakAuras/WeakAuras2/actions?workflow=CI)
[![WeakAuras on Discord](https://img.shields.io/badge/discord-weakauras-738bd7.svg?style=flat)](https://discord.gg/weakauras) [![Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/weakauras)

![Logo](https://i.imgur.com/wwbxeCG.jpeg)
</div>

WeakAuras is a powerful and flexible framework that allows the display of highly customizable graphics on World of Warcraft's user interface to indicate buffs, debuffs, and other relevant information. This addon was created to be a lightweight replacement for Power Auras but has since introduced more functionalities while remaining efficient and easy to use.

## Features

* An intuitive and powerful configuration interface
* Custom textures including all textures from Power Auras and Blizzard's spell alerts
* Progress bars and textures that show the exact duration of auras
* Displays based on auras, health, power (mana, rage, soul shards, holy power, etc.), cooldowns, combat events, runes, totems, items, and many other triggers
* Preset and user-defined animations
* Custom side-effects such as chat announcements or sounds
* Grouping, which allows multiple displays to be positioned and configured at the same time
* CPU optimizations such as conditional loading/unloading of displays, modularity, and prevention of full aura scanning
* Powerful customization options, such as animation paths, on-show/on-hide code, and custom triggers, for Lua-savvy users

## Quick Start

To open the options window, type `/wa` or `/weakauras` into your chat and hit enter or use the minimap icon.

## Extensions

* [WeakAuras Companion](https://weakauras.wtf): This application adds the missing link between Wago.io and the World of Warcraft addon, enabling you to update your auras in a convenient fashion.
* [WeakAuras_StopMotion](https://www.curseforge.com/wow/addons/weakauras-stop-motion): This addon adds a new region type to WeakAuras that allows for stop motion animations. Stop Motion textures contain each frame of the animation as a separate image. The addon ships with a number of animations and it supports custom textures.
* [SharedMedia](https://www.curseforge.com/wow/addons/sharedmedia) for more bar textures.
* [SharedMediaAdditionalFonts](https://www.curseforge.com/wow/addons/shared-media-additional-fonts) for more fonts.
* [ColorPickerPlus](https://www.curseforge.com/wow/addons/colorpickerplus) for a better version of the WoW color picker that includes class color templates and a copy and paste function.

## Documentation

For in-depth documentation, see the [wiki](https://github.com/WeakAuras/WeakAuras2/wiki) page.

## Examples

For some examples of what WeakAuras can do, take a look at [wago.io](https://wago.io/) where tons of people upload their creations and even feature complete interfaces utilizing WeakAuras!

## Problems

* Please see the [wiki](https://github.com/WeakAuras/WeakAuras2/wiki) page.
* If you've discovered something that's clearly wrong, or if you get an error, please create a [ticket](https://github.com/WeakAuras/WeakAuras2/issues).
* You're a programmer yourself and want to contribute? Check out our [contributing guidelines](CONTRIBUTING.md) to get started!
* Feel free to join our [Discord Community](https://discord.gg/weakauras) to talk, get help and discuss everything WeakAuras!

## Support

If you want to help out with development without providing code yourself, you can always donate to the WeakAuras project maintainers using PayPal or become a Patreon:

[![WeakAuras on PayPal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FRVH7EYXFDTUN)  [![Become a Patreon!](https://c5.patreon.com/external/logo/become_a_patron_button.png)](https://www.patreon.com/bePatron?u=3216523)
