GitHub - tldev/posturr: A macOS app that blurs your screen when you slouch. Uses Vision framework for real-time posture detection.

Skip to content

Navigation Menu

Toggle navigation

Sign in

Appearance settings

PlatformAI CODE CREATIONGitHub CopilotWrite better code with AIGitHub SparkBuild and deploy intelligent appsGitHub ModelsManage and compare promptsMCP RegistryNewIntegrate external toolsDEVELOPER WORKFLOWSActionsAutomate any workflowCodespacesInstant dev environmentsIssuesPlan and track workCode ReviewManage code changesAPPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilitiesCode securitySecure your code as you buildSecret protectionStop leaks before they startEXPLOREWhy GitHubDocumentationBlogChangelogMarketplaceView all featuresSolutionsBY COMPANY SIZEEnterprisesSmall and medium teamsStartupsNonprofitsBY USE CASEApp ModernizationDevSecOpsDevOpsCI/CDView all use casesBY INDUSTRYHealthcareFinancial servicesManufacturingGovernmentView all industriesView all solutionsResourcesEXPLORE BY TOPICAISoftware DevelopmentDevOpsSecurityView all topicsEXPLORE BY TYPECustomer storiesEvents & webinarsEbooks & reportsBusiness insightsGitHub SkillsSUPPORT & SERVICESDocumentationCustomer supportCommunity forumTrust centerPartnersOpen SourceCOMMUNITYGitHub SponsorsFund open source developersPROGRAMSSecurity LabMaintainer CommunityAcceleratorArchive ProgramREPOSITORIESTopicsTrendingCollectionsEnterpriseENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platformAVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security featuresCopilot for BusinessEnterprise-grade AI featuresPremium SupportEnterprise-grade 24/7 supportPricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.
You signed out in another tab or window. Reload to refresh your session.
You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

tldev

/

posturr

Public

Notifications
You must be signed in to change notification settings

Fork
22

Star
1k

A macOS app that blurs your screen when you slouch. Uses Vision framework for real-time posture detection.

License

MIT license

1k
stars

22
forks

Branches

Tags

Activity

Star

Notifications
You must be signed in to change notification settings

Code

Issues
4

Pull requests
0

Actions

Projects
0

Security
0

Insights

Additional navigation options

Code

Issues

Pull requests

Actions

Projects

Security

Insights

tldev/posturr

 mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History33 Commits.gitignore.gitignore  AppIcon.icnsAppIcon.icns  CHANGELOG.mdCHANGELOG.md  CLAUDE.mdCLAUDE.md  LICENSELICENSE  PRIVACY.mdPRIVACY.md  Package.swiftPackage.swift  README.mdREADME.md  build.shbuild.sh  main.swiftmain.swift  release.shrelease.sh  View all filesRepository files navigationREADMEMIT licensePosturr
A macOS app that blurs your screen when you slouch.
Posturr uses your Mac's camera and Apple's Vision framework to monitor your posture in real-time. When it detects that you're slouching, it progressively blurs your screen to remind you to sit up straight. Maintain good posture, and the blur clears instantly.
Features

Real-time posture detection - Uses Apple's Vision framework for body pose and face tracking
Progressive screen blur - Gentle visual reminder that intensifies with worse posture
Menu bar controls - Easy access to settings, calibration, and status from the menu bar
Multi-display support - Works across all connected monitors
Privacy-focused - All processing happens locally on your Mac
Lightweight - Runs as a background app with minimal resource usage
No account required - No signup, no cloud, no tracking

Installation
Homebrew (Recommended)
brew tap tldev/tap
brew install --cask posturr
Manual Download

Download the latest Posturr-vX.X.X.dmg or .zip from the Releases page
Open the DMG and drag Posturr.app to your Applications folder
Launch normally - no Gatekeeper warnings (app is signed and notarized)

Camera Permission
Posturr requires camera access to monitor your posture. When you first launch the app, macOS will ask for permission. Click "OK" to grant access.
If you accidentally denied permission, you can grant it later:

