Breathing Exercise

June 12, 2026 ยท View on GitHub

Guided breathing techniques for relaxation and focus.

Screenshot

Requirements

  • mpv
  • socat

Install

Use the DMS CLI:

dms plugins install breathing

Or manually:

git clone https://github.com/hthienloc/dms-breathing ~/.config/DankMaterialShell/plugins/breathing

Features

  • 6 techniques - Deep Breathing, 4-7-8, Box, Equal, Resonance, Alternate Nostril
  • Visual guide - Phase indicator with icon and countdown
  • Duration presets - Quick selection from 1m to 30m
  • Quick start - Double-tap same exercise to begin

Usage

ActionResult
Left clickOpen exercise selector
Double-tap exerciseStart immediately
Right clickPause/resume

License

GPL-3.0

Roadmap / TODO

  • Custom Exercises: Interface to create personal breathing patterns (custom inhale/hold/exhale/rest timings).
  • Sound Guidance: Premium real-time pitch-warping singing bowl audio cues for each phase.
  • Guided Voice Tracks: Add male and female voice guidance tracks for step-by-step breathing instructions (assets pending search/acquisition).
  • Advanced Statistics: Daily/weekly logs and streak tracking for mindfulness consistency.
  • System Focus Sync: Automatically enable "Do Not Disturb" mode while an exercise is active.
  • Visual Customization: Multiple animation styles for the breathing indicator (expanding circle, wave, etc.).