tSpritePreviewer

How to use

Drag & Drop a folder into the application window - if your file structure is right, you get a complete preview.

File names matter

1. All parts have to be in the same folder, named after the set 
2. All parts have to contain the same set name
3. All sprites have to contain which part they are (one of Head, Body, Legs) - case matters

SetName (directory)
  - SetNameHead_Head.png       sprites (for the preview)
  - SetNameBody_Body.png       
  - SetNameLegs_Legs.png       
  - SetNameHead.cs             code (not needed)
  - SetNameHead.png            inventory sprite (not needed)

An example (ExampleArmor.zip) is included in the download.

Since there are four sets in one folder (ExampleArmor, ExampleCostume, ExampleCostumeAlt, Vanilla), you can rename the folder to one of the four and drop it back in to preview it.

Features

• compatible with any image editor
• automatically reloads preview on file save
• work at 1x or 2x pixel scale, the preview adjusts to fit

Single Part Preview and Animation States

• toggle any part completely visible or invisible
• toggle any equipment part to be worn or not
• toggle showing clothes and the character altogether
  
• change between male and female armour styles
• preview every sprite state separately
  • idle, jump, use, move, sitting, special arm (petting, golf etc.)

Different Backgrounds

• 5 grey presets 
• 5 biome approximation presets
• any valid colour hex code
• any background using 0% alpha and opening an image behind it

Animation control

• pause/play
• switch single frames
• different animation speeds

Custom Window

• rescale preview with the window
• pin to always stay in foreground
• window title bar disappears to reduce distractions

Installation warnings

Yes, windows defender will complain, as well as mac. You will have to use the 'run anyway' or 'open anyway' option of your operating system.

Why? Applications need to be signed by a developer with a certificate before the OS will accept them without complaints. The problem: those certificates cost around 300$ /year.

Privacy

The application will request access to any folder where you store the image files you want to preview. No other data except the images and file names are read. The application has no connection to the internet whatsoever. You can always check the source code.

Support the Project     

The full source code is available on GitHub. If you are missing a feature and know Godot, feel free to open a Pull Request. If you don't know Godot (though it's really easy to learn) you can always open an issue on GitHub to request a feature, or comment it here on the itch.io page. Same goes for bug reports.

Support me    

If you want to support me you can buy me a coffee (no account needed)

Changelog

• 2022-10-04
  • fix crash when opening the application if the last used directory no longer exists
  • fix crash when dropping directory which does not contain files with the same name
  • fix: make shoulder show in front in last two frames of ‘use’ animation
  • fix typo in tutorial message
• 2022-10-05
  • add preview for sitting pose
  • fix preview not showing back shoulder
• 2022-10-07
  • add preview for special arm (petting, eating, golf)
  • fix female body not showing correctly
  • fix shoulder layering when switching animation states
  • fix female shoulder not showing
• 2022-10-16
  • big one: added player body, clothes, hair, and alternative hair style to the preview
  • shortcuts now work with closed tool panels (pause/play, skip frame etc.) 
  •  added more hint texts 
  •  change cursor shape to fit interactions better 
• 2022-10-23
  • fixed an error where the body and clothes sprite would not show up
• 2022-12-05
  • fixed animation starting to play after reload