Skip to content

lmmtrr/spive2d

Repository files navigation

Spive2D

English | 日本語 | 中文

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)
  • 🎭 Dual support for Spine & Live2D models
  • 🕹️ Real-time parameter controls
  • 🎨 Animation/Skin switching UI
  • 🖱️ Mouse interaction support
  • 🖥️ Cross-platform (Windows/macOS/Linux)

⌨️ Keyboard Shortcuts

Action Shortcuts
📂 Previous Directory Q
📁 Next Directory W
⏮️ Previous Scene A
⏭️ Next Scene S
◀️ Previous Animation Z
▶️ Next Animation X
📷 Export Image R
🖼️ Export Image Sequence D
💾 Export Animation C
⚙️ Open/Close Settings E
📝 Append to List V
❌ Exit Ctrl/Cmd+W, Ctrl/Cmd+Q
  • Append to List: Saves the current scene text to a list. See py/copy_by_list.py for 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:

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:

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:

Setup Steps:

  1. Clone the repository:

    git clone https://github.com/lmmtrr/spive2d.git
    cd spive2d
  2. Install dependencies:

    npm install
  3. Run the development server:

    npm run tauri dev
  4. Build the application:

    npm run tauri build

🌐 Supported Versions

🦴 Spine Runtimes:

  • Spine 3.6-4.2

🎭 Live2D Cubism:

  • Cubism 2.1
  • Cubism 4.x

📦 Dependencies

📄 Licenses

MIT License

About

A simple Spine & Live2D viewer

Topics

Resources

License

Stars

Watchers

Forks

Packages