Skip to content

Awareness v1.0

Choose a tag to compare

@joergs-git joergs-git released this 22 Feb 18:35
· 244 commits to main since this release

Awareness v1.0

A mindfulness timer for macOS. Randomly blacks out your screen to help you pause, breathe, and stay present.

Features

  • Menu bar app with yin-yang icon
  • Random blackout intervals (configurable 1–120 min range)
  • Blackout duration 3–120 seconds with 2s fade transitions
  • Visual modes: plain black, custom text, image, or looping video
  • Start gong + end gong (independently toggleable)
  • Camera/microphone detection — skips blackouts during calls
  • Handcuffs mode — commit to the full duration
  • Snooze (10 min – 2 hours, or indefinitely)
  • Keystroke suppression during blackout
  • Multi-monitor support
  • Launch at Login
  • Persistent settings

Installation

  1. Download Awareness.app.zip below
  2. Unzip and move to /Applications
  3. Right-click → Open on first launch (required because the app is not notarized)

Alternatively, remove the quarantine flag:

xattr -cr /Applications/Awareness.app

Requires macOS 13+.