Skip to main content

A Linux app that lets you know when you slouch

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

postured-1.4.0.tar.gz (5.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

postured-1.4.0-py3-none-any.whl (5.1 MB view details)

Uploaded Python 3

File details

Details for the file postured-1.4.0.tar.gz.

File metadata

  • Download URL: postured-1.4.0.tar.gz
  • Upload date:
  • Size: 5.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.22

File hashes

Hashes for postured-1.4.0.tar.gz
Algorithm Hash digest
SHA256 977f6926aa163d2c14cc64a997817b65203ce15260095e2b79d0fc1a3b1d267c
MD5 b6a08650f9237324d7ec839f791775c2
BLAKE2b-256 fa6a821c914ce144d2b40a6f1a51e3c193f763475b4c87eb5758b9a19cdbd16b

See more details on using hashes here.

File details

Details for the file postured-1.4.0-py3-none-any.whl.

File metadata

  • Download URL: postured-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 5.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.22

File hashes

Hashes for postured-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0f45e29cacb0c8d3d12764621b3f3b46464d7bfa004c05c0512dafacbdc946da
MD5 4f13721223fb56eb3d4e9eff8d87aa41
BLAKE2b-256 ab3600a213405490b1fcc3a6bf48280a0cb319479a40936cda35624b4042236e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page