Contains executable files or external scripts. Ensure you trust the creator and apply your own security measures.
VaM Remote Studio (v1.3.1) connects Virt-A-Mate to a live Web Control Studio, HD Camera Streamer, and Concurrent Lisp Scripting Engine (DSL) — letting you control characters, bones, physics, morphs, plugins, and Timeline animations from any browser (desktop, tablet, or phone on your LAN) and automate multi-character scenes with simple, readable scripts.
KEY HIGHLIGHTS
•
Live HD Web Cam & Streamer:
View or stream supersampled shots (Selfie, Full Body, Feet, VaM View, or any scene WindowCamera atom) right in your browser with mouse-drag orbit, zoom, and world-lock.
•
7 Interactive Control Tabs:
1.
Pose: One-click preset poses, custom pose presets, arm tuning, Ragdoll toggle, IK controller sync & physics repair.
2.
Move: In-place turning and directional stepping with adjustable distance and duration.
3.
Nudge: Fine controller & live physical
Bone nudging/rotation (bone:rHand, raw DAZBones like bone:rIndex3) with live bone-vs-controller drift readout and IK On/Off toggles.
4.
Spawn: Spawn Person characters or any VaM atom type (Sphere, WindowCamera, CustomUnityAsset, lights, props) relative to any body part or bone.
5.
Morphs: Fast keyword search (>2 chars) across expressions/body morphs with live sliders and one-click expression/all resets.
6.
Plugins: Browse & load .cs / .cslist plugins from Custom/Scripts and .var packages, fire triggers, and edit plugin UI sliders/toggles/choosers remotely.
7.
Timeline: Search indexed Timeline animations across standalone files, .vap presets, and scenes, load/merge clips, and control Play, Pause, Stop, Reset, and live Speed.
•
Built-in Lisp DSL Studio, Player/VR Tracking & Procedural Locomotion:
Includes walk.lisp for procedural walking (walk_forward, turn_to_face, walk_around, obstacle-avoiding path_walk, sit_down, kneel_down), a built-in player target (letting actors sense and react to the live player's position, head/gaze direction, and VR hands with automatic hands-down fallback), collision sensors (is_sensor_on), Unity raycast, physics impulse, [x y z] vector & { ... } infix math, and multi-character (subprocess ...) threads.
WHAT'S NEW IN v1.3.1
•
HTTPS-Only by Default (TLS 1.2+): Auto-generates a local self-signed certificate in ~/.vam_tls/ with SHA-256 fingerprint verification, automatic plain-HTTP -> HTTPS redirect, Secure HttpOnly SameSite=Strict cookies, and localhost-only VaM plugin TCP port (35329).
•
Built-In MP4 Video Recording: (start-record-video "demo.mp4" :show-dsl true) records real-time H.264 MP4 showcase videos directly from VaM (saved on the server host, defaulting to videos/) with an optional live high-level DSL command overlay banner and auto-stop safeguards.
•
All Speech Over TCP: .wav clips stream directly with zero dependencies, and .mp3/.ogg clips transcode server-side via FFmpeg over the same TCP channel (removing the need for VaM Web access).
•
Safer Remote CLI (vam_dsl.py): Defaults to HTTPS with automatic local cert verification on localhost and interactive first-connect SHA-256 TOFU confirmation ([y/N]) + --fingerprint / --cafile for remote Linux/macOS/Windows clients.
QUICK START & INSTALLATION
1. Install Python & Tools (No pip packages required!)
The studio server uses 100% standard-library Python 3.8+ (zero pip dependencies to install).
On Windows, open PowerShell or Command Prompt and install Python (plus OpenSSL for automatic HTTPS certificate generation, and optional FFmpeg) using Windows' built-in winget package manager:
winget install -e --id Python.Python.3.12
winget install -e --id ShiningLight.OpenSSL.Light (skip if Git for Windows is installed)
winget install -e --id Gyan.FFmpeg (optional: MP4 video recording & .mp3/.ogg speech)
(Open a new terminal after winget installs so PATH is updated. On macOS: brew install openssl ffmpeg. On Linux: sudo apt install openssl ffmpeg.)
2. Install the .var Plugin & Companion Server Folder
2.1. Place dx9ko.VamRemoteControl.1.var in your <VaM_Folder>/AddonPackages/ directory.
2.2. Create a folder on your PC and unzip dx9ko.VamRemoteControl.v1.3.1.zip directly into it.
3. Start the Web Studio Server (HTTPS)
Double-click run_control_server.bat (or run "python server.py" in a terminal inside that folder).
• Your browser will open https://localhost:8080 (HTTPS-only, bound to 127.0.0.1 by default for security). On your first visit with the auto-generated local self-signed certificate, verify the SHA-256 matches the console banner and click Advanced -> Proceed once (or pass your own certificate with --tls-cert / --tls-key).
• On first launch, the server creates a persistent access token in your user home folder (~/.vam_token, i.e., C:\Users\<name>\.vam_token on Windows). On the same PC (localhost), the Web UI and vam_dsl.py authenticate automatically with zero extra steps.
• Optional LAN Mode: To control VaM from a phone, tablet, or second computer on a trusted home LAN over HTTPS, run "python server.py --lan". In the remote browser, verify the certificate SHA-256 matches the server banner, click Advanced -> Proceed, and enter the token from ~/.vam_token once into the
Token box in the Web UI top bar. Remote vam_dsl.py prompts [y/N] once on first interactive connect to verify and pin the fingerprint in ~/.vam_known_hosts (or pass --fingerprint / --cafile).
4. Load the Plugin in Virt-A-Mate
4.1. In VaM, open User Preferences -> Security and make sure Plugins are enabled.
4.2. Select or add an Empty atom in your scene.
4.3. Open Plugins -> Add Plugin -> Select File and choose:
dx9ko.VamRemoteControl.1:/Custom/Scripts/dx9ko/VamRemoteControl/RemotePoseServer.cs
(There are two .cs files in the package — you can load both; RemoteReloadControl.cs helps reload RemotePoseServer.cs remotely from the Web UI.)
4.4. As soon as it loads, the top-right badge in the Web Studio will turn green (Connected) and list all atoms in your scene.
4.5. Optional: Save the scene so you can skip the Add Plugin process in the future.
RECOMMENDED WAY TO EXPLORE & LEARN
1. Play with the Web Browser Controls First:
Start by clicking around the 7 tabs in the Web UI — try preset poses, nudge a hand or head, search a facial morph, or load and play a Timeline animation while watching the Web Cam preview.
2. Learn the DSL Effortlessly from the Log Window:
Keep an eye on the Command & Exec Log panel at the bottom right of the Web UI. Every button or slider you use in the Web UI prints its exact Lisp DSL command — for example, (pose "hands_down" :dur 0.8) or (node "rHandControl" "nudge" 0 0.1 0 :dur 0.4). You don't have to memorize syntax — just click a control in the UI and see the code it generates!
3. Run & Remix the Starter Script (shakehands-test.lisp):
• In the DSL Editor at the bottom center, dsl-scripts/shakehands-test.lisp is pre-loaded (it safely spawns two new characters without deleting your existing scene, walks them toward each other concurrently, and uses hand collision sensors to shake hands).
• Click
Execute Script (Ctrl+Enter) to watch it run!
• Then copy and paste commands you discovered in the Log Window into the editor, highlight a few lines, and click
Execute Lines (Shift+Enter) to test them interactively.
4. Dig into the Full Documentation (DSL_REFERENCE.md):
• Click the
DSL Reference button in the top bar of the Web Studio (or open DSL_REFERENCE.md) for a complete, searchable guide covering all commands, coordinate spaces, bone targeting ("bone:..."), player/VR tracking (player), procedural walking, raycasting, physics impulses, lip-synced .wav speech, video recording, and concurrent scripting.
NETWORK, LOCAL FILE ACCESS & EXTERNAL TOOLS (HOW IT WORKS & WHY)
Because VaM Remote Studio is designed as a remote controller and scripting studio, it uses local network sockets, reads/writes specific files on disk, and optionally invokes local CLI tools. Here is exactly what it does and why:
1. Network Design & HTTPS + Persistent ~/.vam_token Security:
• In-Game C# Plugin (RemotePoseServer.cs & RemoteReloadControl.cs):
Connects as a local TCP client (default 127.0.0.1:35329, configurable in the plugin UI) to your companion Python server (server.py) to receive pose/scene commands and send back camera frames. It never connects to any external internet server and requires no VaM Web access.
• Companion Python Server (server.py):
Serves the Web Studio UI and REST/DSL API over HTTPS only (TLS 1.2+, auto-generated self-signed certificate in ~/.vam_tls/) on port 8080 and listens for VaM on TCP port 35329, both bound to 127.0.0.1 by default (passing "--lan" exposes HTTPS on 0.0.0.0:8080 while keeping TCP port 35329 on 127.0.0.1). On first launch, it saves a persistent random token to ~/.vam_token (C:\Users\<name>\.vam_token on Windows) and enforces Host header allowlisting (DNS rebinding protection), same-origin checks, HttpOnly Secure SameSite=Strict cookies, and JSON-only POST requests to block cross-site browser access.
2. Local File Read / Write Operations & External Programs:
• Inside Virt-A-Mate (RemotePoseServer.cs):
Uses VaM's official sandboxed FileManagerSecure API (zero System.IO or System.Reflection) strictly to list and load VaM resources inside your VaM folder and .var packages — plugins (Custom/Scripts), appearance presets (Custom/Atom/Person/Appearance & Saves/Person/appearance), CustomUnityAsset bundles (Custom/Assets), sounds (Custom/Sounds), and Timeline animations (Saves/PluginData/animations, .vap, .json).
• Inside the Companion Python Server & User Home Directory:
- TLS & Auth State (~/.vam_token, ~/.vam_tls/server.crt & server.key, ~/.vam_known_hosts): Persists your API access token, auto-generated local TLS certificate/key, and pinned remote server fingerprints for vam_dsl.py.
- DSL Scripts (dsl-scripts/ & dsl-lib/): Sandboxed reading and saving of .lisp script files for the Web UI DSL Editor and (import ...).
- Resource Search Cache (vam_cache.db): Local SQLite index of your discovered VaM appearances, plugins, assets, and Timeline clips for instant searching in the Web UI.
- Speech Audio (audio/ & audio/.cache/): Sandboxed reading of local .wav/.ogg/.mp3 files used by (speak ...) to stream lip-synced speech into VaM over TCP.
- Camera Snapshots & Video Recordings (web/latest_selfie.jpg, shots/, videos/*.mp4, and system temp dir): Writes camera snapshots when captured and H.264 MP4 recordings when (start-record-video ...) is used (staging JPEG frames in the system temp dir during recording, and preserving them if encoding fails).
• External CLI Programs Invoked Locally (no shell=True):
- openssl: Invoked once on first startup to generate the local self-signed TLS certificate in ~/.vam_tls/ (skipped if --tls-cert / --tls-key are supplied).
- ffmpeg / ffprobe (optional): Invoked for (start-record-video ...) MP4 encoding and for transcoding/probing .mp3/.ogg speech clips to WAV.
CREDITS, ACKNOWLEDGMENTS, LICENSE & AI DISCLOSURE
• License (see LICENSE.txt):
- In-Game VaM C# Plugin Package (dx9ko.VamRemoteControl.1.var): CC BY-SA 4.0 (Creative Commons Attribution-ShareAlike 4.0 International).
- Companion Web Control Studio & Lisp DSL Engine (dx9ko.VamRemoteControl.v1.3.1.zip): CC BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0 International).
• Community Credits & Acknowledgments:
- MeshedVR: Creator of Virt-A-Mate and the MVRScript, SuperController, FreeControllerV3, DAZBone, JSONStorable, and FileManagerSecure APIs that power this plugin.
- AcidBubbles: Creator of Timeline (VamTimeline.AtomPlugin), which this tool optionally interoperates with at runtime via VaM's JSONStorable animation clip/playback interface when Timeline is installed.
• AI Assistance Disclosure:
- Developed by dx9ko with the assistance of AI coding and documentation tools (used to write, refactor, and document the C# plugin bridge, Python Web/DSL server, and reference manual).
•
View or stream supersampled shots (Selfie, Full Body, Feet, VaM View, or any scene WindowCamera atom) right in your browser with mouse-drag orbit, zoom, and world-lock.
•
1.
2.
3.
4.
5.
6.
7.
•
Includes walk.lisp for procedural walking (walk_forward, turn_to_face, walk_around, obstacle-avoiding path_walk, sit_down, kneel_down), a built-in player target (letting actors sense and react to the live player's position, head/gaze direction, and VR hands with automatic hands-down fallback), collision sensors (is_sensor_on), Unity raycast, physics impulse, [x y z] vector & { ... } infix math, and multi-character (subprocess ...) threads.
•
•
•
•
1. Install Python & Tools (No pip packages required!)
The studio server uses 100% standard-library Python 3.8+ (zero pip dependencies to install).
On Windows, open PowerShell or Command Prompt and install Python (plus OpenSSL for automatic HTTPS certificate generation, and optional FFmpeg) using Windows' built-in winget package manager:
winget install -e --id Python.Python.3.12
winget install -e --id ShiningLight.OpenSSL.Light (skip if Git for Windows is installed)
winget install -e --id Gyan.FFmpeg (optional: MP4 video recording & .mp3/.ogg speech)
(Open a new terminal after winget installs so PATH is updated. On macOS: brew install openssl ffmpeg. On Linux: sudo apt install openssl ffmpeg.)
2. Install the .var Plugin & Companion Server Folder
2.1. Place dx9ko.VamRemoteControl.1.var in your <VaM_Folder>/AddonPackages/ directory.
2.2. Create a folder on your PC and unzip dx9ko.VamRemoteControl.v1.3.1.zip directly into it.
3. Start the Web Studio Server (HTTPS)
Double-click run_control_server.bat (or run "python server.py" in a terminal inside that folder).
• Your browser will open https://localhost:8080 (HTTPS-only, bound to 127.0.0.1 by default for security). On your first visit with the auto-generated local self-signed certificate, verify the SHA-256 matches the console banner and click Advanced -> Proceed once (or pass your own certificate with --tls-cert / --tls-key).
• On first launch, the server creates a persistent access token in your user home folder (~/.vam_token, i.e., C:\Users\<name>\.vam_token on Windows). On the same PC (localhost), the Web UI and vam_dsl.py authenticate automatically with zero extra steps.
• Optional LAN Mode: To control VaM from a phone, tablet, or second computer on a trusted home LAN over HTTPS, run "python server.py --lan". In the remote browser, verify the certificate SHA-256 matches the server banner, click Advanced -> Proceed, and enter the token from ~/.vam_token once into the
4. Load the Plugin in Virt-A-Mate
4.1. In VaM, open User Preferences -> Security and make sure Plugins are enabled.
4.2. Select or add an Empty atom in your scene.
4.3. Open Plugins -> Add Plugin -> Select File and choose:
dx9ko.VamRemoteControl.1:/Custom/Scripts/dx9ko/VamRemoteControl/RemotePoseServer.cs
(There are two .cs files in the package — you can load both; RemoteReloadControl.cs helps reload RemotePoseServer.cs remotely from the Web UI.)
4.4. As soon as it loads, the top-right badge in the Web Studio will turn green (Connected) and list all atoms in your scene.
4.5. Optional: Save the scene so you can skip the Add Plugin process in the future.
1. Play with the Web Browser Controls First:
Start by clicking around the 7 tabs in the Web UI — try preset poses, nudge a hand or head, search a facial morph, or load and play a Timeline animation while watching the Web Cam preview.
2. Learn the DSL Effortlessly from the Log Window:
Keep an eye on the Command & Exec Log panel at the bottom right of the Web UI. Every button or slider you use in the Web UI prints its exact Lisp DSL command — for example, (pose "hands_down" :dur 0.8) or (node "rHandControl" "nudge" 0 0.1 0 :dur 0.4). You don't have to memorize syntax — just click a control in the UI and see the code it generates!
3. Run & Remix the Starter Script (shakehands-test.lisp):
• In the DSL Editor at the bottom center, dsl-scripts/shakehands-test.lisp is pre-loaded (it safely spawns two new characters without deleting your existing scene, walks them toward each other concurrently, and uses hand collision sensors to shake hands).
• Click
• Then copy and paste commands you discovered in the Log Window into the editor, highlight a few lines, and click
4. Dig into the Full Documentation (DSL_REFERENCE.md):
• Click the
Because VaM Remote Studio is designed as a remote controller and scripting studio, it uses local network sockets, reads/writes specific files on disk, and optionally invokes local CLI tools. Here is exactly what it does and why:
1. Network Design & HTTPS + Persistent ~/.vam_token Security:
• In-Game C# Plugin (RemotePoseServer.cs & RemoteReloadControl.cs):
Connects as a local TCP client (default 127.0.0.1:35329, configurable in the plugin UI) to your companion Python server (server.py) to receive pose/scene commands and send back camera frames. It never connects to any external internet server and requires no VaM Web access.
• Companion Python Server (server.py):
Serves the Web Studio UI and REST/DSL API over HTTPS only (TLS 1.2+, auto-generated self-signed certificate in ~/.vam_tls/) on port 8080 and listens for VaM on TCP port 35329, both bound to 127.0.0.1 by default (passing "--lan" exposes HTTPS on 0.0.0.0:8080 while keeping TCP port 35329 on 127.0.0.1). On first launch, it saves a persistent random token to ~/.vam_token (C:\Users\<name>\.vam_token on Windows) and enforces Host header allowlisting (DNS rebinding protection), same-origin checks, HttpOnly Secure SameSite=Strict cookies, and JSON-only POST requests to block cross-site browser access.
2. Local File Read / Write Operations & External Programs:
• Inside Virt-A-Mate (RemotePoseServer.cs):
Uses VaM's official sandboxed FileManagerSecure API (zero System.IO or System.Reflection) strictly to list and load VaM resources inside your VaM folder and .var packages — plugins (Custom/Scripts), appearance presets (Custom/Atom/Person/Appearance & Saves/Person/appearance), CustomUnityAsset bundles (Custom/Assets), sounds (Custom/Sounds), and Timeline animations (Saves/PluginData/animations, .vap, .json).
• Inside the Companion Python Server & User Home Directory:
- TLS & Auth State (~/.vam_token, ~/.vam_tls/server.crt & server.key, ~/.vam_known_hosts): Persists your API access token, auto-generated local TLS certificate/key, and pinned remote server fingerprints for vam_dsl.py.
- DSL Scripts (dsl-scripts/ & dsl-lib/): Sandboxed reading and saving of .lisp script files for the Web UI DSL Editor and (import ...).
- Resource Search Cache (vam_cache.db): Local SQLite index of your discovered VaM appearances, plugins, assets, and Timeline clips for instant searching in the Web UI.
- Speech Audio (audio/ & audio/.cache/): Sandboxed reading of local .wav/.ogg/.mp3 files used by (speak ...) to stream lip-synced speech into VaM over TCP.
- Camera Snapshots & Video Recordings (web/latest_selfie.jpg, shots/, videos/*.mp4, and system temp dir): Writes camera snapshots when captured and H.264 MP4 recordings when (start-record-video ...) is used (staging JPEG frames in the system temp dir during recording, and preserving them if encoding fails).
• External CLI Programs Invoked Locally (no shell=True):
- openssl: Invoked once on first startup to generate the local self-signed TLS certificate in ~/.vam_tls/ (skipped if --tls-cert / --tls-key are supplied).
- ffmpeg / ffprobe (optional): Invoked for (start-record-video ...) MP4 encoding and for transcoding/probing .mp3/.ogg speech clips to WAV.
• License (see LICENSE.txt):
- In-Game VaM C# Plugin Package (dx9ko.VamRemoteControl.1.var): CC BY-SA 4.0 (Creative Commons Attribution-ShareAlike 4.0 International).
- Companion Web Control Studio & Lisp DSL Engine (dx9ko.VamRemoteControl.v1.3.1.zip): CC BY-NC 4.0 (Creative Commons Attribution-NonCommercial 4.0 International).
• Community Credits & Acknowledgments:
- MeshedVR: Creator of Virt-A-Mate and the MVRScript, SuperController, FreeControllerV3, DAZBone, JSONStorable, and FileManagerSecure APIs that power this plugin.
- AcidBubbles: Creator of Timeline (VamTimeline.AtomPlugin), which this tool optionally interoperates with at runtime via VaM's JSONStorable animation clip/playback interface when Timeline is installed.
• AI Assistance Disclosure:
- Developed by dx9ko with the assistance of AI coding and documentation tools (used to write, refactor, and document the C# plugin bridge, Python Web/DSL server, and reference manual).
Contains executable files or external scripts. Ensure you trust the creator and apply your own security measures.