# Momentum > A CLI and Omarchy panel for Sennheiser Momentum 4 headphones. # Overview Source: https://momentumctl.timmo.dev/ Momentum controls Sennheiser Momentum 4 headphones from Linux. The `momentum` CLI reads and changes the headset's settings over Bluetooth, and the Omarchy panel shows them in the shell. ```bash momentum status momentum set transparency 40 momentum set eq-preset harman ``` ## What it covers - Noise control: noise cancelling, adaptive and custom transparency, and anti-wind. - Sound: sound mode, bass boost, the equaliser's presets and bands, and the Bluetooth codec. - Behaviour: Smart Pause, on-head detection, auto-answer, Comfort Call, touch controls, auto power off and the call profile switch. The headset protocol is reverse-engineered and can vary with firmware. Settings the firmware rejects are reported as unsupported and hidden in the panel. Firmware updates, factory resets and undocumented commands are not implemented. ## Get started | Page | Why | | --- | --- | | [Install](/install) | Install the CLI and the panel | | [CLI](/cli) | Every command, and how the CLI finds the headset | | [Panel](/panel) | Open and use the Omarchy panel | | [Agents](/agents) | Let an agent read and change the headset | ## Machine-readable docs | URL | Use | | --- | --- | | https://momentumctl.timmo.dev/llms.txt | Compact page index | | https://momentumctl.timmo.dev/llms-full.txt | Full docs bundle | | https://momentumctl.timmo.dev/mcp | Hosted MCP (search, page and navigation) | | `/{route}.md` | One page as Markdown | --- # Agents Source: https://momentumctl.timmo.dev/agents The repository ships a tool-owned skill, [`skills/momentum/SKILL.md`](https://github.com/timmo001/omarchy-momentumctl/blob/main/skills/momentum/SKILL.md). It tells an agent to read with `momentum status --json`, change one setting at a time with `momentum set`, and check the result afterwards. The CLI has no Code Mode namespace or MCP server yet, so agents use it directly. They never use a GAIA command the CLI doesn't expose, and none can update the firmware, factory reset the headset or forget a paired device. This documentation site has its own MCP server at . --- # CLI Source: https://momentumctl.timmo.dev/cli ```bash momentum status momentum status --json momentum set transparency 40 momentum set eq-preset harman momentum set eq -3.5 -0.5 2.5 -0.5 -0.5 momentum set sound-mode speech momentum set codec aac momentum set call-profile-switch off momentum --help ``` The CLI finds the first connected Bluetooth device named MOMENTUM. Set `MOMENTUM_ADDRESS` to pick one by address instead. Each command opens one Bluetooth session under a shared lock, so only one runs at a time. `momentum status --json` prints every setting. One the firmware rejects is `null`. ## Settings `momentum set --help` lists them: `anc`, `adaptive`, `transparency`, `anti-wind`, `bass-boost`, `sound-mode`, `eq`, `eq-band`, `eq-preset`, `codec`, `call-profile-switch`, `auto-answer`, `auto-power-off`, `comfort-call`, `on-head-detection`, `smart-pause` and `touch-controls`. ## Codec and call profile These are PipeWire settings on the PC, not headset ones. Picking a codec switches the headset to its A2DP profile, which also leaves the call profile. The call profile switch is WirePlumber's `bluetooth.autoswitch-to-headset-profile`, saved with `wpctl`, so it applies to every Bluetooth headset. With it off, music stays in high quality but calls use another mic. ## Equaliser The headset has five bands, labelled 63 Hz, 250 Hz, 1 kHz, 4 kHz and 8 kHz in Smart Control. Gains are in dB, in tenths. The presets are Smart Control's eight, plus a Harman preset fitted from AutoEq's Momentum 4 corrections. The curve is stored on the headset, so it carries over to other devices. --- # Install Source: https://momentumctl.timmo.dev/install ## Requirements - Omarchy Quattro, for the panel - `bluetoothctl`, from `bluez-utils` - `pactl`, from `libpulse`, to show and switch the codec - `wpctl`, from `wireplumber`, for the call profile switch - A paired and connected Sennheiser Momentum 4 ## The CLI Install `momentum-bin` or `momentum-git` from the AUR, or a package from the [releases](https://github.com/timmo001/omarchy-momentumctl/releases). ## The panel Install the `momentum` CLI first, then add the plugin: ```bash omarchy plugin add https://github.com/timmo001/omarchy-momentumctl.git ``` For an unattended install from a repository you already trust, add `--enable --yes`. ```bash omarchy plugin update timmo.momentumctl omarchy plugin remove timmo.momentumctl ``` --- # Panel Source: https://momentumctl.timmo.dev/panel The panel shows the headset battery and firmware version, the Bluetooth codec and sample rate PipeWire is using, and the controls the CLI offers. It talks to the headset only through the installed `momentum` executable. Open it through its shell IPC target, and bind that command to a hotkey for direct access: ```bash omarchy-shell shell toggle timmo.momentumctl ``` Up and Down move between controls, Enter activates the selected one, and Left and Right change the selected choice, level, preset or band. Enter on a band's value resets it to 0 dB. Type to filter the controls, and press Escape to clear the filter or close the panel. Under Speech Clarity the panel disables bass boost and the equaliser, as Smart Control does.