Avatar Remote is a planned local bridge and mobile web interface for controlling active VRChat avatar parameters through OSC and OSCQuery.
Current status: Avatar Remote has its repository foundation, typed workspace, protocol simulator, and an in-process local bridge core. It has no realtime API, HTTP, WebSocket, OSC, OSCQuery, VRChat communication, or mobile UI.
Avatar Remote is intended to let a mobile browser communicate with a local desktop bridge, which will in turn control active VRChat avatar parameters. The project is planned as a local-first system: its normal operation should stay on the local machine or explicitly paired local network devices.
The planned product has two primary parts:
- Desktop Bridge: a local service that will manage the browser-facing API, session security, and VRChat adapter integration.
- Mobile Web Interface: a browser-based interface intended for paired local devices.
See the planned architecture for the approved direction. It describes future components, not implemented software.
This repository provides deterministic validation, typed package boundaries, parameter and protocol contracts, a local protocol simulator, a transport-free bridge core, and an output-only adapter interface. No live VRChat communication or network transport is implemented.
The next planned objective is v0.1.1 — Realtime Bridge API. Later work
includes OSC and OSCQuery integration, authenticated pairing, a mobile web
interface, avatar profiles, and Windows packaging. These capabilities are not
available yet; the approved sequence is in the roadmap.
The intended security model is localhost-first, with local-network access as an explicit opt-in protected by pairing and per-device sessions. It does not yet exist in code. Read the planned technical model and the vulnerability reporting policy.
Contributions are welcome once they follow the repository workflow in CONTRIBUTING.md. Public documentation must distinguish implemented behavior from planned behavior.
The project has no delivery-date promises. See docs/ROADMAP.md for the approved releases and their explicit exclusions.
Avatar Remote is licensed under the MIT License.
Avatar Remote is an independent, unofficial project and is not affiliated with or endorsed by VRChat Inc.