How receyuki/live2pet works
Live2Pet is a desktop authoring app that turns local or GitHub-hosted Live2D and Spine models into Clawd or Codex pet packages. The main workflow is browse/import, inspect and preview, map animations and visibility, then build and save or install. The graph includes project persistence, preview rendering, build/capture, target-specific output, and runtime setup. Several links reflect README-documented capabilities; unsampled source limits exact wiring for those branches.
Main entry points: main.cjs Electron main · src/index.cjs Package builder · src/index.cjs App host API · source-library-service.cjs Source library
Components 25
Model authoring
- Source library
apps/desktop/source-library-service.cjs - Source inspector
packages/source-inspector/src/index.cjs - Project workspace
apps/desktop/project-workspace-service.cjs - Project model
packages/project/src/index.cjs - Model renderer
packages/renderer/src/index.cjs
Desktop app
- Authoring UI
apps/desktop/ui/src/App.tsx - Preview session UI
apps/desktop/ui/src/preview-session.ts - Preview service
apps/desktop/preview-session-service.cjs - Electron main
apps/desktop/main.cjs - IPC bridge
packages/app-host/src/preload-api.cjs - App host API
packages/app-host/src/index.cjs
Build pipeline
- Package builder
packages/package-build/src/index.cjs - Frame capture
packages/package-build/src/capture-pipeline.cjs - Build cache
packages/package-build/src/cache.cjs
Targets and delivery
- Target preview
packages/package-build/src/preview.cjs - Clawd target
packages/clawd-target/src/index.cjs - Codex target
packages/codex-target/src/index.cjs - Package output
apps/desktop/package-output-service.cjs - Target installation
apps/desktop/target-installation-service.cjs
Runtime support
- Runtime settings
apps/desktop/main.cjs - Installation support
packages/installation/src/index.cjs - Spine renderer pack
apps/desktop/hosted-build-service.cjs
Other components
- Desktop user
- GitHub collection
- Clawd or Codex
Connections 29
- Desktop user → Authoring UI: authors in
- Desktop user → Source library: opens source
- GitHub collection → Source library: provides models
- Source library → Source inspector: inspects model
- Authoring UI → IPC bridge: sends commands
- IPC bridge → App host API: dispatches IPC
- App host API → Electron main: routes requests
- Electron main → Source library: creates library
- Electron main → Source inspector: inspects source
- Electron main → Project workspace: manages projects
- Project workspace → Project model: loads and validates
- Authoring UI → Preview session UI: controls preview
- Preview session UI → IPC bridge: requests preview
- Electron main → Preview service: hosts session
- Preview service → Model renderer: opens renderer
- Electron main → Model renderer: resolves renderer
- Electron main → Package builder: builds project
- Package builder → Frame capture: captures frames
- Package builder → Build cache: reuses assets
- Package builder → Clawd target: builds theme
- Package builder → Codex target: builds atlas
- Target preview → Clawd target: models behavior
- Electron main → Target preview: previews target
- App host API → Package output: saves package
- App host API → Target installation: installs package
- Target installation → Installation support: installs target
- Target installation → Clawd or Codex: updates pet
- Desktop user → Runtime settings: configures runtime
- Electron main → Spine renderer pack: resolves Spine pack