TimeHear

Continuous tone clock:

• 12 hours maps to 1 octave
• 1 hour maps to 1 semitone
• Optional minute/hour accents
• Default base frequency is 110 Hz (A2)

Run

python -m timehear.cli --accent both

Dry run (prints frequency progression):

python -m timehear.cli --dry-run --duration-seconds 5

Install as CLI:

pip install -e .
timehear --accent minute

Visualization (Dark Mode)

Install visualization deps:

pip install -e ".[viz]"

Run combined time-domain + spectral view:

timehear-viz --accent both

Right panel now shows a circular orbit with a discrete marker. The marker's angular speed is the current mapped frequency.

Run visualizer without audio:

timehear-viz --mute

Notes

• Linux playback uses aplay (ALSA utils).
• Press Ctrl+C to stop.

Tests

python -m pytest -q