Skip to main content

A Linux app that dims your screen when you slouch

Project description

postured

A Linux app that dims your screen 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, the screen dims as a reminder to sit up straight. 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:

  • Sensitivity - affects detection threshold and dim intensity; higher values trigger on smaller posture deviations and dim the screen more
  • 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 io.github.vadi2.postured /io/github/vadi2/postured io.github.vadi2.postured.Postured1 Pause
busctl --user call io.github.vadi2.postured /io/github/vadi2/postured io.github.vadi2.postured.Postured1 Resume

# Get status
busctl --user call io.github.vadi2.postured /io/github/vadi2/postured io.github.vadi2.postured.Postured1 GetStatus

Requirements

  • Python 3.11+
  • Linux
  • Webcam

Credits

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

License

MIT

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.2.0.tar.gz (5.2 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.2.0-py3-none-any.whl (5.1 MB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for postured-1.2.0.tar.gz
Algorithm Hash digest
SHA256 91c674e0c5910859b5636369912067b06c94668d72e90114d88f19b58cd11098
MD5 8a5c366ec000dbf09383ba31bd7abbe0
BLAKE2b-256 d426634b582c364132effc86789e9105092d8e81e99fd2e6a442866484a4bbe4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: postured-1.2.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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 77aba85b2188e44d95108a8f61a467d52c57b7b0e3b7f431c4c32512a84fb383
MD5 9d7ec6a008cbaf6825ba11a9c3599926
BLAKE2b-256 6172163f724a907f419bc2f5e170fd58d2be9754be3b05d6c96f066d62e8a740

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