Skip to main content

LowHum

PyPI Python License: MIT Downloads

Deep brown noise for focus, as a macOS menu bar app. Requires macOS and Python 3.12+. Website

Brown noise is the default: cumulative-sum white noise through a 1 to 500 Hz Butterworth bandpass with a 20 Hz sub-bass highpass. Pink and white are low-passed at 8 kHz and 4 kHz so they don't hurt your ears. Files live in ~/.lowhum/ and stream through PortAudio via memory-mapped files. They're generated on first play, not at startup.

Install

uv tool install lowhum

Usage

lhm                  # launch the menu-bar app
lhm devices          # list output devices
lhm generate         # pre-generate the audio files

Menu bar

  • Play / Stop
  • Noise Color (brown, pink, white)
  • Output Device
  • Block Built-in Speakers
  • Launch at Login

Playback stops when headphones disconnect and resumes when they come back. If a newer version is on PyPI, you get a notification at startup.

Development

just run       # run the app locally
just fmt       # format and lint
just check     # pyright + pytest
just build     # build wheel
just clean     # remove caches and build artifacts

Metadata

Release files for lowhum 0.4.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lowhum 0.4.6
File Size Uploaded
lowhum-0.4.6.tar.gz 53.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lowhum 0.4.6
File Interpreter ABI Platform
lowhum-0.4.6-py3-none-any.whl Python 3 none any Details

Total release size: 75.0 kB

Release files / lowhum-0.4.6.tar.gz

Download URL lowhum-0.4.6.tar.gz
Size 53.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9e163ceedb7190910ddb3cd89415bb06bccc6fca86063984bca75ba0dac7363e
BLAKE2b-256 checksum
How to use checksums
72d8c1505ce5a4ba27b10d89f953ac6495425ef47900b925e1e2a746d42340ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","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}

Release files / lowhum-0.4.6-py3-none-any.whl

Download URL lowhum-0.4.6-py3-none-any.whl
Size 21.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b68143b26234405eadbb1596c98d933280d0c58be4db9238dc89559647fca7a3
BLAKE2b-256 checksum
How to use checksums
89567ab666671c444aefb6c1db2b64596d3024ee594d7fc2134e9f169ae9f386
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","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}

Release history Release notifications | RSS feed

1.2.1

1 release file

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

This release

0.4.6 This release

2 release files

0.4.5

2 release files

0.4.3

2 release files

0.4.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page