GeoBuzz
Spatial Music and Audio Composition Tool, where the listener is the playhead.
Compose walkable musical pieces where arrangement happens in geographic space. Create location-based audio experiences that respond to listener's position and speed. Export the compositions and the engine as standalone web application and create your own user interface.
Two-Part System
┌─────────────────────────┐
│ GeoBuzz Editor │ ← Create and edit buzzes
│ (Full UI + Tools) │
└────────────┬────────────┘
│ Export Package
▼
┌─────────────────────────┐
│ RuntimeEngine │ ← Lightweight player
│ (Audio + Spatial) │ Custom UI ready
└─────────────────────────┘
Quick Start
Open the GeoBuzz Editor or download the files and launch it on your machine.
Creating a Buzz
- Use the element menu or double click on the map to place sounds
- Configure sound type and parameters
- Add effects, draw paths (optional)
- Test with GPS or simulation mode
- Export as standalone package
See the Docs for more.
Running the Editor
Serve the project via any web server and open in browser. ES modules require HTTP(S) — opening index.html directly via file:// will not work. Mobile devices require HTTPS for location/orientation.
Data is stored locally in the browser using IndexedDB. Each workspace gets a unique URL you can bookmark to return later. All actions are automatically saved.
Private/incognito mode: IndexedDB data is discarded when the browser window closes. Workspace URLs from private sessions cannot be opened in normal mode. Some browsers restrict IndexedDB access in private mode, which may prevent file uploads from working.
Data persistence: On Safari, IndexedDB may be evicted after 7 days if the user hasn't visited the origin.
It's best to regularly save Buzz zip to be sure.
Shared Workspaces Version
The limitations don't concern the server version. A server-based shared workspaces version is available as a drop-in kit (see server-kit/). Besides collaborations and data persistence, it enables easier mobile testing and publishing to the workspace.
See it live at GeoBuzz.app
Note that workspaces that have been unused for more than 7 days are automatically deleted on that site.
For a permanent hosted setup, run the app on your own server locally or remotely.
Sponsoring the project helps me maintain and improve the app, and eventually provide a stable hosted solution.
Sound Types
Synthesizers: Synth, FMSynth, AMSynth, FatOscillator, NoiseSynth
Samplers: SoundFile, Sampler, StreamPlayer
Paths
- Movement Paths - Sound follows user along path
- Control Zones - Trigger sounds or modulate parameters
- Modulation Paths - LFO-based parameter automation
Distance Sequencers
Step sequencers that advance based on walking distance rather than time. Create rhythmic patterns and note progressions that play as you move through space.
Exporting & Deploying
Click "Export Package" in the editor. The ZIP contains:
my-buzz.zip
├── buzz.json # Buzz data
├── index.html # Player (customize this)
├── player-styles.css # Styles (customize this)
└── src/ # Runtime engine
Deploy: Extract, upload to any HTTPS web server, open in browser.
RuntimeEngine API
import { runtimeEngine } from './src/runtime/RuntimeEngine.js';
await runtimeEngine.initialize({ mapContainer: document.getElementById('map') });
await runtimeEngine.loadBuzz(buzzData);
await runtimeEngine.start();
runtimeEngine.stop();
runtimeEngine.dispose();
Study the examples to know more.
Examples
Working examples in examples/:
Project Structure
src/
├── core/ # Shared core modules
│ ├── audio/ # Audio processing
│ ├── state/ # State management
│ ├── geospatial/ # Spatial calculations
│ └── utils/ # Utilities
│
├── runtime/ # RuntimeEngine
│
├── ui/ # Editor UI
├── interactions/ # Editing tools
├── events/ # Event handling
├── selection/ # Selection management
├── layers/ # Layer management
├── paths/ # Path processing
├── shapes/ # Shape handling
├── map/ # Map management
├── simulation/ # Route simulation
├── config/ # Configuration
├── persistence/ # Save/load/export
├── api/ # LocalBackend (IndexedDB storage)
└── debug/ # Debug tools
Requirements
- Modern browser (Chrome, Firefox, Safari, Edge)
- HTTPS for geolocation and orientation features
- Web server for ES6 modules
Resources
The main body of work took approximately five months of daily AI-assisted development. I primarily used Claude, with occasional support from ChatGPT for prototyping and process design. I have run code cleanliness, performance and security reviews, and best practice checks at different stages of the development process. I have tried to produce the application to the best of my abilities, and welcome all suggestions for improvement.
Vision
GeoBuzz aims to pioneer spatial music composition as a new creative genre — where geography, movement, and sound merge into location-aware musical experiences. We hope to grow a community of composers, developers, and sound artists exploring this space together.
See created works at geobuzz.app/gallery
Support GeoBuzz
If you enjoy using GeoBuzz, you can support its development:
Thank you for helping keep GeoBuzz alive and growing!
See Sanara Creations for my multidisciplinary work, both solo and in collaboration with others.
