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).


  Contains executable files or external scripts. Ensure you trust the creator and apply your own security measures.
React to this content...

Share this resource

Back
Top Bottom