Skip to content

1.0.1

Choose a tag to compare

View all tags
@Saganaki22 Saganaki22 released this 17 Jul 00:56
· 31 commits to main since this release
v1.0.1
fd341c8

GNM Studio v1.0.1

GNM Studio combines Google GNM Head v3, MediaPipe Face Landmarker, Three.js, Rust, Tauri, and Vite into a standalone facial-animation and head-mocap studio.

Try the web edition:
https://drbaph.is-a.dev/GNM-Studio/

What’s new in v1.0.1

  • Fixed the web MP4 export button remaining disabled after recording Motion data.
  • Motion recordings can now be rendered locally into a silent avatar MP4.
  • Avatar video and Camera + avatar modes continue to support microphone audio.
  • Added rendering progress and clearer video-export messages.
  • Recording, playback, importing, and timeline controls are safely disabled while rendering.
  • Experimental skin microtexture is now disabled by default.
  • Existing users receive a one-time preference migration that resets microtexture to OFF.
  • Skin microtexture can still be enabled from Avatar → Skin material → Skin microtexture and the choice persists afterwards.
  • Updated application, executable, documentation, and portable-package versions to 1.0.1.

Main features

  • Google GNM Head v3 rendering and animation.
  • Local MediaPipe facial tracking with GPU and CPU options.
  • Webcam and microphone device selection.
  • Neutral-pose calibration with face-position guidance.
  • Mirrored camera and correctly mapped head movement.
  • Adaptive facial and head-motion smoothing.
  • Webcam, avatar, landmark, and overlay layer controls.
  • Manual expression sliders with individually frozen channels.
  • Animated jaw opening driven by mouth tracking.
  • Experimental five-tone skin material with scale, rotation, and seam-feather controls.
  • Custom solid, transparent, studio, and image backgrounds.
  • Blender-style orbit, pan, zoom, cardinal views, and reset controls.
  • Pointer-controlled scene lighting.
  • Motion, avatar-video, and camera-plus-avatar capture modes.
  • Seekable playback and Return to Live control.
  • JSON motion import/export.
  • Animated GLB export for Blender.
  • MP4 video export with adjustable video and audio bitrates.
  • Optional WebM source export.
  • Optional system FFmpeg support.
  • Dark/light themes, accent colours, and adjustable UI scale.
  • Local date-and-time filenames to prevent accidental overwrites.

Choose one portable download

You only need one of these ZIP files.

Download Recommended for Difference
GNM-Studio-1.0.1-Windows-x64-Portable.zip Most users Standard uncompressed executable. Best antivirus compatibility and recommended by default.
GNM-Studio-1.0.1-Windows-x64-Portable-UPX.zip Users who prefer a slightly smaller download Contains the same application compressed with UPX. It may start slightly slower and is more likely to trigger antivirus heuristic warnings.

Standard Portable

The Standard Portable package is recommended.

  • The executable is not packed with UPX.
  • It generally produces fewer antivirus false positives.
  • It contains exactly the same GNM Studio features.
  • No installer is required.

UPX Portable

The UPX package contains the same executable and resources, but the executable has been compressed using UPX 5.1.1.

  • Smaller executable and ZIP.
  • Functionally identical to the Standard Portable build.
  • Passed the UPX executable integrity test.
  • UPX-packed applications can trigger heuristic antivirus warnings because of their compressed executable layout.
  • If Windows Defender or another antivirus objects to it, use the Standard Portable ZIP instead.

How to run GNM Studio

  1. Download either the Standard Portable ZIP or the UPX Portable ZIP.
  2. Right-click the ZIP and select Extract All.
  3. Open the extracted folder.
  4. Run GNM-Studio-v1.0.1.exe.
  5. Allow camera or microphone access only if you want live tracking or audio recording.

Do not run the EXE directly from inside the ZIP. Extract the entire archive first.

GNM Studio does not require:

  • Python
  • CUDA
  • A Python virtual environment
  • A separate MediaPipe model download
  • An installer
  • Administrator access
  • Internet access after downloading the package

GNM Studio uses Microsoft Edge WebView2, which is normally already installed on supported Windows 10 and Windows 11 systems.

If Windows SmartScreen appears, verify that the file came from the official GNM Studio repository. You may then select More info → Run anyway if you trust the download.

Recording and MP4 export

GNM Studio provides three capture modes:

  • Motion data records editable facial and head-motion channels. It supports JSON, animated GLB, and silent avatar MP4 rendering.
  • Avatar video records the rendered GNM head and background. Microphone audio is included unless muted.
  • Camera + avatar records the enabled webcam and avatar layers as a composite video, with microphone audio unless muted.

When exporting Motion data as MP4, the avatar plays through the take once in real time while the browser records it. Keep GNM Studio or the browser tab visible until rendering completes.

MP4 conversion uses local WebCodecs when necessary. Desktop users can optionally configure a system FFmpeg installation under Encoder quality.

Blender export

Animated GLB is the recommended editable Blender format.

In Blender, use:

File → Import → glTF 2.0

The exported GLB includes the GNM mesh, animation, morph targets, jaw motion, and selected skin-material settings.

Alembic export is not included in this release.

Portable package checksums

Use Get-FileHash <filename> -Algorithm SHA256 in PowerShell to verify a download.

  • GNM-Studio-1.0.1-Windows-x64-Portable.zip
    SHA-256: 2ae69d99792c2e14112fa1e2708a51d9b6743bf0b1ec5fec6b078805aa65e9e9

  • GNM-Studio-1.0.1-Windows-x64-Portable-UPX.zip
    SHA-256: 08bab1b7e7776569ca7cce9b38190212419e77a42f9c84c030f57af23067aa89

Web edition limitations

The web edition supports facial tracking, expressions, recording, motion import/export, animated GLB, MP4/WebM export, materials, backgrounds, and most studio controls.

The native seeded GNM identity generator remains desktop-only. Browser MP4 support depends on the available H.264 WebCodecs encoder. A current Chromium-based browser such as Microsoft Edge or Google Chrome is recommended.

Validation

This release passed:

  • Frontend linting
  • Desktop production build
  • GitHub Pages production build
  • Static Pages asset validation
  • Four native Rust/Google GNM parity tests
  • FFmpeg integration test
  • Tauri release-mode compilation
  • UPX executable integrity verification
  • GitHub Actions CI for main and webapp-src
  • GitHub Pages deployment validation

License

GNM Studio is licensed under the Apache License 2.0.

Google GNM and MediaPipe remain subject to their respective upstream licenses. The experimental skin texture set was supplied under the MIT License. Additional third-party notices are included in THIRD_PARTY_NOTICES.md.

Credits

Assets 4
Loading