What Is Game Sprite Atlas Viewer?
Game Sprite Atlas Viewer is a free online tool by TechnSols that shows a sprite atlas on screen: one sheet image plus the atlas JSON that lists every frame inside it. It draws the sheet with a clear outline and a name label on each frame, lists the frames in order, and lets you click any frame to highlight it, so you can check a game atlas before you load it into an engine.
A sprite atlas packs many small game images into one big image, and the JSON file records where each frame sits, with its x and y position plus its width and height. When the numbers in the JSON do not match the picture, a character can show the wrong pose, a tile can show half of its neighbour, or an animation can jump. This viewer puts the picture and the numbers side by side, so a mismatch is visible at once. It is distinct from the live Image Converter, which changes an image from one format to another: that tool changes files, while this tool inspects an atlas that already exists.
Everything runs in your browser, and no file is uploaded anywhere. The demo atlas is built in, so the tool works with one click and no files at all, and your own sheet and JSON stay on your own computer when you load them.
How To Use Game Sprite Atlas Viewer?
Using Game Sprite Atlas Viewer takes about a minute, with no software to install and no account to make. Press Show Atlas to load the built in demo, or load your own sheet image and atlas JSON first. If your sheet needs a format change before you load it, the Image To JPG tool makes a JPG copy from a PNG or WebP sheet.
Step 1: Load The Demo Atlas Or Your Own Files
Press Show Atlas to view the built in demo at once. The demo sheet is 256 by 64 pixels and holds 4 frames named idle, walk1, walk2, and jump, each 64 by 64 pixels. To check your own atlas instead, choose a sheet image in PNG, JPG, or WebP format, then choose a JSON file or paste the JSON into the atlas JSON box. The sheet must be 100 MB or smaller, and a file whose first bytes do not match its type is refused with a plain error.
Step 2: Read The Outlines And The Frame List
The canvas draws the sheet with a coloured outline around every frame and the frame name written at the top of each box. Read the status line under the canvas: it states the frame count, every frame name, and the sheet size in pixels. The frame list below the canvas shows the same names in order, with the x, y, width, and height of each frame, so you can check one frame against the JSON without scrolling. To compare this sheet with an older one, the Image Difference Checker shows every changed pixel.
Step 3: Click A Frame And Download The Outputs
Click any frame on the canvas, or click its name in the frame list, to highlight it. The highlighted frame gets a thicker outline, and the status line names it with its exact position and size. Press Download on a result row to save the frames JSON, which lists all 4 demo frames with x, y, width, and height, or the annotated PNG, which is the sheet with the outlines and labels drawn on it. With 2 outputs, Download all files saves both at once.
The whole job is three steps, and you can load a different atlas and view it again as often as needed.
Why Do Game Developers Need An Atlas Viewer?
A game that draws many small sprites one by one asks the graphics card to switch textures again and again, and that switching costs time on every frame. Packing the sprites into one atlas means one texture serves the whole character, the whole level, or the whole menu, and the game runs smoother. The atlas only helps when the JSON matches the picture, and a viewer is the fastest way to prove that it does.
Wrong Frames Break Animations
An animation is a list of frames played in order, and one wrong rectangle in that list shows the wrong pose for a single frame. Viewing the atlas with outlines shows the order and the size of every frame before the game ever runs, so the flicker is caught here, not after release.
Names Stop Guessing In Code
Frame names are the link between the artist and the code. When the code asks for jump and the JSON holds jump at a known rectangle, the result is certain. When the names are guessed or typed from memory, a small spelling slip loads the wrong sprite or nothing at all. The frame list in this viewer shows every name exactly as the JSON spells it, so the code can copy it with confidence. If a frame name needs checking against a picture, the Pixel Art Editor draws sprites one pixel at a time for a closer look.
One Sheet Serves Many Engines
The same atlas idea serves Phaser, PixiJS, Godot, Unity, and a plain canvas game, because each engine reads a JSON list of rectangles and draws the named part of one image. A viewer that reads the common hash format and the array format, and reports the size of the sheet, works for all of them.
What Can You Do With Game Sprite Atlas Viewer?
Game Sprite Atlas Viewer fits any job where a sheet image and a JSON file must agree. These are the jobs it handles best, from a first character to a full game atlas.
Check A New Character Atlas
A new character often arrives as one sheet with idle, walk, and jump frames packed side by side. Load the sheet and the JSON, press Show Atlas, and read the outlines. If idle sits at x 0 and walk1 sits at x 64, the packing is exactly as planned. When a layout needs planning first, the Dot Grid Generator draws the grid for it.
Debug A Broken Animation
When an animation flickers in the game, the first question is whether the JSON or the game code is wrong. Load the same files here and click through the frames in order. If the viewer shows the right poses in the right order, the JSON is sound and the fault sits in the game code. If the viewer shows a wrong pose, the JSON or the sheet is the fault, and the highlighted frame names the exact rectangle to fix. A list of frames can also feed a table through the JSON To CSV tool.
Share An Atlas With A Teammate
An artist and a programmer often work on the same atlas from different computers, and a picture with labels settles a question faster than a list of numbers. Download the annotated PNG and send it with the frames JSON, and both people see the same outlines, the same names, and the same sheet size.
Every job that starts with a sheet and a JSON file ends with a checked atlas, and this tool does the checking in the browser. That is the whole job, and it takes less than a minute for any atlas.
Quality And Settings
Five settings shape the atlas view, and each one is simple to set.
- Demo atlas: 256 by 64 pixels, 4 frames named idle, walk1, walk2, and jump, each 64 by 64 pixels.
- Sheet image: PNG, JPG, or WebP, checked by extension and by magic bytes, up to 100 MB.
- Atlas JSON: a file or pasted text, hash format or array format, up to 200 frames.
- Frame highlight: click a frame on the canvas or its name in the list to select it.
- Outputs: frames JSON plus annotated PNG, each with its own Download button.
The 200 frame limit keeps the canvas fast in the browser. An atlas with more frames than that is usually several atlases sharing one file, and splitting it into two or three sheets keeps each view readable. When a sheet must be made smaller first, the Image Resizer changes its size without changing the frame layout.
How Game Sprite Atlas Viewer Reads The Atlas
The viewer reads the atlas JSON in two shapes. In the hash shape, frames is an object whose keys are the frame names and whose values hold a frame object with x, y, w, and h. In the array shape, frames is a list whose items hold a filename and a frame object with the same four numbers. The tool accepts either shape, trims the names, and drops any frame whose numbers are missing or not whole numbers, so a damaged entry never draws a broken outline. If the JSON is hard to read, the JSON Formatter formats it into clean lines first. The meta size in the JSON is checked against the real image size, and a mismatch is reported in the error line instead of drawing a wrong view.
Two honest limits are worth knowing. First, the atlas JSON must match the image size, because the viewer draws rectangles on the real sheet, and a JSON written for a different sheet size cannot be stretched to fit. Second, the annotated PNG is a picture of the atlas with outlines and labels, not a new atlas, so it cannot replace the original sheet and JSON in a game. If the sheet itself needs a crop before use, the Crop Images tool trims it to the exact area you need.
Privacy
Everything you load stays in your browser. Game Sprite Atlas Viewer runs on your own computer, and nothing you choose is uploaded to a server, stored, or shared with anyone. The tool draws the sheet and reads the JSON locally, and that is all it does.
Because no account is needed, there is no name, email, or history tied to what you do. Closing the tab ends the session, and the browser clears the sheet and the JSON from memory. Your game art stays yours, and nothing about it is kept, shared, or sold.
Tips
A few habits make Game Sprite Atlas Viewer work smoother.
- View the demo first, so you know what a correct atlas looks like.
- Check the status line frame count against the count in your JSON.
- Click each frame in order to walk the animation by hand.
- Keep frame names short and plain, so code can spell them easily.
- Save the annotated PNG with the project, as a record of the check.
When the frame count matches, every name is spelled as expected, and the sheet size matches the JSON, the atlas is ready to load into the game.
More Tools For The Same Job
These tools handle the same kinds of jobs: game art, images, grids, and JSON files.
- Tilemap Editor: paints a game level on a grid and exports it as JSON.
- Pixel Art Editor: draws game sprites one pixel at a time in the browser.
- Image Converter: changes a sheet image from one format to another.
- Image Resizer: changes the size of a sheet image before it is packed.
- Crop Images: trims a sheet to the exact area a game needs.
- Image Difference Checker: compares two sheet images pixel by pixel.
- JSON Formatter: formats and checks atlas JSON so it is easy to read.
- JSON To CSV Converter: turns a JSON list into a table for a spreadsheet.
- Image To JPG: makes a JPG copy of a PNG or WebP sheet image.
- Dot Grid Generator: draws a dot grid for planning sprite layouts.
FAQ
Common questions about sprite atlases and this viewer, answered plainly.
Is Game Sprite Atlas Viewer By TechnSols Free?
Yes, Game Sprite Atlas Viewer by TechnSols is completely free to use, with no account, no sign-up, and no usage limit. You can view as many atlases as you like, and everything runs in your browser, so nothing is uploaded or stored anywhere.
What Atlas JSON Formats Does It Read?
It reads the TexturePacker hash format, where frames is an object keyed by frame name, and the array format, where frames is a list with a filename on each item. Both shapes need a frame object with x, y, w, and h in whole pixels. A frame with missing numbers is skipped and named in the error line.
What Image Types Can I Load?
You can load a PNG, JPG, or WebP sheet image up to 100 MB. Each file is checked by its extension and by its magic bytes, so a renamed file of the wrong type is refused. The demo needs no file at all, because its sheet is drawn by the tool itself.
Why Does The JSON Size Need To Match The Image?
The viewer draws each frame rectangle on the real sheet. When the meta size and the image size differ, the tool reports the mismatch instead of drawing a wrong view. A texture atlas packs many sprites into one image for fast drawing, as the Texture Atlas guide explains.
What Is The Difference From Image Converter?
Image Converter changes an image from one format to another, while this viewer inspects a sheet and its JSON without changing either file. Use this tool to check an atlas, and Image Converter when the sheet itself needs a new format. A sprite is a small image drawn as part of a larger scene, as the Sprite guide explains.
Load the demo, check the frames, and download the outputs. An atlas checked here loads cleanly in the game, and that is the whole point of the viewer.