https://github.com/paul-bokelman/thud
Thud — Reactively change volume based on typing speed to induce flow state
https://github.com/paul-bokelman/thud
flowstate music reactive
Last synced: 9 months ago
JSON representation
Thud — Reactively change volume based on typing speed to induce flow state
- Host: GitHub
- URL: https://github.com/paul-bokelman/thud
- Owner: paul-bokelman
- Created: 2025-07-30T21:06:47.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-07-30T21:33:40.000Z (10 months ago)
- Last Synced: 2025-07-31T00:18:03.167Z (10 months ago)
- Topics: flowstate, music, reactive
- Language: Python
- Homepage: https://pypi.org/project/thud/0.1.0/
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Thud
Reactively change volume based on typing speed to induce flow state. Thud is built for programmers that listen to music while coding, aiming to enhance focus by adjusting the volume based on typing speed.
Usage:
```bash
python thud.py [--max MAX_VOLUME] [--min MIN_VOLUME] [--decay DECAY_RATE] [--magnitude CHANGE_MAGNITUDE] [--log True|False]
```
**Arguments:**
- `--max`: Maximum volume level (default: 30)
- `--min`: Minimum volume level (default: 10)
- `--decay`: Continuous decay rate when lps is 0 (default: 0.5)
- `--magnitude`: Change magnitude per key press (default: 0.1)
- `--log`: Enable logging of volume changes (default: False)