Video.mp4
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)
| Action | Shortcuts |
|---|---|
| ⚙️ Open/Close Settings | Q |
| 🗂️ Open/Close Thumbnails | W |
| ⏮️ Previous Scene | A |
| ⏭️ Next Scene | S |
Z |
|
X |
|
| ⏯️ Play/Pause | Space |
| 📷 Export Image | E |
| 🖼️ Export Image Sequence | D |
| 💾 Export Animation | C |
| 🦴 Export Model Files | R |
| 📝 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.
Hold Ctrl (Cmd on macOS) over the model to list what is under the cursor (Spine and Live2D only). What is listed depends on what the sidebar currently shows:
| Sidebar shows | Listed items | ← / → |
|---|---|---|
| Parameters | Parameters that move the visible meshes under the cursor, with their values | Decrease / increase the value |
| Parts (Live2D) | Whole parts, including hidden ones | Toggle visible/hidden |
| Anything else | Individual meshes (Spine attachments, Live2D Drawables), including hidden ones | Toggle visible/hidden |
| Action | Input |
|---|---|
| 📋 Show the list | Hold Ctrl |
| 🔼 Select an item | ↑ / ↓ (holding Ctrl) |
| 🔁 Toggle visible/hidden | ← / →, Enter or Ctrl+Click |
| 🎚️ Adjust a parameter | ← / → (hold to repeat) |
- Meshes/parts:
●marks a visible item and○a hidden one. The selected item's region is highlighted; a hidden item is shown as an outline. The selection starts at the front-most visible item, or the back-most hidden item if nothing visible is under the cursor. - Parameters: the region the selected parameter moves is highlighted. Each press changes the value by 1/50 of its range.
- Changes made here are also reflected in the sidebar's list.
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:
xattr -dr com.apple.quarantine /path/to/spive2d_aarch64.appGUI 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:
chmod +x /path/to/spive2d_linux_x64
./spive2d_linux_x64To 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:
git clone https://github.com/lmmtrr/spive2d.git cd spive2d -
Install dependencies:
bun install
-
Run the development server:
bun run tauri dev
-
Build the application:
bun run tauri build
🦴 Spine Runtimes:
- Spine 3.6-4.3
🎭 Live2D Cubism:
- Cubism 2.1
- Cubism 3.x - 5.x
🖼️ Layered Sprite:
- Unity Sprite / RectTransform bundles