Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adia-dev/piksy
🚀 Piksy is a work-in-progress sprite sheet editor and animation tool, perfect for game devs and digital artists looking to streamline their 2D workflow! 🎨
https://github.com/adia-dev/piksy
2d-art animation-tool cpp frame-extraction game-development opencv piksy pixel-art sdl2 sprite-sheet
Last synced: about 7 hours ago
JSON representation
🚀 Piksy is a work-in-progress sprite sheet editor and animation tool, perfect for game devs and digital artists looking to streamline their 2D workflow! 🎨
- Host: GitHub
- URL: https://github.com/adia-dev/piksy
- Owner: adia-dev
- Created: 2024-11-01T14:04:08.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-01-22T07:48:44.000Z (10 days ago)
- Last Synced: 2025-01-23T04:04:35.230Z (9 days ago)
- Topics: 2d-art, animation-tool, cpp, frame-extraction, game-development, opencv, piksy, pixel-art, sdl2, sprite-sheet
- Language: C++
- Homepage:
- Size: 4.37 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Piksy
> 🚧 **Work in Progress**
> Piksy is an evolving C++ application for effortless **sprite sheet editing**, **frame extraction**, and **animation handling**. It's currently **replacing** [this project](https://github.com/adia-dev/spritesheet_editor) but remains under heavy development!
## 🚀 Key Features
- **Sprite Sheet Organization**
Load and preview your sprite sheets, neatly organize files, and quickly navigate through folders.
- **Frame Extraction**
Automatically detect frames with computer vision (or create them manually for full control).
- **Animation Editing**
Combine frames into animations, reorder them on-the-fly, and preview motion instantly.
- **Color Swapping**
Tap into a handy color tool to replace any target hue with a new color, saving manual editing time.
- **Export & Save**
Save all animations as JSON and export textures as PNG. Perfect for engine-ready assets!
> **Tip**
> Piksy is great for game devs, hobbyists, and artists needing a streamlined workflow to handle sprite sheets.
---
## 🎉 Screenshots & Videos (so far, subject to changes)
---
## 🔧 Getting Started
1. **Clone**
```bash
git clone https://github.com/adia-dev/piksy.git
cd piksy
```
2. **Build** (example using CMake):
```bash
make
# or
make -j4
```
3. **Run**
```bash
make run
# or
build/Debug/bin/piksy
```
> **Info**
> You’ll need to have SDL2, SDL2_image, SDL2_ttf, and OpenCV installed for a successful build (if building from source). Pre-built binaries may come later.
---
## 🔨 Usage Overview
1. **Load or Drop a Sprite Sheet**
- Use the "File" menu or simply drag-and-drop your sprite sheet into Piksy.
2. **Extract Frames**
- Choose the "Extract" tool, draw a selection, and Piksy detects frames in that region.
3. **Create & Preview Animations**
- Group these frames into sequences. Adjust timing and naming on-the-fly.
4. **Export**
- Save the entire texture or export your animation data to JSON with a quick menu option.
> **Warning**
> Some tools and features are incomplete—please report any quirks or bugs you encounter.
---
## 📂 Project Structure (Brief)
```
piksy/
├─ include/
│ ├─ core/ # App setup & configuration
│ ├─ command/ # Actions (Export, Save, etc.)
│ ├─ components/ # UI panels (e.g., Console, Viewport)
│ ├─ rendering/ # Rendering logic (SDL, textures)
│ ...
├─ src/
│ ├─ core/
│ ├─ command/
│ ├─ components/
│ ├─ rendering/
│ ...
└─ CMakeLists.txt
```
---
## 🌱 Current Status & Roadmap
- Basic workflow (load → extract → animate → export) is functional.
- UI/UX is still evolving; certain settings may not persist.
- More polishing around frame detection and color swapping is planned.
---
## 🙌 Contributing
We welcome pull requests and issue reports! To contribute:
1. [Fork the repo](https://github.com/adia-dev/piksy/fork).
2. Create a branch for your feature/bug fix.
3. Submit a PR for review.
> **Info**
> We value all feedback—whether it’s UI suggestions, performance tweaks, or big new features.
---
> **Thank you** for checking out Piksy! We hope to make your sprite editing journey easier and faster. Stay tuned for updates!