Open System Settings > Privacy & Security > Camera
Find Posturr and enable the toggle

Usage
Once launched, Posturr appears in your menu bar with a person icon. The app continuously monitors your posture and applies screen blur when slouching is detected.
Menu Bar Controls
Click the menu bar icon to access:

Status - Shows current state (Monitoring, Slouching, Good Posture, etc.)
Enabled - Toggle posture monitoring on/off
Recalibrate - Reset your baseline posture (sit up straight, then click)
Sensitivity - Adjust how sensitive the slouch detection is (Low, Medium, High, Very High)
Dead Zone - Set the tolerance before blur kicks in (None, Small, Medium, Large)
Compatibility Mode - Use public macOS APIs for blur (try this if blur doesn't appear)
Quit - Exit the application (or press Escape anywhere)

Tips for Best Results

Position your camera at eye level when possible
Ensure adequate lighting on your face
Sit at a consistent distance from your screen
The app works best when your shoulders are visible

How It Works
Posturr uses Apple's Vision framework to detect body pose landmarks:

Body Pose Detection: Tracks nose, shoulders, and their relative positions
Face Detection Fallback: When full body isn't visible, tracks face position
Posture Analysis: Measures the vertical distance between nose and shoulders
Blur Response: Applies screen blur proportional to posture deviation

The screen blur uses macOS's private CoreGraphics API by default for efficient, system-level blur. If the blur doesn't appear on your system, enable Compatibility Mode from the menu to use NSVisualEffectView instead.
Building from Source
Requirements

macOS 13.0 (Ventura) or later
Xcode Command Line Tools (xcode-select --install)

Build
git clone https://github.com/yourusername/posturr.git
cd posturr
./build.sh
The built app will be in build/Posturr.app.
Build Options
# Standard build
./build.sh

# Build with release archive (.zip)
./build.sh --release
Manual Build
swiftc -O \
-framework AppKit \
-framework AVFoundation \
-framework Vision \
-framework CoreImage \
-o Posturr \
main.swift
Known Limitations

Camera dependency: Requires a working camera with adequate lighting
Detection accuracy: Works best with clear view of upper body/face

Command Interface
Posturr exposes a file-based command interface for external control:

Command
Description

capture
Take a photo and analyze pose

blur <0-64>
Set blur level manually

quit
Exit the application

Write commands to /tmp/posturr-command. Responses appear in /tmp/posturr-response.
System Requirements

macOS 13.0 (Ventura) or later
Camera (built-in or external)
Approximately 10MB disk space

Privacy
Posturr processes all video data locally on your Mac. No images or data are ever sent to external servers. The camera feed is used solely for posture detection and is never stored or transmitted.
License
MIT License - see LICENSE for details.
Contributing
Contributions are welcome! Please feel free to submit issues and pull requests.
Acknowledgments

Built with Apple's Vision framework for body pose detection
Uses private CoreGraphics API for blur, with NSVisualEffectView fallback
Inspired by the need for better posture during long coding sessions

Contributors

@wklm - Compatibility mode implementation
@cam-br0wn - Architecture-agnostic build improvements
@einsteinx2 - SwiftPM/Xcode support

About

A macOS app that blurs your screen when you slouch. Uses Vision framework for real-time posture detection.

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity
Stars

1k
stars
Watchers

1
watching
Forks

22
forks

Report repository

Releases
13

Posturr v1.0.12

Latest

Jan 26, 2026

+ 12 releases

Packages
0

No packages published

Contributors
4

tldev
Tom Johnell

claude
Claude

cam-br0wn
Cam Brown

einsteinx2
Ben Baron

Languages

Swift
73.6%

Shell
26.4%

Footer

© 2026 GitHub, Inc.

Footer navigation

Terms

Privacy

Security

Status

Community

Docs

Contact

Manage cookies

Do not share my personal information

You can’t perform that action at this time.

Posturr is a macOS application designed to encourage better posture by visually reminding the user to sit up straight. Developed by tldev, the app leverages the Apple Vision framework for real-time body pose and face detection, translating this data into a screen blur effect when slouching is detected. This summary delves into the app's functionality, features, installation process, limitations, and development details.

At its core, Posturr utilizes the Vision framework to track key body landmarks, specifically focusing on the nose and shoulders. The application then calculates the vertical distance between these points to determine the degree of slouching. This posture analysis triggers a progressive screen blur, with the intensity of the blur scaling proportionally to the postural deviation. This visual feedback is intended to establish a subconscious reminder to maintain an upright posture. The developer, Tom Johnell (tldev), prioritized a lightweight, privacy-focused solution, operating entirely locally on the user’s Mac.

**Key Features:**

* **Real-time Posture Detection:** The app relies on the Vision framework’s advanced body pose and face tracking capabilities to accurately monitor the user's posture.
* **Progressive Screen Blur:** The core functionality utilizes macOS’s CoreGraphics API (with a fallback to NSVisualEffectView for compatibility) to apply a screen blur effect, the intensity of which increases with slouching.
* **Menu Bar Controls:** Posturr incorporates intuitive controls within the menu bar, allowing users to easily manage the application’s state. These controls include:
* **Status:** Displays the current posture assessment (Monitoring, Slouching, Good Posture, etc.).
* **Enabled/Disabled:** Toggles the posture monitoring functionality on or off.
* **Recalibrate:** Allows initial baseline posture calibration, crucial for accurate detection.
* **Sensitivity:** Adjusts the degree of slouch required to trigger the blur effect. Options range from ‘Low’ to ‘Very High’.
* **Dead Zone:** Sets a tolerance radius before the blur kicks in, preventing false triggers caused by slight shifts in posture.
* **Compatibility Mode:** Enables an alternative blur implementation utilizing NSVisualEffectView, enabling functionality on systems with potential CoreGraphics issues.
* **Quit:** Exits the application.
* **Multi-Display Support:** The app functions across all connected monitors on the user’s Mac.
* **Privacy-Focused:** All data processing occurs locally, ensuring no video or posture data is transmitted to external servers. This underlines the importance of user privacy.
* **Lightweight:** The app’s design prioritizes minimal resource utilization, ensuring a seamless experience.
* **No Account Required:** The application does not necessitate a user account, eliminating the need for registration or cloud synchronization.

**Installation and Usage:**

Posturr’s installation is streamlined, offering both Homebrew and manual options. The recommended installation method utilizes Homebrew, a popular package manager. Manual installation involves downloading the application and adding it to the Applications folder. The app requires macOS 13.0 (Ventura) or later and utilizes the Xcode Command Line Tools. Precise camera permission is required, which is requested upon initial launch.

**Limitations and Caveats:**

The application’s effectiveness is contingent on adequate lighting and a clear view of the user's upper body and face. The accuracy of the posture detection relies heavily on factors such as camera positioning and environmental conditions. The developer acknowledges that detection accuracy is best achieved when the camera is positioned at eye level. Furthermore, the reliance on CoreGraphics (with a fallback) suggests potential compatibility concerns on certain macOS versions.

**Development Details:**

The application leverages Swift for development and is built using the Vision framework for body pose detection. The team employed Xcode Command Line Tools and Swift Package Manager (SwiftPM) for building the project, with contributions from several individuals. The project incorporates both a command-line interface (CLI) for advanced control and supports a structured build process. The CLI allows users to take a photo, set the blur level, and exit the application, with command outputs displayed in a temporary file.

**Contributing and Acknowledgements:**

The development team at tldev gratefully acknowledges the contributions of key individuals who assisted in the project, including Claude, Cam Brown, and Einsteinx2. The app's success is attributed to technology developed by Apple's Vision framework and relies on CoreGraphics for blur implementation. The team has highlighted the importance of user privacy and has explicitly mentioned the need for adequate lighting and a clear view of the user’s body for optimal performance.