Deep Brown Noise for Focus as a MenuBar App & CLI Tool
Reason this release was yanked:
superseded by 0.4.x line
Project description
LowHum
Deep brown noise for focus, right from the macOS menu bar.
No browser tabs. No subscriptions. No account. Fully offline.
Brown noise is one of the most effective focus aids for people with ADHD and anyone who needs to block out distractions. Most options require keeping a YouTube tab open, paying for a subscription app, or relying on your phone. LowHum is a single-purpose menu bar app that generates deep brown noise locally and plays it on loop — install it, click play, forget about it.
Install
uv tool install lowhum # recommended
# or
pip install lowhum
Usage
lowhum # launch the menu-bar app
lowhum start # play immediately in terminal (Ctrl+C to stop)
lowhum start -d 3 # play on a specific output device
lowhum devices # list output devices
lowhum generate # pre-generate the audio file
lhm is a shorthand alias — all commands work with either name.
Menu-bar app
- Play / Stop from the menu bar
- Output Device submenu — pick any connected audio device
- Auto-stops when headphones connect or disconnect
How it works
- Generation — On first run, a 10-minute WAV is synthesised locally: cumulative-sum brown noise, Butterworth bandpass (1–500 Hz + 20 Hz sub-bass HP), RMS-normalised per chunk, crossfaded at boundaries. Stored at
~/.lowhum/. - Playback — Memory-mapped streaming through PortAudio. No full-file RAM load. Loops seamlessly.
- Device detection — Polls audio devices every 2 seconds. Headphone unplug, Bluetooth disconnect — playback stops instantly.
- Menu-bar icon — Template icon; macOS handles dark/light mode automatically.
Requirements
- macOS
- Python >= 3.12
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lowhum-1.0.1.tar.gz.
File metadata
- Download URL: lowhum-1.0.1.tar.gz
- Upload date:
- Size: 4.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e3c762f9705207168a35be1c1d3dbc749b49bf393656dc14837edc5124c3a222
|
|
| MD5 |
04dc291f4d4588d2fe83d1e278b86c91
|
|
| BLAKE2b-256 |
7a19a6c686183356abf6f4024c373f2e2931c0b313081f16936dccae755a7754
|
File details
Details for the file lowhum-1.0.1-py3-none-any.whl.
File metadata
- Download URL: lowhum-1.0.1-py3-none-any.whl
- Upload date:
- Size: 4.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
443f4695d24be79c0abfd9d16f3f1a2b83674df367ed9afd8575e6a307228a60
|
|
| MD5 |
02a04b87b55b238889bd2477fbbc28e0
|
|
| BLAKE2b-256 |
e691857e68c749b5300cf8abd374fd3d3b81f933f5eeb2688968ff25898238bb
|
