Skip to main content

Deep Brown Noise for Focus as a MenuBar App & CLI Tool

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lowhum-0.4.6.tar.gz (53.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lowhum-0.4.6-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

Details for the file lowhum-0.4.6.tar.gz.

File metadata

  • Download URL: lowhum-0.4.6.tar.gz
  • Upload date:
  • Size: 53.5 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for lowhum-0.4.6.tar.gz
Algorithm Hash digest
SHA256 9e163ceedb7190910ddb3cd89415bb06bccc6fca86063984bca75ba0dac7363e
MD5 54a4cf3d5fb27bd98cf6095f6ff46fc1
BLAKE2b-256 72d8c1505ce5a4ba27b10d89f953ac6495425ef47900b925e1e2a746d42340ab

See more details on using hashes here.

File details

Details for the file lowhum-0.4.6-py3-none-any.whl.

File metadata

  • Download URL: lowhum-0.4.6-py3-none-any.whl
  • Upload date:
  • Size: 21.4 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for lowhum-0.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b68143b26234405eadbb1596c98d933280d0c58be4db9238dc89559647fca7a3
MD5 6d7ba8e636a8e063a228183b325b382a
BLAKE2b-256 89567ab666671c444aefb6c1db2b64596d3024ee594d7fc2134e9f169ae9f386

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page