ButtonTimers 1

ButtonTimers is action buttons with timers attached. The timers can be configured to show a buff/debuff or the cooldown of a spell. The timers are highly configurable, with lots of options to play with.

Important note:

There are a limited number of action slots (1-120). These correspond to 10 bars of 12 buttons each. These are the same 120 slots that every action bar mod has to use (Bartender, PitBull, Blizzard's standard UI, etc.)

Chances are you aren't using all 12 slots on all 10 bars. You can configure ButtonTimers to use any of the 120 action slots you want. Do this with the "First button on bar is.." slider in the bar configuration.

If you don't change the "First button on bar is..", the bars will default to bars 10, 9, 8, 7. Note that bars 7-9 are by default the stance bars, so if your class uses stances you may wish to change it.

Getting Started:

When you first start the mod, you will see 4 bars of 12 buttons each. Open up the options (in the interface->addons panel), and disable the bars you won't be using. Next change the number of buttons from 12 to however many buttons you would like to see.

Now change the action slots the bar is showing you. Just take the action offset slider and slide it until you see some unused action buttons. Then drag the spells/abilities of your choice onto the bar.

The default is to track dots/debuffs/buffs. If that's what you want the timer to reflect, you are done. If you want to see a cooldown instead, select the configuration for the button and change the selector from "Aura" to "Cooldown".

There are lots of configuration options, go ahead and play with them. But that should be enough to get you started.

Bar configuration options are:

  • '''Bar Enabled:''' enable / disable the bar.
  • '''Hide out of combat:''' don't show the bar out of combat.
  • '''Bar Locked:''' lock the bar in position so that it cannot be dragged.
  • '''Orientation:''' horizontal or vertical layout for the buttons on the bar. You can also put the timers on the buttons themselves.
  • '''Timer Location:''' you can select whether you want the bar be on the left or right of the button (in vertical orientation) or above/below the button (in horizontal orientation)
  • '''Button Spacing:''' the space between the buttons on the bar.
  • '''Bar Scale:''' size the whole bar larger or smaller
  • '''Bar Length:''' length of the timer bar
  • '''Button Count:''' number of buttons on the bar (1-12)
  • '''First button on bar is..''' action slot number of the first button on the bar. Blizzard gives 120 action slots, which are traditionally allocated into 10 bars, but this mod gives a finer control over which slots you wish to use. Just slide this control until you find some unused slots.

Button options are:

  • '''Type:''' Set whether you wish to monitor a cooldown or an aura on the default bar target. You can also monitor both aura and cooldown. The cooldown will show up on the button and the aura timer on the bar if you select both.
  • '''Timer Type:''' The timer can either be shown as a percentage of the aura/cooldown duration or in fixed time. For example, if you choose a fixed time with a time of 10s, a full bar will always represent 10 or more seconds. This makes it easier to see which aura/cooldown will complete first, regardless of the spell's length.
    • '''Bar Time:''' This sets the max time displayed on a fixed time timer bar. Any timer durations longer than Bar Time will show as a full bar.
  • '''Show others' spells:''' By default, the timer will only monitor auras on the target if you were the caster of the spell. Click this button if you wish to see other's spells as well. The timer will always show your own spell if you have one on the target. Note: Pet spells do not count as being cast by you, so if you wish to monitor a pet spell then click this button.
  • '''Other Auras:''' By default, an aura timer will monitor the bar's default target for an aura matching the name of the spell on the action button. In this field you can enter additional auras (in a comma separated list) to look for.
    • "Show Aura Icon:" When checked, the icon on the button will update to match the aura we are showing the timer for.
    • "Ignore Button Aura:" When checked, timers will only be created for the auras specified in the Other Auras field. If Show Aura Icon is also checked, then the icon on the button when no timer is present will be the first aura listed in the Other Auras field.
  • '''Cooldown spell:''' By default, a cooldown timer will monitor the cooldown on the action on the bar. But you can also enter a spell name to monitor instead.
  • '''Bar Color:''' The color of the timer bar.
  • '''Target:''' This will select the default target (to target, focus target, self, party, pet) for all actions on the bar. It also controls what target to monitor for auras.
  • '''Use as spell target:''' If set, target will be the spell target as well as the target to monitor for the selected aura.
  • '''Warn less than cast time:''' Change the bar color when timer less than cast time. Also tints the action button.
  • '''Warning Bar Color:''' Bar color for timers when remaining time less than cast time.
    • "Adjust Cast Time:" Additional number of seconds to add, or subtract, from the cast time. Set this value to the effect's duration * 0.3 for the warn color to show when its safe to refresh an effect without wastage.
  • '''Adjust Timer:''' Number of seconds to add to timer (can be negative).

Command line options:

'''/buttontimers reset''' - reset bar positions to default

'''/buttontimers config''' - open the configuration dialog (can also be accessed on Blizzards interface -> addons panel)

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of ogredaviking ogredaviking Jul 20, 2016 at 05:12 UTC - 0 likes

    Will this addon be updated for Legion? Please say yes. :)

  • Avatar of EvilMaddness EvilMaddness Dec 30, 2015 at 06:21 UTC - 0 likes

    Hey Misen & Stencil

    I think ButtonTimers is a awesome add-on but it could use some extra stuff on it. First I would make it compatible with Masque so the buttons can have any kind of skin on it.

    Then try to make it have as many options as bartender has for keybinding, seeing the 1 to = on the buttons as default, being able to scale them to any size...options like that.

    I would replace Bartender 4 if ButtonTimers had these kind of options cause I like the set-up ButtonTimers has to offer for the U.I

    Last edited Dec 30, 2015 by EvilMaddness
  • Avatar of EvilMaddness EvilMaddness Dec 24, 2015 at 23:28 UTC - 0 likes

    I wanted to use Masque for ButtonTimers so it can look the same as the rest of my action bars but I can't find anything to help me out. Anyone know how I can use the Masque artwork for the action bars on ButtonTimers?

  • Avatar of stencil stencil Nov 27, 2012 at 19:49 UTC - 0 likes

    @mannfog: Go

    Bartender has its own locking mechanism that is specific to their bars/buttons. Go to the games action bars options and lock buttons there to lock the ButtonTimers buttons.

  • Avatar of mannfog mannfog Nov 27, 2012 at 12:46 UTC - 0 likes

    Hey Misen and stencil,

    Great addon you have here. I have been using it long time and if you can keep up the excellent work I will continue using it.

    One issue is bothering me thou: I use Buttontimers with Bartender4 (also used Bartender3 with it) and lately I have encountered problem that buttons in Buttontimers don't stay locked in place. It used to be so that once you locked buttons in Bartender3/4 they stayed locked also in their places in Buttontimers bar but now they don't anymore. During raid is pretty bad when suddenly you drag button or two away from bar and end up searching them from Macros or Spells list.

    Any idea of this behaviour?

    Best regrds Fastheim of Aerie Peak-EU

  • Avatar of stencil stencil Aug 25, 2012 at 20:39 UTC - 0 likes
  • Avatar of ogredaviking ogredaviking Jul 08, 2012 at 23:26 UTC - 0 likes

    WIll you be updating this for MoP?

  • Avatar of Sandromania Sandromania Jun 18, 2011 at 21:21 UTC - 0 likes

    pls update it for the next patch. it's already been out of date for 4.1 and this causes me some fps lags sometimes. god know what will happen if you don't get fixed for upcoming 4.2. yes i'm addicted to buttontimers.

  • Avatar of DrKazza DrKazza Oct 19, 2010 at 02:41 UTC - 0 likes

    Button timers works perfectly for me in 4.0.1 Are you sure you've updated out of date addons


    p.s. except no timers for death knight diseases ;)

  • Avatar of Oompaw Oompaw Sep 04, 2010 at 00:44 UTC - 0 likes

    I'm a Button Timers addict, and I'm finding it hard to play without it in Cata Beta. Any word on if this mod will be updated for 4.0?


Date created
Feb 16, 2009
Last update
Aug 17, 2016
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files
  • R: 2.6.01 for 7.0.3 Aug 17, 2016
  • A: r78 for 7.0.3 Aug 17, 2016
  • R: 2.6.00 for 7.0.3 Aug 06, 2016
  • A: r76 for 7.0.3 Aug 06, 2016
  • A: r75 for 7.0.3 Aug 06, 2016