a macOS application for de-pixelating and then whimsically re-pixelating small animated GIF's
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Assets.xcassets
appkit
coregraphics
docs
foundationkit
lib
spiritedarray.xcodeproj
spiritedarray
spiritedarrayTests2
.gitignore
LICENSE.txt
README.md

README.md

Spirited Array is a Mac application for de-pixelating and then whimsically re-pixelating animated GIF's. Inspired by the nightly Electrical Water Pageant on the Seven Seas Lagoon at Walt Disney World, Spirited Array was written to simulate light board animations of unspecified dimension, without expensive hardware.

Operation

To operate, open the Application on your Mac and choose Open from the File pull-down menu. Then, navigate to and select an animated GIF, static GIF, (static) PNG or (static) TIFF file.

An attempt will be made to recognize any pixelation your file exhibits, and remove it. Finally, your animation will be re-pixelated according to the configured tiling strategy, and animated in a loop. Details about your animation will be provided in a status bar at the lower left-hand corner of the animation window.

screenshot of animation processed from prguitarman's "Pop Tart Cat" GIF (popularized as "Nyan Cat" in a video by saraj00n.)

You may choose different tiling strategies with the Tiling pull-down menu.

To change the dimensions of the virtual array, simply resize the animation window.

Use the linked sliders that appear after processing to change the tile size and restart the de-pixelation and re-pixelation sequence.

By default, the vertical and horizontal sliders will be locked together. You can toggle locking on and off by clicking on the padlock icon in the lower right-hand corner of the animation window.

To export re-pixelated video to a file, use the appropriate Export corresponding to the desired output format under the File Menu. The choices are QuickTime movie, MP4 video, and Animated GIF.

GIF Exports are currently limited to animations that exhibit 256 or fewer distinct colors. Also, be advised that large frames and long durations can result in truly enormous output GIF file sizes.

Building from Source

Spirited Array is licensed under GPL v3.0 and available to clone on github.

The project should build directly in XCode 9.

Spirited Array makes use of MIT-licensed libungif-4.1.4, a decompression-only version of the venerable giflib. To keep things simple, an actual binary is included. But feel free to compile libungif (or giflib) yourself, and replace libungif.a.