Sprite Factory is a focused Windows editor for sprites, animated GIFs, icons, photos, and other image assets. Import one file or a whole collection, compare the source with the edited result, make precise adjustments, and export individual files or a complete batch.
Download Sprite Factory for Windows | Update Notes | Help and troubleshooting
Sprite Factory 1.2.5 is the current source version. It is a desktop application for Windows 10 and 11, and its verified one-file Windows build is ready for the next GitHub release.
- Open the latest GitHub release.
- Under Assets, download the Windows executable listed for that release.
- Open the downloaded file. No installer or Python setup is required.
- Use File > Add Files or File > Add Folder to begin.
Windows may display a SmartScreen warning because the community build is not code-signed. Only continue when the file came from the official Awetspoon/SpriteFactory release page.
- Compare Current and Final side by side before anything is exported.
- Adjust size, DPI, color, lighting, detail, cleanup, edges, transparency, GIF playback, and output encoding.
- Remove white or black backgrounds only when you choose to; importing never removes a background automatically.
- Apply compatibility-aware presets or save your own preset from the active controls.
- Process mixed image collections through the isolated Batch Manager.
- Collect files from public web pages and keep useful websites and pages in a reusable Saved Library.
- Export PNG, WEBP, JPG, GIF, ICO, TIFF, or BMP with profile, naming, resize, and metadata options.
- Add an image, animated GIF, folder, or ZIP archive from the File menu.
- Select an asset in the Workspace. Current shows the original source and Final shows the result that will be exported.
- Choose a compatible preset or open an Edit Settings category and make small adjustments.
- Watch Final refresh, use a reset action if needed, then choose Export.
The controls begin from detected source data such as dimensions, DPI, transparency, frame count, and GIF playback metadata. Enhancement values stay neutral until you change a control or choose a preset.
Web Sources can scan one page, many pasted pages, saved library pages, or selected pages discovered from an index.
- Scan Pages accepts one full URL per line, including pages from different websites.
- Saved Library groups saved pages under their website, so one Project Pokemon entry can contain its root, sprite index, generations, and any other pages you choose to keep.
- Find Linked Pages discovers pages from an index without scanning or downloading them automatically.
- Save Selected to Library keeps useful discovered pages with their names for future scans.
- Found Files accumulates unique results across scans until you explicitly clear it.
- Search, hidden-word, and file-type filters help narrow large result lists without deleting stored results.
Large scans are capped and require confirmation. Some sites may block automated requests or use JavaScript-only pages that a static scanner cannot read. Please respect each website's terms, copyright, and rate limits.
Preset Studio, Workspace, recommendations, and Batch use the same preset library. System presets are safe templates; experienced users can create a user preset from controls changed on the active asset.
Batch Manager keeps queue processing separate from the live editor. Choose one clear edit source for a run: retain each asset's controls, apply one preset, copy the active controls, or smart-match compatible assets. Background behavior, naming, output folder, and export options remain explicit.
| Purpose | Formats |
|---|---|
| Import | JPG/JPEG, PNG, WEBP, TIF/TIFF, BMP, ICO, GIF, and ZIP archives containing supported images |
| Export | PNG, WEBP, JPG, GIF, ICO, TIFF, and BMP |
Animated GIF preview and export preserve frame timing, looping, transparency, palette, and dithering choices through the shared frame pipeline.
- Python 3.11 or newer
- PySide6 desktop interface
- Pillow image processing
- PyInstaller Windows packaging
Local image editing and export happen on your computer. Web Sources makes network requests only to pages and files you ask it to scan or download. Settings, sessions, caches, logs, and default exports are stored in the app's local data directory and are not committed to this repository.
Source requirements are Windows 10/11, Python 3.11 or newer, Pillow, and PySide6.
py -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -U pip
pip install -e .
powershell -ExecutionPolicy Bypass -File .\run_app.ps1To keep development data separate from your normal app data, set IMAGE_ENGINE_APPDATA_DIR in a local .env file. The tracked .env.example shows the supported setting without including any private values.
Build the verified single-file Windows release:
powershell -ExecutionPolicy Bypass -File .\build_exe_onefile.ps1Run the repository health audit:
powershell -ExecutionPolicy Bypass -File .\RUN_AUDIT.ps1The release build runs the complete automated suite and a frozen-application launch test before producing .local\release\SpriteFactory-v1.2.5-win64.exe. Generated builds, runtime data, caches, and local settings are ignored by Git.
image_engine_app/app/contains startup, persistence, services, and application workflows.image_engine_app/engine/contains image ingest, analysis, processing, batch, export, presets, and models.image_engine_app/ui/contains the PySide6 desktop interface and dialogs.image_engine_app/tests/contains automated unit, architecture, and UI smoke coverage.docs/contains update notes, support guidance, and release documentation.
Keep changes focused, run the automated suite and repository audit, and avoid committing runtime data, builds, local settings, or private URLs. See the release checklist before publishing a Windows build.
Sprite Factory is available under the MIT License.