Skip to main content

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

Project description

LowHum

PyPI Python License Downloads

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

Single-purpose menu bar app that generates deep brown noise locally and plays it on loop. Install it, click play, forget about it. Cumulative-sum brown noise through a Butterworth bandpass (1 to 500 Hz, 20 Hz sub-bass highpass), RMS-normalized per chunk, crossfaded at boundaries. Everything is stored in ~/.lowhum/. Playback streams through PortAudio via memory-mapped files, so the full WAV never sits in RAM. The app polls audio devices every 2 seconds and stops instantly if headphones disconnect or a Bluetooth device drops.

Install

uv (requires Python 3.12+):

uv tool install lowhum

Usage

lhm                          # launch the menu-bar app (runs in background)
lhm devices                  # list output devices
lhm generate                 # pre-generate the audio file

(lhm being the shorthand alias, as the CLI tool)

Menu bar controls

The menu bar icon is a template image, so macOS handles dark/light mode automatically. Further, use it for:

  • Play / Stop from the menu bar
  • Pick any connected audio device from the Output Device submenu
  • Noise color selection (brown, pink, white)
  • Auto-stops when headphones connect or disconnect

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.5.tar.gz (76.3 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.5-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: lowhum-0.4.5.tar.gz
  • Upload date:
  • Size: 76.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","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.5.tar.gz
Algorithm Hash digest
SHA256 438d772ae1e131ee680b16859a2a8b42b891d6bffd65faee8d4d1ef0e506af58
MD5 032cd66a3f8eb191433bbb582c06a305
BLAKE2b-256 ab1851de9eb8dbce783f34396f2cb9e684e8daed774d3f8459da195843202cf2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: lowhum-0.4.5-py3-none-any.whl
  • Upload date:
  • Size: 21.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c7d03fea65c55d71353678f75f2e340502bfeeb536f0bc3b33c675c189ba9736
MD5 0fe0eb4cf473255395daa991c711fd14
BLAKE2b-256 6a4c0ffcaf36c0f667dfa0d7e96932f9ef560c66a50dd43e9adb28fcbd9b4a49

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