diff --git a/.env.example b/.env.example index a75f854..5fc6450 100644 --- a/.env.example +++ b/.env.example @@ -193,6 +193,23 @@ WAVEFORM_WINDOW_SECONDS=30 # Set true only if a cross-origin stream sends CORS headers. WAVEFORM_STREAM_CORS=false +# Which visualizer styles are exposed to visitors, comma-separated, from: +# bars | line | vu | spectrum | spectrum-mirror | blob | circular | glow +# The first six render below the art and are mutually exclusive — visitors +# pick one. circular (ring around the art) and glow (art pulses) are +# independent toggles that can combine with a below-art style and with each +# other. A picker appears automatically whenever more than one style is +# listed here; with just one (or unset), it's hidden and that style is +# simply always on, same as before this setting existed. +# Example enabling the picker with a ring + glow option: +# WAVEFORM_TYPES="bars,spectrum,circular,glow" +WAVEFORM_TYPES="bars" +# Which of the exposed styles above are active by default, comma-separated, +# before a visitor picks anything (their choice is then remembered in their +# browser). Blank defaults to "bars" if exposed, else the first exposed +# below-art style. +WAVEFORM_DEFAULT="" + # ----------------------------------------------------------------------------- # Listeners / history diff --git a/README.md b/README.md index 87cb495..16a0c6f 100644 --- a/README.md +++ b/README.md @@ -118,11 +118,23 @@ counter, since seeking a live stream isn't meaningful. ### Waveform visualizer -`WAVEFORM_ENABLED=true` shows a real-time scrolling waveform that builds out as -the stream plays (it appears only after the listener presses play). It uses the +`WAVEFORM_ENABLED=true` shows a real-time visualizer that builds out as the +stream plays (it appears only after the listener presses play). It uses the Web Audio API — an `AnalyserNode` fed by the `