promotional bannermobile promotional banner


This Addon/Library is designed for developers to generate consistent screenshots for your image gallery.


Just install this as a standalone addon from CurseForge or Wago. You don't need to embedded or package it into you project. (A dependency link as a used tool is appreciated though. :) )


local gg = LibStub("GalleryGenerator")
            api:BackScreen() -- hide game world with black screen
            ToggleCharacter("PaperDollFrame") -- shows character frame
            api:BackScreen(0, 1, 0) -- green screen
            api:Click(PaperDollFrame.ExpandButton) -- revert previous toggle

More practical examples can be found here:


The library itself has only one external method called TakeScreenshots.

  1. The first argument is a list of your preparation functions. A screenshot is triggered 1 Second after the end of each function.
  2. With a further optional function as second argument, you can revert your UI back into the initial state.

Each function is provided with an internal API as first argument.

api:Point(targetFrame[, offsetX[, offsetY]])

This places a virtual pointer icon central on the given frame. It also triggers script handlers for OnEnter and all parent frames. Subsequently, it also triggers OnLeave.

  • targetFrame table|Frame A frame to place the pointer onto
  • offsetX nil|number Optional offset right of the center (negative for left)
  • offsetY nil|number Optional offset up of the center (negative for down)


  • table|TextureBase Texture instance of pointer icon for own further customization

api:Click(targetFrame[, button])

This triggers all cLick handlers on the given frame. (In order: OnMouseDown, OnMouseUp, PreClick, OnClick, PostClick)

  • targetFrame table|Frame Frame to trigger a click on
  • button nil|string Optional mouse button identifier. Defaults to "LeftButton"


A simple function to subsequently call Point() and Click()

  • targetFrame table|Frame Frame to place the pointer on and trigger a LeftClick


  • table|TextureBase Texture instance of pointer icon for own further customization


This interrupts the internal Screenshot timer, so you can wait longer for your UI to finish loading. You HAVE TO call Continue() on your own to process further!


This continues processing after a Wait() interruption.

api:BackScreen([red, green, blue])

This shows a back screen to hide the game world.

  • red nil|number Optional red component [0.0 - 1.0]
  • green nil|number Optional green component [0.0 - 1.0]
  • blue nil|number Optional blue component [0.0 - 1.0]

Tips & Tricks

  • You should use the english game client to take screenshots. So they are readable by probably the most users. (You can use a PTR client for that. ;))
  • Use the :BackScreen() to hide the game world and to provide a nice background color for further processing.
  • You can add your script and images into your project repository, but you should ignore them in your .pckgmeta file. So it doesn't bloat the final zip unnecessarily.
  • After you have taken some nice shots. You can automate copying and cropping the files a bit as well. Read further in the project wiki.