Skip to content

mxpro1996/spive2d-android

 
 

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
⚙️ Open/Close Settings E
📷 Export Image R
🖼️ Export Image Sequence D
💾 Export Animation C
📝 Append to List V
  • 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 (try porting to Android)

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • JavaScript 97.1%
  • Svelte 1.8%
  • Other 1.1%