claudible 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

claudible/audio.py

@@ -26,6 +26,7 @@ class SoundEngine:
         self._stream: Optional[sd.OutputStream] = None
         self._running = False
         self._hum_phase = 0.0
+        self._last_pitch = 1.0  # portamento tracking
         self._lock = threading.Lock()
 
         # Ring buffer for mixing audio
@@ -142,11 +143,11 @@ class SoundEngine:
     # --- Sound generation ---
 
     def _build_grain_cache(self) -> list:
-        """Build grain cache with voices at full-octave intervals, biased low + high."""
+        """Build grain cache with voices at full-octave intervals, filtered by material range."""
         # Each register is a full octave apart.
         # (octave_shift, noise_mult, decay_mult, duration_mult)
         # Multiple character variations per register.
-        voices = [
+        all_voices = [
             # --- oct -3: sub rumble (3 voices) ---
             (-3, 3.5, 2.5, 1.8),   # sub thump
             (-3, 2.0, 3.0, 2.0),   # sub knock
@@ -181,6 +182,8 @@ class SoundEngine:
             ( 3, 0.3, 0.2, 0.45),  # air tick
             ( 3, 0.05, 0.3, 0.35), # air wisp
         ]
+        oct_min, oct_max = self.material.octave_range
+        voices = [v for v in all_voices if oct_min <= v[0] <= oct_max]
         cache = []
         for octave, noise_m, decay_m, dur_m in voices:
             cache.append(self._generate_grain(
@@ -269,6 +272,16 @@ class SoundEngine:
             h = ((h * 33) ^ ord(c)) & 0xFFFFFFFF
         return h
 
+    # Minor pentatonic scale degrees in semitones (wraps at octave)
+    _SCALE_DEGREES = [0, 3, 5, 7, 10]
+
+    def _snap_to_scale(self, semitones: float) -> float:
+        """Quantise a semitone offset to the nearest scale degree."""
+        octave = int(semitones // 12)
+        remainder = semitones % 12
+        nearest = min(self._SCALE_DEGREES, key=lambda d: abs(d - remainder))
+        return octave * 12 + nearest
+
     def play_grain(self, token: str = ""):
         """Play a grain/sparkle sound, deterministic for a given token."""
         if token:
@@ -280,16 +293,30 @@ class SoundEngine:
         idx = rng.randint(len(self._grain_cache))
         grain = self._grain_cache[idx].copy()
 
-        # Narrow pitch micro-variation (±1.5 semitones) — stays in its register
-        pitch_shift = 2 ** (rng.uniform(-1.5, 1.5) / 12)
-        if abs(pitch_shift - 1.0) > 0.001:
-            new_len = int(len(grain) / pitch_shift)
-            if new_len > 0:
-                grain = np.interp(
-                    np.linspace(0, len(grain) - 1, new_len),
-                    np.arange(len(grain)),
-                    grain,
-                ).astype(np.float32)
+        # Pitch variation snapped to minor pentatonic scale
+        raw_semi = rng.uniform(-1.5, 1.5)
+        snapped_semi = self._snap_to_scale(raw_semi)
+        pitch_shift = 2 ** (snapped_semi / 12)
+
+        # Fast portamento: slide from last pitch to new target
+        prev_pitch = self._last_pitch
+        self._last_pitch = pitch_shift
+
+        n = len(grain)
+        if n > 0 and (abs(pitch_shift - 1.0) > 0.001 or abs(prev_pitch - 1.0) > 0.001):
+            # Glide over first 30% of grain, then hold target
+            glide_len = int(n * 0.3)
+            pitch_env = np.ones(n, dtype=np.float32)
+            if glide_len > 0:
+                pitch_env[:glide_len] = np.linspace(
+                    prev_pitch, pitch_shift, glide_len, dtype=np.float32,
+                )
+            pitch_env[glide_len:] = pitch_shift
+
+            # Time-varying resample using cumulative phase
+            phase = np.cumsum(pitch_env)
+            phase = phase / phase[-1] * (n - 1)
+            grain = np.interp(phase, np.arange(n), grain).astype(np.float32)
 
         grain *= rng.uniform(0.7, 1.0)
 

claudible/cli.py

@@ -10,14 +10,18 @@ import time
 from typing import Optional
 
 from .audio import SoundEngine
-from .materials import get_material, get_random_material, list_materials, MATERIALS
+from .materials import (
+    get_material, get_random_material, list_materials, list_sound_sets,
+    get_sound_set, SOUND_SETS, DEFAULT_SOUND_SET,
+)
 from .monitor import ActivityMonitor
 
 
-def run_demo(volume: float):
-    """Play a short demo of every sound character."""
-    print("Claudible character demo\n", file=sys.stderr)
-    for name, mat in MATERIALS.items():
+def run_demo(volume: float, sound_set: str = DEFAULT_SOUND_SET):
+    """Play a short demo of every sound character in a set."""
+    materials = get_sound_set(sound_set)
+    print(f"Claudible character demo [{sound_set}]\n", file=sys.stderr)
+    for name, mat in materials.items():
         print(f"  {name:10} - {mat.description}", file=sys.stderr)
         engine = SoundEngine(material=mat, volume=volume)
         engine.start()
@@ -129,10 +133,15 @@ def main():
         action='store_true',
         help='Pipe mode: read from stdin instead of wrapping a command',
     )
+    parser.add_argument(
+        '--set', '-s',
+        choices=list_sound_sets(),
+        default=DEFAULT_SOUND_SET,
+        help=f'Sound set (default: {DEFAULT_SOUND_SET})',
+    )
     parser.add_argument(
         '--character', '-c',
-        choices=list_materials(),
-        help='Sound character (default: random)',
+        help='Sound character (default: random). Use --list-characters to see options.',
     )
     parser.add_argument(
         '--volume', '-v',
@@ -164,21 +173,33 @@ def main():
 
     args = parser.parse_args()
 
+    sound_set = args.set
+
     if args.list_characters:
-        print("Available sound characters:\n")
-        for name, mat in MATERIALS.items():
-            print(f"  {name:10} - {mat.description}")
+        for set_name, materials in SOUND_SETS.items():
+            default_tag = " (default)" if set_name == DEFAULT_SOUND_SET else ""
+            print(f"\n  [{set_name}]{default_tag}\n")
+            for name, mat in materials.items():
+                print(f"    {name:10} - {mat.description}")
+        print()
         return
 
     if args.demo:
         volume = max(0.0, min(1.0, args.volume))
-        run_demo(volume)
+        run_demo(volume, sound_set)
         return
 
+    # Validate character against the chosen set
     if args.character:
-        material = get_material(args.character)
+        available = list_materials(sound_set)
+        if args.character not in available:
+            parser.error(
+                f"character '{args.character}' not in set '{sound_set}'. "
+                f"Available: {', '.join(available)}"
+            )
+        material = get_material(args.character, sound_set)
     else:
-        material = get_random_material()
+        material = get_random_material(sound_set)
 
     volume = max(0.0, min(1.0, args.volume))
 

claudible/materials.py

@@ -27,12 +27,380 @@ class Material:
     attack_ms: float  # attack ramp time in milliseconds
     freq_spread: float  # semitones of random base freq variation per grain
     volume: float  # per-material volume scaling (0-1)
+    octave_range: Tuple[int, int]  # (min, max) octave shifts for grain cache
     description: str
 
 
-MATERIALS = {
-    # --- Original materials (upgraded with physics parameters) ---
+DEFAULT_SOUND_SET = "ambient"
 
+# --- Ambient sound set (default) ---
+# Throbbing, textured, overtone-rich with percussive attack.
+# Close partial pairs create beating/throbbing. High attack noise for punch.
+# Kept low — nothing shrill. Dense, gritty texture.
+
+AMBIENT_MATERIALS = {
+    "drift": Material(
+        name="drift",
+        base_freq=95,
+        partials=[
+            (1.0, 1.0), (1.005, 0.95),  # beating pair ~0.48Hz throb
+            (2.0, 0.5), (2.008, 0.45),   # octave beating pair
+            (3.01, 0.2), (4.02, 0.1),
+        ],
+        decay_rates=[3, 3.2, 5, 5.3, 8, 11],
+        grain_duration=0.16,
+        attack_noise=0.35,
+        noise_freq=600,
+        detune_amount=12,
+        reverb_amount=0.6,
+        reverb_damping=0.55,
+        room_size=1.8,
+        pitch_drop=0.997,
+        attack_ms=1.5,
+        freq_spread=3.0,
+        volume=0.7,
+        octave_range=(-3, 0),
+        description="Low undulating throb, punchy attack into beating pairs",
+    ),
+
+    "tide": Material(
+        name="tide",
+        base_freq=120,
+        partials=[
+            (1.0, 1.0), (1.003, 0.92),   # slow beat
+            (1.498, 0.55), (1.502, 0.52), # fifth beating pair
+            (2.0, 0.35), (3.0, 0.12),
+        ],
+        decay_rates=[4, 4.1, 6, 6.2, 8, 12],
+        grain_duration=0.18,
+        attack_noise=0.3,
+        noise_freq=500,
+        detune_amount=14,
+        reverb_amount=0.7,
+        reverb_damping=0.5,
+        room_size=2.0,
+        pitch_drop=0.996,
+        attack_ms=1.0,
+        freq_spread=4.0,
+        volume=0.65,
+        octave_range=(-3, 0),
+        description="Oceanic wash with percussive bite, wide phase interference",
+    ),
+
+    "breath": Material(
+        name="breath",
+        base_freq=160,
+        partials=[
+            (1.0, 1.0), (1.006, 0.85),   # beating pair
+            (2.01, 0.4), (3.02, 0.15),
+        ],
+        decay_rates=[5, 5.2, 8, 12],
+        grain_duration=0.14,
+        attack_noise=0.4,
+        noise_freq=900,
+        detune_amount=18,
+        reverb_amount=0.55,
+        reverb_damping=0.6,
+        room_size=1.6,
+        pitch_drop=0.998,
+        attack_ms=1.2,
+        freq_spread=5.0,
+        volume=0.6,
+        octave_range=(-3, 0),
+        description="Gritty exhale, noisy attack decaying into warm throb",
+    ),
+
+    "haze": Material(
+        name="haze",
+        base_freq=110,
+        partials=[
+            (1.0, 1.0), (1.004, 0.9),    # tight beating
+            (2.003, 0.6), (2.007, 0.55),  # octave beating
+            (3.005, 0.3), (4.01, 0.15),
+            (5.02, 0.06),
+        ],
+        decay_rates=[3.5, 3.7, 5, 5.2, 7, 10, 14],
+        grain_duration=0.15,
+        attack_noise=0.32,
+        noise_freq=550,
+        detune_amount=10,
+        reverb_amount=0.65,
+        reverb_damping=0.6,
+        room_size=1.9,
+        pitch_drop=0.997,
+        attack_ms=1.0,
+        freq_spread=3.5,
+        volume=0.65,
+        octave_range=(-3, 0),
+        description="Dense foggy cluster, percussive onset into thick overtone haze",
+    ),
+
+    "pulse": Material(
+        name="pulse",
+        base_freq=80,
+        partials=[
+            (1.0, 1.0), (1.008, 0.9),    # ~0.64Hz beating = pulsing
+            (2.0, 0.55), (2.012, 0.5),    # faster beat in octave
+            (3.0, 0.25),
+        ],
+        decay_rates=[2.5, 2.6, 4, 4.2, 7],
+        grain_duration=0.2,
+        attack_noise=0.38,
+        noise_freq=400,
+        detune_amount=8,
+        reverb_amount=0.5,
+        reverb_damping=0.65,
+        room_size=1.5,
+        pitch_drop=0.995,
+        attack_ms=0.8,
+        freq_spread=2.5,
+        volume=0.7,
+        octave_range=(-3, 0),
+        description="Thumpy rhythmic throb, hard attack into hypnotic beating",
+    ),
+
+    "glow": Material(
+        name="glow",
+        base_freq=145,
+        partials=[
+            (1.0, 1.0), (1.003, 0.88),   # beating pair
+            (2.0, 0.6), (3.0, 0.35),
+            (4.0, 0.2), (5.0, 0.1),
+        ],
+        decay_rates=[4, 4.2, 5, 6.5, 8, 11],
+        grain_duration=0.13,
+        attack_noise=0.28,
+        noise_freq=700,
+        detune_amount=15,
+        reverb_amount=0.55,
+        reverb_damping=0.45,
+        room_size=1.7,
+        pitch_drop=0.998,
+        attack_ms=1.5,
+        freq_spread=4.0,
+        volume=0.65,
+        octave_range=(-3, 0),
+        description="Warm radiant harmonics, punchy onset with rich overtone bloom",
+    ),
+
+    "cloud": Material(
+        name="cloud",
+        base_freq=190,
+        partials=[
+            (1.0, 1.0), (1.002, 0.85),
+            (1.5, 0.4), (2.0, 0.25),
+            (2.5, 0.1),
+        ],
+        decay_rates=[5, 5.2, 7, 9, 13],
+        grain_duration=0.14,
+        attack_noise=0.3,
+        noise_freq=800,
+        detune_amount=16,
+        reverb_amount=0.75,
+        reverb_damping=0.4,
+        room_size=2.2,
+        pitch_drop=0.998,
+        attack_ms=1.2,
+        freq_spread=5.0,
+        volume=0.55,
+        octave_range=(-3, 0),
+        description="Percussive puff into massive diffuse reverb, textured",
+    ),
+
+    "murmur": Material(
+        name="murmur",
+        base_freq=70,
+        partials=[
+            (1.0, 1.0), (1.006, 0.88),   # low beating
+            (2.0, 0.5), (3.0, 0.25),
+            (4.01, 0.1),
+        ],
+        decay_rates=[3, 3.2, 5, 8, 12],
+        grain_duration=0.17,
+        attack_noise=0.35,
+        noise_freq=350,
+        detune_amount=12,
+        reverb_amount=0.5,
+        reverb_damping=0.7,
+        room_size=1.4,
+        pitch_drop=0.994,
+        attack_ms=0.8,
+        freq_spread=3.0,
+        volume=0.7,
+        octave_range=(-3, 0),
+        description="Deep rumble thump, heavy attack into warm beating murmur",
+    ),
+
+    "shimmer": Material(
+        name="shimmer",
+        base_freq=260,
+        partials=[
+            (1.0, 1.0), (1.002, 0.9),    # slow beating
+            (2.001, 0.55), (2.003, 0.52), # octave beating
+            (3.0, 0.25), (4.0, 0.1),
+        ],
+        decay_rates=[5, 5.1, 7, 7.2, 10, 14],
+        grain_duration=0.11,
+        attack_noise=0.25,
+        noise_freq=1200,
+        detune_amount=10,
+        reverb_amount=0.65,
+        reverb_damping=0.3,
+        room_size=2.0,
+        pitch_drop=0.999,
+        attack_ms=1.0,
+        freq_spread=4.0,
+        volume=0.55,
+        octave_range=(-3, 0),
+        description="Bright-ish tap into shimmering beating overtones",
+    ),
+
+    "deep": Material(
+        name="deep",
+        base_freq=50,
+        partials=[
+            (1.0, 1.0), (1.01, 0.85),    # ~0.5Hz beating
+            (2.0, 0.55), (2.015, 0.5),   # wider octave beat
+            (3.0, 0.2),
+        ],
+        decay_rates=[2, 2.2, 3.5, 3.8, 6],
+        grain_duration=0.22,
+        attack_noise=0.4,
+        noise_freq=250,
+        detune_amount=8,
+        reverb_amount=0.45,
+        reverb_damping=0.8,
+        room_size=1.3,
+        pitch_drop=0.992,
+        attack_ms=0.6,
+        freq_spread=2.5,
+        volume=0.75,
+        octave_range=(-3, 0),
+        description="Sub-bass thump, hard hit into very deep slow throb",
+    ),
+
+    # --- High register whispers (very quiet, above 3kHz) ---
+
+    "wisp": Material(
+        name="wisp",
+        base_freq=3200,
+        partials=[
+            (1.0, 1.0), (1.002, 0.9),    # tight beating
+            (2.0, 0.2), (3.01, 0.05),
+        ],
+        decay_rates=[12, 12.5, 20, 30],
+        grain_duration=0.06,
+        attack_noise=0.15,
+        noise_freq=5000,
+        detune_amount=4,
+        reverb_amount=0.7,
+        reverb_damping=0.2,
+        room_size=2.0,
+        pitch_drop=1.0,
+        attack_ms=2.0,
+        freq_spread=2.0,
+        volume=0.18,
+        octave_range=(-1, 1),
+        description="Faint crystalline wisp, barely there",
+    ),
+
+    "glint": Material(
+        name="glint",
+        base_freq=3800,
+        partials=[
+            (1.0, 1.0), (1.5, 0.4), (2.01, 0.15),
+        ],
+        decay_rates=[18, 25, 35],
+        grain_duration=0.04,
+        attack_noise=0.25,
+        noise_freq=6000,
+        detune_amount=6,
+        reverb_amount=0.65,
+        reverb_damping=0.15,
+        room_size=1.8,
+        pitch_drop=0.998,
+        attack_ms=0.8,
+        freq_spread=3.0,
+        volume=0.15,
+        octave_range=(-1, 0),
+        description="Tiny metallic glint, quiet and sharp",
+    ),
+
+    "arc": Material(
+        name="arc",
+        base_freq=4200,
+        partials=[
+            (1.0, 1.0), (1.003, 0.85),   # slow beating at high freq
+            (1.5, 0.3), (2.0, 0.1),
+        ],
+        decay_rates=[10, 10.5, 16, 24],
+        grain_duration=0.07,
+        attack_noise=0.1,
+        noise_freq=7000,
+        detune_amount=3,
+        reverb_amount=0.75,
+        reverb_damping=0.1,
+        room_size=2.2,
+        pitch_drop=1.0,
+        attack_ms=3.0,
+        freq_spread=1.5,
+        volume=0.14,
+        octave_range=(-1, 0),
+        description="High glass arc, delicate beating shimmer",
+    ),
+
+    "spark": Material(
+        name="spark",
+        base_freq=5000,
+        partials=[
+            (1.0, 1.0), (1.41, 0.35), (2.0, 0.08),
+        ],
+        decay_rates=[22, 30, 45],
+        grain_duration=0.03,
+        attack_noise=0.3,
+        noise_freq=8000,
+        detune_amount=8,
+        reverb_amount=0.6,
+        reverb_damping=0.15,
+        room_size=1.6,
+        pitch_drop=0.996,
+        attack_ms=0.5,
+        freq_spread=4.0,
+        volume=0.12,
+        octave_range=(-1, 0),
+        description="Tiny electric spark, fast and faint",
+    ),
+
+    "dust": Material(
+        name="dust",
+        base_freq=3500,
+        partials=[
+            (1.0, 1.0), (1.001, 0.95),   # very tight beating
+            (2.003, 0.3), (2.006, 0.28),  # octave beating pair
+            (3.0, 0.08),
+        ],
+        decay_rates=[8, 8.2, 14, 14.5, 22],
+        grain_duration=0.08,
+        attack_noise=0.12,
+        noise_freq=5500,
+        detune_amount=5,
+        reverb_amount=0.8,
+        reverb_damping=0.1,
+        room_size=2.4,
+        pitch_drop=1.0,
+        attack_ms=4.0,
+        freq_spread=2.0,
+        volume=0.16,
+        octave_range=(-1, 0),
+        description="Soft high dust motes, floating reverb texture",
+    ),
+}
+
+
+# --- Material sound set (percussive, physical) ---
+# The original set: crisp, percussive sounds modelled on physical materials.
+
+MATERIAL_MATERIALS = {
     "ice": Material(
         name="ice",
         base_freq=2800,
@@ -49,6 +417,7 @@ MATERIALS = {
         attack_ms=0.5,
         freq_spread=4.0,
         volume=0.85,
+        octave_range=(-3, 3),
         description="Brittle, very high, fast decay with pitch drop",
     ),
 
@@ -68,6 +437,7 @@ MATERIALS = {
         attack_ms=0.8,
         freq_spread=3.0,
         volume=0.9,
+        octave_range=(-3, 3),
         description="Classic wine glass ping",
     ),
 
@@ -87,6 +457,7 @@ MATERIALS = {
         attack_ms=1.0,
         freq_spread=2.5,
         volume=0.85,
+        octave_range=(-3, 3),
         description="Pure lead crystal with beating from close partial pairs",
     ),
 
@@ -106,6 +477,7 @@ MATERIALS = {
         attack_ms=1.2,
         freq_spread=3.5,
         volume=1.0,
+        octave_range=(-3, 3),
         description="Duller muted earthenware tap",
     ),
 
@@ -128,6 +500,7 @@ MATERIALS = {
         attack_ms=0.3,
         freq_spread=2.5,
         volume=0.8,
+        octave_range=(-3, 3),
         description="Small metallic bell, classic ratios, long ring",
     ),
 
@@ -147,6 +520,7 @@ MATERIALS = {
         attack_ms=0.3,
         freq_spread=4.0,
         volume=0.8,
+        octave_range=(-3, 3),
         description="Water droplet, pitch bend down, liquid",
     ),
 
@@ -166,6 +540,7 @@ MATERIALS = {
         attack_ms=0.2,
         freq_spread=6.0,
         volume=0.95,
+        octave_range=(-3, 3),
         description="Sharp mechanical click, keyboard-like",
     ),
 
@@ -190,6 +565,7 @@ MATERIALS = {
         attack_ms=0.6,
         freq_spread=4.0,
         volume=1.0,
+        octave_range=(-3, 3),
         description="Hollow wooden tap, warm marimba-like resonance",
     ),
 
@@ -212,6 +588,7 @@ MATERIALS = {
         attack_ms=0.4,
         freq_spread=5.0,
         volume=1.0,
+        octave_range=(-3, 3),
         description="Dense slate tap, heavy and earthy",
     ),
 
@@ -233,6 +610,7 @@ MATERIALS = {
         attack_ms=1.0,
         freq_spread=3.5,
         volume=0.85,
+        octave_range=(-3, 3),
         description="Hollow tube resonance, odd harmonics, breathy and airy",
     ),
 
@@ -254,6 +632,7 @@ MATERIALS = {
         attack_ms=0.3,
         freq_spread=8.0,
         volume=0.9,
+        octave_range=(-3, 3),
         description="Warm crackling ember, fire-like with wide pitch scatter",
     ),
 
@@ -273,6 +652,7 @@ MATERIALS = {
         attack_ms=2.5,
         freq_spread=5.0,
         volume=0.6,
+        octave_range=(-3, 3),
         description="Soft breathy whisper, delicate airy texture",
     ),
 
@@ -295,6 +675,7 @@ MATERIALS = {
         attack_ms=1.5,
         freq_spread=2.0,
         volume=0.75,
+        octave_range=(-3, 3),
         description="Swirly ocean interference, dense phase beating",
     ),
 
@@ -314,23 +695,47 @@ MATERIALS = {
         attack_ms=3.0,
         freq_spread=4.0,
         volume=0.7,
+        octave_range=(-3, 3),
         description="Ultra-soft muffled earth, mossy dampness",
     ),
 }
 
 
-def get_material(name: str) -> Material:
-    """Get a material by name."""
-    if name not in MATERIALS:
-        raise ValueError(f"Unknown material: {name}. Available: {list(MATERIALS.keys())}")
-    return MATERIALS[name]
+SOUND_SETS = {
+    "ambient": AMBIENT_MATERIALS,
+    "material": MATERIAL_MATERIALS,
+}
+
+# Default MATERIALS points to the default set for backwards compat
+MATERIALS = SOUND_SETS[DEFAULT_SOUND_SET]
+
+
+def list_sound_sets() -> List[str]:
+    """List all available sound set names."""
+    return list(SOUND_SETS.keys())
+
+
+def get_sound_set(name: str) -> dict:
+    """Get a sound set by name."""
+    if name not in SOUND_SETS:
+        raise ValueError(f"Unknown sound set: {name}. Available: {list(SOUND_SETS.keys())}")
+    return SOUND_SETS[name]
+
+
+def get_material(name: str, sound_set: str = DEFAULT_SOUND_SET) -> Material:
+    """Get a material by name from a given sound set."""
+    materials = get_sound_set(sound_set)
+    if name not in materials:
+        raise ValueError(f"Unknown character: {name}. Available: {list(materials.keys())}")
+    return materials[name]
 
 
-def get_random_material() -> Material:
-    """Get a random material."""
-    return random.choice(list(MATERIALS.values()))
+def get_random_material(sound_set: str = DEFAULT_SOUND_SET) -> Material:
+    """Get a random material from a given sound set."""
+    materials = get_sound_set(sound_set)
+    return random.choice(list(materials.values()))
 
 
-def list_materials() -> List[str]:
-    """List all available material names."""
-    return list(MATERIALS.keys())
+def list_materials(sound_set: str = DEFAULT_SOUND_SET) -> List[str]:
+    """List all available material names in a sound set."""
+    return list(get_sound_set(sound_set).keys())

{claudible-0.1.3.dist-info → claudible-0.1.5.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: claudible
-Version: 0.1.3
-Summary: Ambient audio soundscape feedback for terminal output - an opus for your terminals
+Version: 0.1.5
+Summary: Ambient audio soundscape feedback for terminal output - an opus for your terminals, claude code by default
 License: MIT
 Project-URL: Homepage, https://github.com/anthropics/claudible
 Classifier: Development Status :: 4 - Beta
@@ -40,7 +40,9 @@ Requires-Dist: sounddevice>=0.4.0
 
 *An opus for your terminals.*
 
-Possibly the most annoying Claude utility ever made but here it is anyway. Ambient audio soundscape feedback for terminal output.
+Possibly the most annoying Claude utility ever made but here it is anyway.
+
+Ambient audio soundscape feedback for terminal output. It really shines when used with a lot of busy busy Claude Code terminals running at the same time.
 
 ## 🎼 The Idea
 
@@ -64,7 +66,7 @@ pip install claudible
 ## 🎹 Usage
 
 ```bash
-# Run claude with audio feedback (default)
+# Run claude with audio feedback (default: ambient sound set)
 claudible
 
 # Run a different command
@@ -74,16 +76,20 @@ claudible "python my_script.py"
 some-command 2>&1 | claudible --pipe
 
 # Choose a sound character
-claudible --character crystal
+claudible --character drift
+
+# Use the percussive material sound set
+claudible --set material -c bell
 
 # Adjust volume
 claudible --volume 0.3
 
-# List available characters
+# List available characters across all sets
 claudible --list-characters
 
-# Demo all sound characters
+# Demo all sound characters in a set
 claudible --demo
+claudible --demo --set material
 ```
 
 ### 🔇 Reverse Mode
@@ -113,7 +119,26 @@ npm run dev 2>&1 | claudible --pipe
 tail -f /var/log/app.log | claudible --pipe -c droplet
 ```
 
-## 🎻 Sound Characters
+## 🎻 Sound Sets
+
+Claudible ships with two sound sets. The **ambient** set (default) produces soft, throbbing textures with rich overtones. The **material** set has crisp, percussive sounds modelled on physical materials.
+
+### Ambient (default) `--set ambient`
+
+| Character | | Description |
+|-----------|---|-------------|
+| `drift` | 🌊 | Slow undulating low throb, gentle beating pairs |
+| `tide` | 🌀 | Oceanic wash, phase interference, wide and enveloping |
+| `breath` | 💨 | Soft exhale texture, breathy warmth with filtered noise |
+| `haze` | 🌫️ | Dense foggy overtones, warm and thick with close partial clusters |
+| `pulse` | 💗 | Gentle rhythmic throbbing from detuned pairs, hypnotic |
+| `glow` | 🕯️ | Warm radiant harmonics, rich natural overtone series |
+| `cloud` | ☁️ | Diffuse and soft, massive reverb space, floating |
+| `murmur` | 🫧 | Low gentle rumble, warm harmonic murmur with subtle throb |
+| `shimmer` | ✨ | High ethereal overtones, floating and luminous |
+| `deep` | 🎚️ | Sub-bass throb, felt more than heard, very deep and slow |
+
+### Material `--set material`
 
 | Character | | Description |
 |-----------|---|-------------|
@@ -137,12 +162,13 @@ tail -f /var/log/app.log | claudible --pipe -c droplet
 | Flag | Description |
 |------|-------------|
 | `--pipe` | 📥 Read from stdin instead of wrapping |
-| `--character`, `-c` | 🎵 Sound character |
+| `--set`, `-s` | 🎼 Sound set: `ambient` (default), `material` |
+| `--character`, `-c` | 🎵 Sound character within the set |
 | `--volume`, `-v` | 🔊 Volume 0.0–1.0 (default: 0.5) |
 | `--attention`, `-a` | ⏰ Silence alert seconds (default: 30) |
 | `--reverse`, `-r` | 🔄 Reverse mode: sound during silence, quiet during output |
-| `--list-characters` | 📋 Show presets |
-| `--demo` | 🔊 Play a short demo of each sound character |
+| `--list-characters` | 📋 Show all characters across all sets |
+| `--demo` | 🔊 Demo characters in the selected set |
 
 ## 🛠️ Development
 

claudible-0.1.5.dist-info/RECORD

@@ -0,0 +1,11 @@
+claudible/__init__.py,sha256=xSLL4yfc1p79BWVb65PJBTFMxyJ2PWuu7pCLYcCuOVM,96
+claudible/__main__.py,sha256=5mFnPjtOjk5Hw-mvUhRYtwXVnXFR7ZbXKC27VIXu_dI,106
+claudible/audio.py,sha256=8lHgp74Igh6Hs4HAbTZIRos-LVA0HCxJ71cTlyAlmFk,15945
+claudible/cli.py,sha256=gLGaNDFVf4Bfr9UAH2yZUPeTUVxZ-5OR9DNjEwTRNsI,6549
+claudible/materials.py,sha256=M49vT0oL63Iv1e8qxa2bsz3G6sQgPXwsJ3kAHMggX7g,21039
+claudible/monitor.py,sha256=KAnb0rmnuTDanD7pgls50Oxd3-TlhXv2tUDjX8RkHIg,4106
+claudible-0.1.5.dist-info/METADATA,sha256=PcTB4TJgiYVPqMB1xQH32-VIpZkkyghZ0Xr09yeO9ms,6736
+claudible-0.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claudible-0.1.5.dist-info/entry_points.txt,sha256=4tBIsIGcdtJ-1N9YZ3MrADyNvPBDcUxVgAnt9IuC7TA,49
+claudible-0.1.5.dist-info/top_level.txt,sha256=4ZB16Aa5ZDS12bmxzrQmAJejjsTgQ9Yozwc0Z3qpJp4,10
+claudible-0.1.5.dist-info/RECORD,,

claudible-0.1.3.dist-info/RECORD

@@ -1,11 +0,0 @@
-claudible/__init__.py,sha256=xSLL4yfc1p79BWVb65PJBTFMxyJ2PWuu7pCLYcCuOVM,96
-claudible/__main__.py,sha256=5mFnPjtOjk5Hw-mvUhRYtwXVnXFR7ZbXKC27VIXu_dI,106
-claudible/audio.py,sha256=NXINffeLQlH89JJli-QF29WyYtpPl1BjcmfStvJ7geE,14741
-claudible/cli.py,sha256=R7WttU-idl_S4yBx_bXKKRtftkdBS2_ioiNgZQ68a4w,5665
-claudible/materials.py,sha256=6OsobcWOFvLBCuvzkeWi9C7fYHFnW9RED6nEElK-Ki4,9517
-claudible/monitor.py,sha256=KAnb0rmnuTDanD7pgls50Oxd3-TlhXv2tUDjX8RkHIg,4106
-claudible-0.1.3.dist-info/METADATA,sha256=SjWWWyDZIwGt1eQmcbQr_8UMCeCILUlS1fYb0mKrL10,5269
-claudible-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-claudible-0.1.3.dist-info/entry_points.txt,sha256=4tBIsIGcdtJ-1N9YZ3MrADyNvPBDcUxVgAnt9IuC7TA,49
-claudible-0.1.3.dist-info/top_level.txt,sha256=4ZB16Aa5ZDS12bmxzrQmAJejjsTgQ9Yozwc0Z3qpJp4,10
-claudible-0.1.3.dist-info/RECORD,,