# sociovoc

> sociovoc is a 2D spatial social video platform where participants move across interactive virtual lounges, hear voices attenuate naturally with distance, connect live WebRTC cameras within proximity, and enter server-isolated private rooms.

## Core Capabilities
- **Spatial Proximity Audio**: Real-time Web Audio API `GainNode` attenuation and `StereoPannerNode` left-right panning across configurable hearing radii (100 px to 500 px; default 200 px).
- **Proximity Video Mesh & TURN Relay**: Peer-to-peer WebRTC camera streams activate automatically inside awareness range (up to 6 prioritized streams) with multi-transport STUN/TURN fallback across separate networks and mobile connections.
- **Server-Authorized Private Pods**: Password-protected or invite-only rooms isolated at the signaling layer so outside participants never receive audio, video, screen shares, or chat.
- **Free Participant Access**: Attendees join shared spaces and live events free with zero attendee paywall; hosts can upgrade for larger capacities, organizations, or custom branding.
- **Privacy & Safety**: Pre-session camera/microphone consent, zero automatic call recording, local mute/hide/block controls, and host moderation.

## Proximity Zones
- **Immediate Zone (0 - 120 px)**: Highlighted video tiles with full stereo clarity.
- **Conversation Zone (121 - 300 px)**: Smooth distance-based volume attenuation and stereo panning.
- **Awareness Zone (301 - 500 px)**: Compact proximity previews before clean WebRTC disconnect outside range.
- **Private Pods**: Room-isolated audio, video, and text chat.

## Key Pages
- [Home](https://sociovoc-185152722593.us-east1.run.app/): Product overview, spatial zones, commercial use cases, and FAQ.
- [About](https://sociovoc-185152722593.us-east1.run.app/about): Architecture, spatial audio mechanics, WebRTC/TURN design, and privacy principles.
- [Public Worlds Directory](https://sociovoc-185152722593.us-east1.run.app/worlds): Browse and join live public lounges or enter a room code.
- [Pricing & Event Packages](https://sociovoc-185152722593.us-east1.run.app/pricing): Free tier, Creator/Organization/Business subscriptions, and one-time event packages.
- [Community Guidelines](https://sociovoc-185152722593.us-east1.run.app/community-guidelines): Conduct, consent, and safety tools.
- [Host an Event](https://sociovoc-185152722593.us-east1.run.app/events/create): Create a scheduled spatial networking event.

## Extended Context & Machine Discovery
- [Full Specification (llms-full.txt)](https://sociovoc-185152722593.us-east1.run.app/llms-full.txt)
- [Agentic Resource Discovery Manifest (ard.json)](https://sociovoc-185152722593.us-east1.run.app/.well-known/ard.json)
- [OpenAPI Specification (v1)](https://sociovoc-185152722593.us-east1.run.app/api/v1/openapi.json)
