Skip to content

README.md

Latest commit

 

History

History
66 lines (49 loc) · 1.38 KB

README.md

File metadata and controls

66 lines (49 loc) · 1.38 KB

Pond

An interactive ambisonic sound installation where audience members walk through a physical space and tap their phones to create water droplet sounds at their tap location.

Architecture

Mobile Phones (Svelte PWA)
        │
        │ WebSocket (JSON)
        ▼
┌─────────────────────────┐
│  pond-server (Rust)     │
│  ├─ WebSocket Server    │
│  ├─ DSP Graph (bbx_dsp) │
│  └─ Audio Output        │
└───────────┬─────────────┘
            │
            ▼
   Ambisonic Speakers

Project Structure

pond/
├── pond-server/    # Rust backend (WebSocket server + DSP)
└── pond-web/       # Svelte 5 frontend (mobile PWA)

Quick Start

Prerequisites

  • Rust (edition 2021)
  • Node.js + Yarn

Linux Dependencies

sudo apt install libasound2-dev libssl-dev pkg-config

Running

  1. Start the server:

    cd pond-server
cargo run --release

  2. Start the web app:

    cd pond-web
yarn install
yarn dev

  3. Open the web app on a mobile device connected to the same network

See the individual README files in each subproject for more details.

Tech Stack

  • Backend: Rust, bbx_dsp, bbx_net, rodio, tokio
  • Frontend: Svelte 5, TypeScript, Vite, @bbx-audio/net