claudible 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{claudible-0.1.0.dist-info → claudible-0.1.2.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: claudible
-Version: 0.1.0
+Version: 0.1.2
 Summary: Ambient audio soundscape feedback for terminal output - an opus for your terminals
 License: MIT
-Project-URL: Homepage, https://github.com/qwertykeith/claudible
+Project-URL: Homepage, https://github.com/anthropics/claudible
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -23,23 +23,45 @@ Requires-Dist: numpy>=1.20.0
 Requires-Dist: scipy>=1.7.0
 Requires-Dist: sounddevice>=0.4.0
 
-# claudible
+```
+        ♪ ♫ ♪
+      ┌─────────┐
+      │ ╭─────╮ │ ♩
+      │ │ ▓▓▓ │ │
+      │ │ ▓▓▓ │ │  ♬    ┈┈┈╮
+      │ ╰─────╯ │     ♪    │
+      │  claude  │ ♫       │
+      └────┬────┘    ♩    ≋≋≋
+     ══════╧══════       ≋≋≋≋≋
+      ♪  audible  ♫       ≋≋≋
+```
+
+# 🎵 claudible
 
 *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.
 
-## The Idea
+## 🎼 The Idea
 
-Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it - crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.
+Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it — crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.
 
-## Installation
+## 🎶 Installation
 
 ```bash
+# Recommended (handles PATH automatically)
+brew install pipx && pipx ensurepath  # macOS
+# or: pip install --user pipx && pipx ensurepath
+
+pipx install claudible
+
+# Or with pip
 pip install claudible
 ```
 
-## Usage
+> **`claudible` command not found?** If you used `pip install --user`, the script directory may not be on your PATH. Use `python3 -m claudible` instead, or switch to `pipx`.
+
+## 🎹 Usage
 
 ```bash
 # Run claude with audio feedback (default)
@@ -61,7 +83,7 @@ claudible --volume 0.3
 claudible --list-characters
 ```
 
-### Reverse Mode
+### 🔇 Reverse Mode
 
 In reverse mode, claudible is silent while output is flowing and plays ambient sound during silence. Useful when you want to know a task is *waiting* rather than *working*.
 
@@ -73,7 +95,7 @@ claudible --reverse
 claudible --reverse -c shell
 ```
 
-## Works With Any CLI
+## 🎧 Works With Any CLI
 
 Built for Claude Code, but claudible works with anything that produces terminal output.
 
@@ -88,37 +110,37 @@ npm run dev 2>&1 | claudible --pipe
 tail -f /var/log/app.log | claudible --pipe -c droplet
 ```
 
-## Sound Characters
-
-| Character | Description |
-|-----------|-------------|
-| `ice` | Brittle, very high, fast decay with pitch drop |
-| `glass` | Classic wine glass ping |
-| `crystal` | Pure lead crystal with beating from close partial pairs |
-| `ceramic` | Duller muted earthenware tap |
-| `bell` | Small metallic bell, classic ratios, long ring |
-| `droplet` | Water droplet, pitch bend down, liquid |
-| `click` | Sharp mechanical click, keyboard-like |
-| `wood` | Hollow wooden tap, warm marimba-like resonance |
-| `stone` | Dense slate tap, heavy and earthy |
-| `bamboo` | Hollow tube resonance, odd harmonics, breathy and airy |
-| `ember` | Warm crackling ember, fire-like with wide pitch scatter |
-| `silk` | Soft breathy whisper, delicate airy texture |
-| `shell` | Swirly ocean interference, dense phase beating |
-| `moss` | Ultra-soft muffled earth, mossy dampness |
-
-## Options
+## 🎻 Sound Characters
+
+| Character | | Description |
+|-----------|---|-------------|
+| `ice` | 🧊 | Brittle, very high, fast decay with pitch drop |
+| `glass` | 🍷 | Classic wine glass ping |
+| `crystal` | 💎 | Pure lead crystal with beating from close partial pairs |
+| `ceramic` | 🏺 | Duller muted earthenware tap |
+| `bell` | 🔔 | Small metallic bell, classic ratios, long ring |
+| `droplet` | 💧 | Water droplet, pitch bend down, liquid |
+| `click` | ⌨️ | Sharp mechanical click, keyboard-like |
+| `wood` | 🪵 | Hollow wooden tap, warm marimba-like resonance |
+| `stone` | 🪨 | Dense slate tap, heavy and earthy |
+| `bamboo` | 🎋 | Hollow tube resonance, odd harmonics, breathy and airy |
+| `ember` | 🔥 | Warm crackling ember, fire-like with wide pitch scatter |
+| `silk` | 🪶 | Soft breathy whisper, delicate airy texture |
+| `shell` | 🐚 | Swirly ocean interference, dense phase beating |
+| `moss` | 🌿 | Ultra-soft muffled earth, mossy dampness |
+
+## 🎛️ Options
 
 | Flag | Description |
 |------|-------------|
-| `--pipe` | Read from stdin instead of wrapping |
-| `--character`, `-c` | Sound character |
-| `--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 |
+| `--pipe` | 📥 Read from stdin instead of wrapping |
+| `--character`, `-c` | 🎵 Sound character |
+| `--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 |
 
-## Development
+## 🛠️ Development
 
 Test locally without installing:
 
@@ -138,6 +160,6 @@ echo "test" | PYTHONPATH=src python3 -m claudible --pipe -c glass
 PYTHONPATH=src python3 -m claudible --list-characters
 ```
 
-## License
+## 📜 License
 
 MIT

{claudible-0.1.0.dist-info → claudible-0.1.2.dist-info}/RECORD

@@ -4,8 +4,8 @@ claudible/audio.py,sha256=6Do7_g5SUfJkMGSH_c_XGG4YiC2uakhaDTy8xYAp7rE,12043
 claudible/cli.py,sha256=j14ZnHT7L_efA67U-3hLSqUsgf2rvlMYgs1b6w3X2pU,4803
 claudible/materials.py,sha256=6OsobcWOFvLBCuvzkeWi9C7fYHFnW9RED6nEElK-Ki4,9517
 claudible/monitor.py,sha256=iPCaqdO-CDp1CoIie2VtddUUjG1A_xucbFJ1DPk3MKk,4070
-claudible-0.1.0.dist-info/METADATA,sha256=HXc1eXgzZECcs0cx7ZCWj4-m7Lz5aOUP2t002GZd4oI,4100
-claudible-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-claudible-0.1.0.dist-info/entry_points.txt,sha256=4tBIsIGcdtJ-1N9YZ3MrADyNvPBDcUxVgAnt9IuC7TA,49
-claudible-0.1.0.dist-info/top_level.txt,sha256=4ZB16Aa5ZDS12bmxzrQmAJejjsTgQ9Yozwc0Z3qpJp4,10
-claudible-0.1.0.dist-info/RECORD,,
+claudible-0.1.2.dist-info/METADATA,sha256=b38veaujlcjfAzO8G7EaKK5eXWVyb7Qqf5Cojg1nKMw,5095
+claudible-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+claudible-0.1.2.dist-info/entry_points.txt,sha256=4tBIsIGcdtJ-1N9YZ3MrADyNvPBDcUxVgAnt9IuC7TA,49
+claudible-0.1.2.dist-info/top_level.txt,sha256=4ZB16Aa5ZDS12bmxzrQmAJejjsTgQ9Yozwc0Z3qpJp4,10
+claudible-0.1.2.dist-info/RECORD,,