voca.vc

Open-source WebRTC voice chat. Ephemeral rooms. No auth. Pure P2P.

Features

• 🔒 Zero Persistence — No data stored, no accounts
• 🌐 Pure P2P — Audio never touches the server (WebRTC mesh)
• ⚡ Instant — One-click room creation
• 🔐 Encrypted — DTLS-SRTP for all audio
• 🔑 Optional Passwords — Protect rooms with alphanumeric passwords
• 📱 Responsive — Works on desktop and mobile

SDK Packages

Package	Description
@treyorr/voca-client	Core TypeScript SDK
@treyorr/voca-react	React hooks
@treyorr/voca-svelte	Svelte 5 runes wrapper

Quick Install

bun install @treyorr/voca-client
# or for frameworks:
bun install @treyorr/voca-react    # React
bun install @treyorr/voca-svelte   # Svelte 5

Usage Example (React)

import { useVocaRoom } from '@treyorr/voca-react';

function VoiceRoom({ roomId }) {
  const { status, peers, toggleMute, isMuted } = useVocaRoom(roomId, {
    password: 'secret123' // Optional: protect room with password
  });
  return (
    <button onClick={toggleMute}>{isMuted ? 'Unmute' : 'Mute'}</button>
  );
}

📖 Full Documentation →

---

Self-Hosting

Voca is designed for easy self-hosting with Docker. No database or external dependencies required.

📖 Self-Hosting Guide →

---

Development

With mise (recommended)

mise run dev

Manual

# Terminal 1: Signaling server
cd services/signaling && RUST_LOG=info cargo run

# Terminal 2: Web frontend
cd apps/web && bun install && bun run dev

Open http://localhost:5173

---

API

Endpoint	Auth	Description
POST /api/room?password=<pwd>	-	Create room (optional password) → {"room": "abc123", "password": "pwd"}
GET /api/room/{id}	-	Check if room exists → {"exists": true, "password_required": false}
GET /ws/{id}?password=<pwd>	-	WebSocket signaling (password required if room protected)
GET /api/admin/rooms	Bearer	List all rooms
GET /api/admin/metrics	Bearer	Usage metrics

---

Contributing

1. Fork the repo
2. Create a branch: git checkout -b my-feature
3. Make your changes and run mise run lint
4. Submit a PR

Please read our Code of Conduct first.

---

Documentation

• voca.vc/docs — Full SDK and Self-Hosting documentation

---

License

MIT