jawhng/hear-on-out
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update README

Browse Source
This commit is contained in:
Georgi Durankiev
2025-12-29 21:08:07 +02:00
parent 714fbd6c93
commit 7aacb29dbd
1 changed files with 12 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
README.md
View File

@@ -4,7 +4,7 @@ A generative ambient music application that transforms real-time weather and air
## Overview ## Overview
hear-on-out uses your geolocation to fetch current weather and air quality data, then generates unique ambient music that responds to environmental conditions in real-time. Every parameter of the audio - from tempo to reverb to note patterns - is affected by the weather around you. hear-on-out uses your geolocation to fetch current weather and air quality data, then generates unique ambient music that responds to environmental conditions. Audio parameters are calculated from weather conditions at page load and remain static during playback - refresh the page to get updated soundscapes based on new weather data.
## Features ## Features
@@ -21,12 +21,17 @@ hear-on-out uses your geolocation to fetch current weather and air quality data,
- **Ping Arpeggio**: High-pitched reverse arpeggios that intensify with weather extremity, speed scales with temperature (1n → 16n) - **Ping Arpeggio**: High-pitched reverse arpeggios that intensify with weather extremity, speed scales with temperature (1n → 16n)
- **Bass Synth**: Root note foundation with randomized release times for subtle variation - **Bass Synth**: Root note foundation with randomized release times for subtle variation
**Dynamic Audio Parameters** **Weather-Mapped Audio Parameters**
Audio parameters are calculated from weather data when the page loads and set once when playback starts:
- **BPM**: Scales linearly with temperature (5 BPM at 0°C → 30 BPM at 30°C) - **BPM**: Scales linearly with temperature (5 BPM at 0°C → 30 BPM at 30°C)
- **Reverb**: Wet signal responds to humidity (more humid = more reverb) - **Reverb**: Wet signal responds to humidity (more humid = more reverb, 0.3-1.0 range)
- **Delay**: Time and feedback react to wind speed (faster wind = shorter delay, more feedback) - **Delay**: Time responds to wind speed (0.1-0.8 seconds), feedback increases with wind (0.2-0.7 range)
- **Filter**: Applied only to ambient pad, cutoff frequency brightens with temperature (0°C = 400Hz dark, 30°C = 8000Hz bright) - **Filter**: Applied only to ambient pad, cutoff frequency brightens with temperature (0°C = 400Hz dark, 30°C = 8000Hz bright)
- **Resonance**: Increases with wind speed for sharper filtering - **Resonance**: Increases with wind speed for sharper filtering
- **Arpeggio Speed**: Temperature affects note intervals (cold = slow, hot = fast)
- **Ping Intensity**: Volume scales with weather extremity (pleasant = quiet, extreme = loud)
### Air Quality Monitor ### Air Quality Monitor
@@ -99,8 +104,9 @@ npm run build
2. **Data Fetch**: Current weather and air quality data retrieved from Open-Meteo API 2. **Data Fetch**: Current weather and air quality data retrieved from Open-Meteo API
3. **Weather Comfort Scoring**: Algorithm calculates comfort based on temperature, humidity, cloud cover, wind, and precipitation 3. **Weather Comfort Scoring**: Algorithm calculates comfort based on temperature, humidity, cloud cover, wind, and precipitation
4. **Progression Selection**: Chooses appropriate chord progression based on weather mood 4. **Progression Selection**: Chooses appropriate chord progression based on weather mood
5. **Audio Generation**: All instruments and effects dynamically adjust to conditions 5. **Parameter Calculation**: Audio parameters (BPM, reverb, delay, filter, etc.) are derived from weather conditions
6. **Real-time Updates**: Audio parameters smoothly transition as weather changes 6. **Audio Generation**: When playback starts, all parameters are set and remain static until page refresh
7. **Static Playback**: Audio continues with the same settings - refresh the page to update based on new weather data
## Geolocation & Browser Compatibility ## Geolocation & Browser Compatibility