Omahub
← All plugins
M

Omabreathe

by Mathew

Resonance breathing session overlay with audio cues

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
1e9ae9e
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
1e9ae9e
Reviewed
1 month ago

This is a benign Omarchy breathing overlay: it displays a QML overlay and bar widget, runs a timer, and plays bundled audio cues using pw-play with fixed file paths. No install scripts, network access, credential handling, persistence, or obfuscated code were found, and the deterministic scan's "none" result matches manual review.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/matiacone/omarchy-breathe --enable
Productivity #bar #quickshell

Omabreathe

A resonance breathing session overlay for Omarchy.

Click the bar icon to open a setup card, choose session length and pace, then follow a growing and shrinking ring with inhale / exhale audio cues.

Breathe screenshot

Install

omarchy plugin add https://github.com/matiacone/omarchy-breathe.git --enable --yes

The bar widget lands in the center section by default. Move it if you want:

omarchy bar move omabreathe --section center --before omarchy.indicators

Use

Click the lotus icon in the bar, or toggle the overlay from a terminal or keybinding:

omarchy-shell shell toggle omabreathe '{}'

On the setup screen:

Key Action
↑ / ↓ Session length in minutes
← / → Pace in breaths per minute
Enter Start the session
Esc Close

During a session, Esc returns to setup. When the session finishes, Enter starts another or Esc closes.

Default pace is 6 breaths per minute (a 10-second cycle: 5 seconds in, 5 seconds out).

Dependencies

  • Omarchy Quattro / omarchy-shell
  • pw-play from PipeWire, used for the inhale, exhale, and session-complete cues. Omarchy installs this by default.

Update

omarchy plugin update omabreathe

Uninstall

omarchy plugin remove omabreathe

This removes the plugin checkout from ~/.config/omarchy/plugins/omabreathe/ and disables the overlay and bar widget. It does not change other Omarchy settings.

License

MIT