Spive2D
English | 日本語 | 한국어 | 中文 https://github.com/user-attachments/assets/c20288f2-75a5-4f1f-b8df-4532e65a2f7b A desktop application built with Tauri for viewing and interacting with Spine skeletal animations and Live2D models. Key Features:- 📂 Drag-and-drop model loading (single folder or single compressed file: zip or 7z only)
- 📦 Direct loading/extracting from Unity asset files
- 🎭 Triple support for Spine, Live2D, and Layered Sprite (Unity files only) models
- 🔍 Automatic alpha mode detection from the atlas pages (chooses between PMA and UNPACK only; an explicit NPM setting is never overwritten)
⌨️ Keyboard Shortcuts
| Action | Shortcuts | | ------------------------ | -------------------------- | | 📂 Previous Directory |Q |
| 📁 Next Directory | W |
| ⏮️ Previous Scene | A |
| ⏭️ Next Scene | S |
| ◀️ Previous Animation | Z |
| ▶️ Next Animation | X |
| 📷 Export Image | E |
| 🖼️ Export Image Sequence | D |
| 💾 Export Animation | C |
| 🦴 Export Model Files | R |
| ⚙️ Open/Close Settings | F |
| 📝 Append to List | V |
| 🖥️ Toggle Fullscreen | F11 |
| ❌ Exit | Ctrl/Cmd+W, Ctrl/Cmd+Q |
- Append to List: Saves the current scene text to a list. See
py/copy_by_list.pyfor processing the exported list.
🍎 Note for macOS Users
If the application displays a message saying it is damaged and cannot be opened, you may need to remove the quarantine attribute. Run the following command in your terminal: ``bash
xattr -dr com.apple.quarantine /path/to/spive2d_aarch64.app
`
🐧 Note for Linux Users
GUI Method:
To run the executable file, please turn on the "Executable as Program" toggle switch in the file properties and execute it with "Run as a Program".
Terminal Method:
Alternatively, you can grant execution permission and run the application from the terminal:
`bash
chmod +x /path/to/spive2d_linux_x64
./spive2d_linux_x64
`
🚀 Development
To set up a local development environment, you'll need to install the following tools.
Prerequisites:
- Bun: Install Bun
- Rust: Install Rust
- Tauri: Follow the Tauri setup guide for your specific OS.
Setup Steps:
- Clone the repository:
`bash
git clone https://github.com/lmmtrr/spive2d.git
cd spive2d
`
- Install dependencies:
`bash
bun install
`
- Run the development server:
`bash
bun run tauri dev
`
- Build the application:
`bash
bun run tauri build
``
🌐 Supported Versions
🦴 Spine Runtimes:- Spine 3.6-4.3
- Cubism 2.1
- Cubism 3.x - 5.x
- Unity Sprite / RectTransform bundles