hooring 🎐

English · 日本語

Play cool-sounding furin (Japanese wind chime) tones, driven by a wandering breeze.

Glass (Edo furin) and metal (iron furin) timbres are additively synthesized and struck at irregular intervals, following the wind. Strike loudness and spacing wander with 1/f fluctuation, like a tanzaku paper strip catching the air and moving the clapper.

Installation

Install from PyPI with pipx:

pipx install hooring

That puts hooring on your PATH. Upgrade later with pipx upgrade hooring.

To use hooring as a Python library, install it with pip:

pip install hooring

Playback needs aplay (ALSA) or ffplay (ffmpeg). Writing a WAV file does not.

Development

Clone the repository and set up the virtualenv with uv:

uv sync
uv run hooring

Tests:

uv run pytest

Usage

hooring

It keeps ringing. Stop with Ctrl+C. To hear the same breeze again, pass the printed seed= to --seed.

# A single strike
hooring --once

# Light breeze, three furin, 45 seconds
hooring -d 45 --wind breeze --voices 3

# Metal timbre
hooring --material metal --wind gusty

# Write a WAV file (defaults to 30 seconds if duration is omitted)
hooring -o natsu.wav -d 20 --seed 7

# Half volume (1 is the current maximum)
hooring --volume 0.5

Options

From Python:

from hooring import render

audio = render(duration=8, seed=1, wind="breeze", material="glass", volume=0.5)
# stereo: shape (n, 2), float64 in [-1, 1]

Release notes

→ Release Notes

License

hooring is distributed under the terms of the MIT license.