AGS Sprite Extractor

Pull PNG sprites from Adventure Game Studio .spr files

…

A small command-line tool for modders, fan-game makers, and anyone who wants game graphics out of an AGS project. Fast, free, and open source.

Download ZIP

Unzip, then run with Python — needs Pillow (see below).

Setup

You need Python 3.6+ and Pillow.

Install
pip install Pillow

How to use

  1. Download the ZIP above and unzip it anywhere you like.
  2. Find your game’s sprite file — usually acsprset.spr in the game folder.
  3. Open Command Prompt or Terminal in the folder with sprite_extractor.py and run a command below.

Commands

List all sprites
python sprite_extractor.py acsprset.spr -l
Extract one sprite
python sprite_extractor.py acsprset.spr -e 3240
Extract a range
python sprite_extractor.py acsprset.spr --range "1000-1999"
Extract everything
python sprite_extractor.py acsprset.spr -a

Tips

  • Sprite numbers start at 0 (not 1).
  • PNG files are saved as sprite_03240.png in extracted_sprites/ by default.
  • Use -o my_folder to pick another output folder.