Open-source VRM desktop companion — transparent always-on-top overlay with VRMA motion and real-time lip sync. This release ships Motion Deck one-shot hotkeys, a validated stage command layer, custom .vrma folders, leaner environment pickers, and production builds that keep trial custom/ media out of the installer.
Download
- Windows (x64): AVATAR-Setup-0.7.0.exe
Drag the glass bar to move; use Gear for Appearance, Voice, Camera, Animations, and Settings. Bind one-shot gestures under Settings → Motion.
Install options
- Windows installer (easiest) — no Node.js
- From source:
cd avatar
npm install
npm run desktop- Web / contributors:
npm run dev→ http://localhost:5173
What's new
Motion Deck (#24, #51)
- Settings → Motion: shortlist clips, bind chords (or click a row), play once, then return to the Gear → Animations selection without touching
animationId - Authored shortlist (not a catalog-row table); unavailable cards kept across folder switches; Clear unavailable is the only sweep
- Keys live only while the AVATAR window has focus
Stage command layer (#6, #50, #51)
- Validated entry point for
animation.play/animation.default/avatar.set/environment.set/audio.source animation.playmode: onceoverlays a single pass;animation.stopends one early — shared surface for hotkeys, the agent bus, and keyword triggers- Fix: re-selecting the avatar already on stage no longer hides the companion
Custom animations & environments (#13, #22, #23, #44, #45, #49)
- Settings → Directories → Animations accepts a custom
.vrmafolder (replace semantics) - Environment pickers use still posters; custom-folder images load one at a time for the stage
- Production builds omit local
custom/environment trial media by default
Docs & maintainer tooling (#28, #47)
- Maintainer release checklist
- Roadmap regrouped; README badge cleanup (VRM Docs → vrm.dev/en)
Notes
- Installer is unsigned — SmartScreen may warn (More info → Run anyway)
- Hub characters stay session-only (not written to disk /
config.yaml) - Sample VRM/VRMA assets retain upstream licenses (VRoid / pixiv) — see Assets & credits
- Full notes: CHANGELOG · v0.7.0 docs
Contributors
Thanks @AUDOSt0ck1ng for Motion Deck, the stage command layer, custom animations, environment picker posters, and the production custom/ embargo — and @rosspeili for the release checklist, roadmap/docs, and release packaging.