https://github.com/agersant/tiger
Tiger is a visual tool to author game spritesheets and their metadata.
https://github.com/agersant/tiger
animation gamedev pixel-art tools
Last synced: 24 days ago
JSON representation
Tiger is a visual tool to author game spritesheets and their metadata.
- Host: GitHub
- URL: https://github.com/agersant/tiger
- Owner: agersant
- License: mit
- Created: 2018-11-19T08:44:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-09-29T06:45:32.000Z (over 1 year ago)
- Last Synced: 2025-03-20T20:14:06.544Z (about 1 month ago)
- Topics: animation, gamedev, pixel-art, tools
- Language: Rust
- Homepage:
- Size: 6.3 MB
- Stars: 207
- Watchers: 7
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/agersant/tiger/releases/latest) [](https://github.com/agersant/tiger/actions) [](https://codecov.io/gh/agersant/tiger)
# Overview
Tiger is a visual tool to author game spritesheets and their metadata.
This tool bridges the gap between the work done by an artist and data needed by a game engine. Artists draw animations as images, but game engines need lots of metadata about how to use them correctly. Tiger gives you a simple but versatile interface to organize frames into animations like "run", "idle" or "attack". Tiger can also adjust offsets, timings, and hitboxes for each frame.
After you organize everything in Tiger, it exports a spritesheet containing all the images, plus a metadata file. The exact format of this metadata file is defined by you, using a template system. This makes it easy to integrate Tiger Sheets with any game engine.
# Key Features
- ✅ Easy-to-use timeline to author animations.
- ✅ Supports perspectives for any 2D game (top-down, sidescroller, isometric, etc.).
- ✅ Automatically hot-reloads source images when they are changed.
- ✅ Packs animation frames into texture atlases.
- ✅ Can add and tag hitboxes.
- ✅ Flexible template system exports metadata in any text-based format.
- ✅ Free and open-source with a permissive license.
Note that Tiger is not:
- ❌ A drawing program.
- ❌ A skeletal animation program like Spine.
- ❌ A plug-and-play solution for any specific engine. You will need code to use the output of Tiger in your engine of choice.
# Screenshots & Videos
[tiger-demo-2.webm](https://user-images.githubusercontent.com/817256/223934634-59958844-6763-4e87-ad38-6aa69a6480d4.webm)
| | |
| :---------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------: |
| [](res/readme/screenshot-1.0.0.png?raw=true) | [](res/readme/screenshot-1.0.0-export.png?raw=true) |
| [](res/readme/screenshot-1.0.0-relocate.png?raw=true) | [](res/readme/screenshot-1.0.0-startup.png?raw=true) |
# Getting Started
Tiger is only supported on Windows. To install it:
1. Go to the [latest release](https://github.com/agersant/tiger/releases/latest) page.
2. Download the `.msi` installer.
3. Run the installer. This will install Tiger and Microsoft Edge Webview (if necessary).
4. That's it, you're done!
To learn how to integrate Tiger Sheets into your game, please refer to the [Documentation](https://agersant.github.io/tiger/).
# Contributing
- 🗨 For help, feedback or suggesting new features, please use [Discussions](https://github.com/agersant/tiger/discussions).
- 🐛 For bug reports, please use the [Issues Tracker](https://github.com/agersant/tiger/issues).
- 🛠 Planned changes and features are listed in the project [Roadmap](ROADMAP.md).
- ❌ Please do not create pull requests adding new features.
# License
The MIT License in this repository applies to the Tiger _source code_. This does not include the Tiger logo and mascot illustrations. If you operate a public fork of this project, you cannot use the Tiger logo or mascot. For private forks (individual, or distribution limited to your team/company), you may use the Tiger logo or mascot.
Sprites in the example screenshots are from [OpenDuelyst](https://github.com/open-duelyst/duelyst) ([License](https://github.com/open-duelyst/duelyst/blob/main/LICENSE)).
