A free, open-source tool to streamline your 2D sprite animation workflow.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Animation Viewer

A free, open-source tool to streamline your 2D sprite animation workflow in Photoshop, Inkscape, and possibly other vector graphics programs.

Check out the intro video here: http://youtu.be/KAiKDr-uafo


Downloads are available in the releases section.

If you have a Java 7 or 8 Runtime installed, choose a "java7/8" download. Simply unpack it someplace convenient and run anim-view-<version>.jar

If you are on Windows and either don't want to install Java or you have a different Java runtime installed, choose a "win32/64" download (depending on whether your system is 32- or 64-bit). It comes with a bundled Java runtime that you will not need to install. Simply unzip someplace convenient and run anim-view-<version>.exe


Animation Viewer is designed to work with files that are organized in a certain way.

  • Each animation frame should be a separate layer that overlaps directly with the layers under it. (In Photoshop, a top-level Layer Group will also be treated as a single frame.)
  • Frames should be ordered from bottom to top. The first frame will be on bottom and the last frame on top.
  • Any top-level layer or layer-group named "Background" or that starts with a dash (-) will be ignored. This way you can have a palette or other special-use layers that are not drawn into the animation.

Open a PSD or SVG file (File -> Open, or Ctrl+O) and playback will begin immediately. That file will now be watched for changes. If you make an edit and save your file, Animation Viewer will automatically load your changes and begin displaying them.

You can change the background color that your animation is drawn onto (Edit -> Set Background Color, or Ctrl+B). Note that you will only see this color if your frames contain transparent pixels.

The Pause and Play buttons will pause and continue playback. If you have paused the animation, edits to your file will not be immediately visible, but you will see them when you hit play again.

The FPS setting changes how quickly your frames are played. Values can range from 1 to 99. Integer values only.


I hope you'll find this tool useful as you develop animations. Feel free to get in touch with Ornithopter Games on Twitter or at the website if you have ideas on how Animation Viewer can be improved, or even if you just want to show off your work!

Also thank you to these libraries without whose work Animation Viewer would have been impossible (or at least really, really hard.)