GitHub - vadi2/postured: A Linux app that lets you know when you slouch

1 min read Original article ↗

postured

A Linux app that lets you know when you slouch. Optionally locks your screen when you step away.

(join our community) Matrix

Uses your webcam and MediaPipe pose detection to monitor your posture. When slouching is detected, you get notified to sit up straight (screen dimming or LED blink). Runs locally with minimal CPU usage - no accounts needed.

postured showing good posture and slouching states

Install

uv pip install postured
pip install postured

AppImages also available.

Requires notifications support on Gnome Shell.

Settings

Right-click the tray icon to access:

  • Notification style - choose between screen dimming or LED blink
  • Sensitivity - affects detection threshold; higher values trigger on smaller posture deviations
  • Lock when away - lock screen when you step away from the camera

D-Bus Interface

Control postured via D-Bus for pause/resume and status queries.

Show commands
# Pause/Resume
busctl --user call org.postured.Postured /org/postured/Postured org.postured.Postured1 Pause
busctl --user call org.postured.Postured /org/postured/Postured org.postured.Postured1 Resume

# Get status
busctl --user call org.postured.Postured /org/postured/Postured org.postured.Postured1 GetStatus

Requirements

  • Python 3.11+
  • Linux
  • Webcam

Credits

Inspired by posturr - check it out if you're on macOS.

License

GPL-3.0-or-later