KOPWASM

A Weather Atomspheric Sound Machine based on the Koppen Climate Classifications. Listen to the sound of our environment converted from real time data to synthesised instruments.

Works best on desktop devices for Mac and Windows.

Note for iOS/mobile users: If you hear no sound through your device speaker, ensure Silent Mode is turned off. Refresh the page and press the power on button to start/ restart. Audio will not continue if you switch apps or lock screen.

See full working code @ https://github.com/Coffeyb3an/kopwasm

See the user guide below the device.



# User Guide

### 1. Power On

Toggle the POWER switch in the top left to start the synthesiser.

### 2. Choose Your Sound

*Live Weather:** Type any city into the top search bar and press Enter to load live local weather into the synth.

*Presets:** Click any climate preset (**Tropical**, Arid, Temperate, Continental, Polar, Alpine) for instant soundscapes.

*Random mode:** Click Random to generate unexpected sound combinations.

### 3. Adjust the Faders

*Green Faders (Intensity):** Change sound character, pitch, tempo, and filters for each weather element.

*Grey Faders (Volume):** Control individual volume levels for Sun, Wind, Rain, Cloud, Humidity, and Temp.

*Master Slider:** Adjusts overall volume.

### 4. Save Favourites

*Save:** Click an empty slot (**1–5**) to save your current setup.

*Load:** Click a green saved slot to reload it.

*Clear:** Right-click (desktop) or press and hold for 0.6 seconds (mobile) to clear a slot.

### 5. Record Audio

Click RECORD & EXPORT 30S AUDIO to record a 30 second live snippet. A `.wav` file will download automatically when finished.

### 6. Reading the LCD

LCD Ticker Messages

Key for reading the lcd ticker:

LIVE: OFFLINE = Audio engine is powered down.
FETCHING LIVE WEATHER FOR... = Querying geocoding and meteorological APIs.
LIVE [CITY] = Active live weather data successfully loaded into synth engine.
PRESET [NAME] = Preset climate soundscape loaded.
MANUAL EDIT = Parameter sliders modified manually by user.
RECORDING WAV(30s) = Realtime PCM background recording in progress.
EXPORT COMPLETE = WAV file encoded and pushed to browser downloads.