🧍

Posture Alert

Support & Documentation

Track Your Posture with AirPods

Posture Alert uses your AirPods' motion sensors to monitor your head position in real-time, helping you maintain better posture throughout the day.

🚀Quick Start

🎧

1. Connect AirPods

Connect your AirPods Pro, AirPods Max, or AirPods (3rd gen or later) to your device.

▶️

2. Start Tracking

Click "Start Tracking" from the menu bar (macOS) or dashboard (iOS) to begin monitoring.

📊

3. View Insights

Monitor real-time data and review your posture history to track improvements.

Features

📈Real-Time Monitoring

Track your head pitch in real-time with live visual feedback showing your current posture.

  • • Animated figure showing head position
  • • Color-coded alerts (green = good, red = poor)
  • • Live pitch angle display

🔔Smart Alerts

Get notified when your posture needs correction with customizable thresholds.

  • • Configurable pitch threshold (default: -30°)
  • • Buffer time to avoid false alerts (default: 3s)
  • • Toggle alerts on/off

📊Session History

Review your posture data over time with detailed charts and session logs.

  • • Automatic session recording
  • • Configurable data point intervals
  • • Historical trend analysis

🎯Background Tracking (iOS)

Continue tracking even when the app is in the background on iOS.

  • • Extended background execution (3-10 min)
  • • Silent audio session for continuous tracking
  • • Automatic data synchronization

🎧Compatible Devices

Posture Alert requires AirPods with motion sensors:

AirPods Pro

(1st & 2nd gen)

AirPods Max

All generations

AirPods

(3rd gen or later)

Note: Standard AirPods (1st & 2nd gen) and other Bluetooth headphones do not have motion sensors and are not compatible.

⚙️Settings Guide

Posture Thresholds

  • Buffer Time: How long your head must be down before triggering an alert (default: 3 seconds)
  • Pitch Threshold: The angle at which alerts trigger (default: -30°, more negative = looking down more)

Data Collection

  • Data Point Interval: How often to record average pitch (10s, 30s, 1min, 2min, or 5min)

Notifications

  • Posture Alerts: Enable/disable notifications when poor posture is detected

💡 Tip: Settings are locked while tracking is active to prevent accidental changes.

🔧Troubleshooting

"Motion-Capable Headphones Required" alert appears

This means your current headphones don't support motion tracking. Try:

  • • Verify you're using AirPods Pro, AirPods Max, or AirPods (3rd gen or later)
  • • Reconnect your AirPods via Bluetooth
  • • Restart the app and try again
  • • Check that your AirPods firmware is up to date
No data appearing in charts

Charts populate based on your data point interval setting:

  • • Wait for at least one interval period (e.g., 5 minutes if set to 5-min intervals)
  • • Check Settings → Data Collection to see your current interval
  • • In DEBUG mode, intervals are set to 10 seconds for faster testing
Tracking stops when app is in background (iOS)

iOS has limitations on background execution:

  • • Enable "Continuous Background Tracking" in Settings
  • • This extends background time to 3-10 minutes using audio session
  • • For longer tracking, keep the app in foreground
  • • Background tracking is unlimited on macOS
Alerts are too sensitive or not sensitive enough

Customize alert sensitivity in Settings:

  • Increase Buffer Time: Reduce false alerts (try 5-10 seconds)
  • Adjust Pitch Threshold: More negative = stricter (e.g., -40° for less alerts, -20° for more)
  • • Stop tracking to modify settings
App update required / Force update screen

Major version updates (e.g., 1.x → 2.x) require updating:

  • • Click "Update Now" to open the App Store (macOS or iOS)
  • • Major updates include breaking changes or critical fixes
  • • Minor updates (e.g., 1.0 → 1.2) show an optional banner

🔒Privacy & Data

Your privacy is important. Here's how Posture Alert handles your data:

  • Local Storage Only: All posture data is stored locally on your device using UserDefaults
  • No Cloud Sync: Your data never leaves your device
  • No Analytics: We don't collect usage statistics or personal information
  • Motion Data: Only used for real-time posture tracking, not recorded or transmitted

💻System Requirements

🖥️macOS

  • • macOS 13.0 (Ventura) or later
  • • Compatible AirPods (see above)
  • • Bluetooth enabled
  • • ~50 MB storage space

📱iOS

  • • iOS 16.0 or later
  • • Compatible AirPods (see above)
  • • Bluetooth enabled
  • • ~50 MB storage space

Need More Help?

Contact the developer directly for support.