# Soundscape Atlas

> Find real field recordings on a world map and mix them into calm, editable soundscapes. Soundscape Atlas puts freely licensed field recordings from Wikimedia Commons on an offline world map — birdsong, rain, rivers, streets and machines, each with its licence, author and source. Mix them with generated rain, wind, water, fire, hum, drone and noise layers into an ambience scene with fades, slow automation, room reverb and a sleep timer, then export a WAV, a credits file or an editable scene. Nothing plays until you press Play.

Soundscape Atlas (Sound map & ambience studio) is a premium app of usefulweb.app (https://usefulweb.app/): a full program that runs in the browser. Its engine is deterministic and the same functions are exposed as tools, so an agent can compute exactly what the app shows.

## Use it
- Landing page: https://soundscape.usefulweb.app/
- Workspace (browser app): https://soundscape.usefulweb.app/app - open a project with https://soundscape.usefulweb.app/app#project=<base64url-encoded project JSON> or a template with https://soundscape.usefulweb.app/app#template=<id>
- Project file format (JSON Schema): https://soundscape.usefulweb.app/project.schema.json
- Tutorials: https://soundscape.usefulweb.app/tutorials
- JSON API: POST https://soundscape.usefulweb.app/api/v1/tools/<toolId>/calculate (catalog: https://soundscape.usefulweb.app/api/v1/tools)
- OpenAPI: https://soundscape.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://soundscape.usefulweb.app/mcp

## Engine tools
- [Soundscape Recording Search](https://soundscaperecordingsearch.usefulweb.app/): Find real, freely licensed sound recordings by place, category and keywords. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://soundscape.usefulweb.app/api/v1/tools/soundscape-recording-search/calculate · MCP tool `soundscape_recording_search`
- [Ambience Generator (rain, wind, stream, fire, hum, drone)](https://soundscapeambiencegenerator.usefulweb.app/): Synthesize rain, wind, water, fire, room hum or a drone as a seamless-loop WAV. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://soundscape.usefulweb.app/api/v1/tools/soundscape-ambience-generator/calculate · MCP tool `soundscape_ambience_generator`
- [Noise Generator (white, pink, brown)](https://soundscapenoisegenerator.usefulweb.app/): Make white, pink, brown, blue or violet noise as a WAV file and check its spectrum. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://soundscape.usefulweb.app/api/v1/tools/soundscape-noise-generator/calculate · MCP tool `soundscape_noise_generator`
- [Audio Spectrum Analyzer](https://soundscapespectrumanalyzer.usefulweb.app/): Upload audio and see its spectrum, peak frequencies, centroid, RMS/peak and waveform. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://soundscape.usefulweb.app/api/v1/tools/soundscape-spectrum-analyzer/calculate · MCP tool `soundscape_spectrum_analyzer`
- [Room Reverb for WAV Files](https://soundscapereverb.usefulweb.app/): Add room, hall, cathedral or cave reverb to a WAV file with a known reverberation time. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://soundscape.usefulweb.app/api/v1/tools/soundscape-reverb/calculate · MCP tool `soundscape_reverb`
- [Universal Audio Converter](https://audioconverter.usefulweb.app/): Convert MP3, WAV, FLAC, Ogg, Opus, M4A and AIFF with bitrate and sample-rate control. Part of [Reelcraft](https://reelcraft.usefulweb.app/) (ownerApp: reelcraft). API: POST https://soundscape.usefulweb.app/api/v1/tools/audio-converter/calculate · MCP tool `audio_converter`

## Formats
- Import: Soundscape Atlas scene (.soundscape.json), Share link (#project=), Audio from other apps (WAV, MP3, Ogg … via App Bridge or file)
- Export: WAV (16-bit stereo, 15 s – 10 min), MP3 (via the site’s audio converter), Credits and attribution (.txt), Soundscape Atlas scene (.soundscape.json), Share link, Soundwalk list (.txt)

## Limits
- Recordings come only from Wikimedia Commons; their availability, coordinates and metadata depend on Commons and can change or disappear.
- Licence and author data are copied from Commons as published and can be incomplete; the app does not verify them and you must check the file page before publishing.
- Sound category tags are a keyword guess from titles, descriptions and categories and can be wrong.
- Search results depend on Commons search; very large regions may be slow, and Commons sometimes answers “busy” — try again after a minute.
- Generated layers are physically motivated synthesis, not recordings; the murmur in café and tavern worlds is filtered noise, not real voices.
- WAV export is limited to 10 minutes and needs the recordings to be decodable in your browser; imported audio from other apps stays in this browser and is not part of share links.
- Ogg/Opus originals do not play in every browser; the app falls back to Wikimedia’s MP3 transcode when there is one.
- Playback timing follows your browser’s audio clock and may pause in background tabs on some phones.