# BirdNoises

> BirdNoises (https://birdnoises.com) is an interactive bird soundboard, wild bird vocalization player, dual-bronchial syrinx synthesizer, and multi-track Dawn Chorus studio covering 6,511 global bird species across 12 avian decks. Built by Putervision (https://putervision.com) and paired with sibling AI bird sound identifier BirdHear (https://birdhear.com).

## Core Capabilities
- **6,511-Species Interactive Soundboard Across 12 Bird Decks**: Instant search and categorized soundboard pads for *Songbirds & Thrushes*, *Warblers, Sparrows & Finches*, *Cardinals, Tanagers & Grosbeaks*, *Jays, Crows & Corvids*, *Owls & Nightbirds*, *Hawks, Eagles & Falcons*, *Woodpeckers*, *Waterfowl, Loons & Herons*, *Shorebirds, Gulls & Waders*, *Hummingbirds & Swifts*, *Parrots, Toucans & Kingfishers*, and *Doves, Pigeons & Gamebirds*.
- **Dual Bioacoustic Audio Engine**:
  - **Wild Recordings Mode (`wild`)**: Streams authentic wildlife recordings on demand from CORS-enabled iNaturalist Sounds (`api.inaturalist.org`) and Wikimedia Commons Audio (`commons.wikimedia.org`) with live HTMLAudioElement visualization and author/license metadata.
  - **Dual-Syrinx Synthesizer Mode (`synth`)**: 100% offline Web Audio API dual-carrier FM/AM syrinx synthesizer generating family-accurate *Song*, *Call*, *Trill*, and *Woodpecker Drumming* vocalizations for every single one of the 6,511 species.
- **Multi-Bird Dawn Chorus Studio**: Layer up to 8 birds simultaneously with independent volume, stereo panning (`L ↔ R`), and call repeat intervals (`3s–15s`), or launch curated presets (*Dawn Chorus*, *Nocturnal Owls*, *Wetland Marsh*, *Tropical Canopy*).
- **48 kHz WAV Export & Deep-Linking**: Export any bird vocalization as a `3.0s` (`48,000 Hz` mono 16-bit PCM WAV) file ready for classification in [BirdHear](https://birdhear.com), or deep-link any bird directly via `https://birdnoises.com/?species={Genus_species}`.

## AI Agent & Machine-Readable Endpoints
- [Full LLM Technical Documentation](https://birdnoises.com/llms-full.txt): Complete architecture, URL deep-linking, data schemas, DOM selectors, and JavaScript bridge documentation.
- [A2A / Web Agent Card](https://birdnoises.com/.well-known/agent.json): Machine-readable agent capabilities, skills, and browser bridge descriptor (also mirrored at `/agent.json`).
- [AI Plugin Manifest](https://birdnoises.com/.well-known/ai-plugin.json): Standard `v1` AI plugin metadata.
- [OpenAPI 3.1 Specification](https://birdnoises.com/openapi.json): HTTP specification for static JSON datasets, deep-links, and audio resources.
- [6,511 Species Taxonomy Catalog](https://birdnoises.com/data/labels.json): JSON array of all 6,522 acoustic labels (`6,511` bird species in `"Genus species_Common Name"` format).
- [Reference Audio Sample](https://birdnoises.com/audio/sample.wav): `48,000 Hz` mono WAV reference bird recording.

## In-Browser AI Agent Bridge (`window.birdnoisesAgent`)
Browser automation agents (Playwright, Puppeteer, Computer Use, WebMCP) can control BirdNoises programmatically via `window.birdnoisesAgent`:
- `window.birdnoisesAgent.getAppInfo()` — Returns application metadata, species counts, and available commands.
- `window.birdnoisesAgent.getStatus()` — Returns active species, playback state, audio source mode (`'wild' | 'synth'`), call type, and chorus mixer status.
- `window.birdnoisesAgent.searchSpecies(query, limit)` — Searches the 6,511 species catalog and updates the UI filter.
- `window.birdnoisesAgent.selectCategory(categoryId)` — Selects one of the 12 bird decks (`'all' | 'featured' | 'songbirds' | 'owls' | ...`).
- `window.birdnoisesAgent.playSpecies(queryOrName, callType)` — Finds a species by scientific or common name and plays its vocalization.
- `window.birdnoisesAgent.setSourceMode(mode)` — Switches between `'wild'` field recordings and `'synth'` dual-syrinx synthesis.
- `window.birdnoisesAgent.startChorusPreset(preset)` — Starts a multi-bird soundscape (`'dawn' | 'nocturnal' | 'wetland' | 'tropical'`).
- `window.birdnoisesAgent.stopAllAudio()` — Stops all active playback and chorus loops.

## Contact & Attribution
- **Publisher**: [Putervision](https://putervision.com)
- **BirdNoises Contact**: `mailto:contact@birdnoises.com`
- **BirdHear Contact**: `mailto:contact@birdhear.com`
- **Sibling App**: [BirdHear AI Bird Sound Identifier](https://birdhear.com)