Skip to content

MeguminBOT/TextureAtlas-to-GIF-and-Frames

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎨 TextureAtlas to GIF and Frames

A powerful, free and open-source tool for extracting frames and animations from Texture Atlases

TextureAtlas to GIF and Frames converts texture atlases into organized frame collections and GIF/WebP/APNG animations. Perfect for creating showcases and galleries of game sprites.

📄 Licensed under AGPL-3.0

📋 Quick Navigation

🚀 Quick Start

  1. Download from official sources
  2. Install following the Installation Guide
  3. Load your texture atlas and metadata file
  4. Configure animation settings
  5. Extract and enjoy your animations!

📦 Supported Spritesheet Types

  • Sparrow (XML format)
  • Starling (XML format)
  • Packer TXT (TXT format)
  • 🟨 (*) Unknown/Unsupported (Attempts to extract sprites despite missing official support)

(*) = Feature may have bad results or are not fully stable yet

✨ Features

  • Multiple output formats: GIF, WebP, APNG animations + individual frames (PNG, WebP, AVIF, BMP, DDS, TGA, TIFF)
  • Batch processing: Extract multiple animations and spritesheets simultaneously
  • Automatic sprite detection: Process image files without metadata using intelligent boundary detection
  • Organized Sort frames from spritesheets into individual folders.
  • Advanced controls: Customizable frame rate, loop delay, scale, frame selection, and alpha transparency threshold
  • Compression control: Lossless and lossy compression methods.
  • Smart cropping: Animation-based and frame-based cropping options
  • Find/Replace rules: Customize output filenames with pattern matching
  • Auto-update system: Automatic checking and installation of updates
  • Persistent settings: Configuration saved between sessions
  • ✅ (*) Preview system: Real-time GIF preview with playback controls
  • ✅ (*) Friday Night Funkin' character data: Import character data files from various FNF engines to set correct animation settings

(*) = Feature may have bad results or are not fully stable yet

⚠️ Current Limitations

  • ⚠️ Input image format: Currently supports PNG texture atlases only
  • ⚠️ Static thread and memory usage: Currently uses the resources you tell it to without any dynamic managing of system resources.
  • ⚠️ False positive virus (Windows only): Some anti-virus software flags compiled Python code as malware. Read this for more info

🔮 Planned Features

Contributors are welcome to help implement the following features:

  • 📚 QT graphical interface: Swapping to QT based UI. (Repo maintainer will do the initial work in a branch named "QT", afterwards any help is welcome)
  • 🔄 Command-line interface: Full CLI support for automation and scripting
  • 🖼️ Additional input formats: Support for more image formats beyond PNG
  • 🖱️ Drag & drop support: Easier file loading interface
  • 🔌 Custom FFMPEG output: Custom output formats through FFMPEG
  • Enhanced memory management: Dynamic memory limits and optimization

Note: Features mentioned above are planned for future versions and are not currently implemented.

📚 Installation and Usage

Need help getting started? Check out the documentation:

💾 Official Download Sites

Note: Mac OSX and Linux users need to download source code from GitHub!

🔗 SourceForge

Download TextureAtlas Extractor and GIF Generator

Itch.io

Download TextureAtlas Extractor and GIF Generator Itchio

🎮 GameBanana

Download TextureAtlas Extractor and GIF Generator GB

⚠️ Security Notice: Only download from official sources listed above. I'm are not responsible for any damage or issues caused by downloading from unofficial sites.

🔧 Technical Information

This application uses ImageMagick for advanced image processing capabilities. ImageMagick is a powerful, open-source software suite for image manipulation and conversion.

Learn more about ImageMagick:

For Windows users, all necessary ImageMagick libraries are included with the release package.

📞 Support & Contributing

Need help?

Want to contribute?


Last updated: June 23, 2025 - Visit the 📚 Documentation → for more details

About

Convert texture atlases into organized frame collections and GIF/WebP/APNG animations. Perfect for creating showcases/galleries of game sprites.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages