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.

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.

Install

pip install postured

Or with uv:

uv pip install postured

Usage

postured

Desktop Integration

To add postured to your application menu:

postured --install-desktop

This installs the .desktop file and icon to ~/.local/share/.

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 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

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: postured-1.0.2.tar.gz
  • Upload date:
  • Size: 5.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Bazzite","version":"43","id":"Silverblue","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for postured-1.0.2.tar.gz
Algorithm Hash digest
SHA256 26eccd059259de18417e8ed94e418bca197d7a41ca1ccce0c1dca39665002474
MD5 ff0c08b439d4d574396dd94f3d71e756
BLAKE2b-256 09a2e5f3b68a5678da16f526bf78d68dd7d63e420c2a60f1c28007290bbc9c0f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: postured-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 5.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Bazzite","version":"43","id":"Silverblue","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for postured-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b45de95c55af9f6c1b720bed11b3fe0489f03c5e6c93a32b9947b9807df357a5
MD5 a4d74b6c313a4121baf8b13487a0478d
BLAKE2b-256 9ed4d1828d44197a8247be590da69175c3ec9315a47583eef63f0351d2f763df

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