Headache Logger

One-tap headache tracking for iPhone & Apple Watch.

Log a headache in one tap. The app automatically captures 50+ data points from Apple Health and local weather. Export a doctor-friendly CSV whenever you're ready.

Free. No ads. No accounts. No cloud. Open source.

Website | App Store | Privacy Policy | Support

Features

• One tap - Log a headache instantly. No forms, no questions, no typing.
• Apple Health context - Steps, sleep, HRV, resting heart rate, SpO2, VO2max, workouts, audio exposure, mindful minutes, and more.
• Weather & environment - Temperature, barometric pressure + trend, humidity, wind, UV index, precipitation, cloud cover.
• Air quality - US AQI, EU AQI, PM2.5, PM10, ozone, NO2, SO2, CO.
• Pollen - Alder, birch, grass, mugwort, olive, ragweed.
• Time patterns - Weekday, hour, part of day, timezone.
• Apple Watch - One-tap logging from your wrist. Entries queue and sync automatically.
• Home screen widget - Log without opening the app via WidgetKit + App Intents.
• Siri Shortcuts - Automate logging with the "Log Headache" intent.
• CSV export - 60+ columns. Share via email, AirDrop, or any share destination.
• Doctor-friendly - Designed for clinical sharing with both metric and imperial units.

Privacy

Headache Logger stores everything on your device. No accounts, no analytics, no ads, no cloud sync.

Location is used once per tap to fetch local weather from Open-Meteo. Raw coordinates are never stored. Your data leaves your device only when you explicitly export it.

Full privacy policy

Tech Stack

Framework	Purpose
SwiftUI	UI
SwiftData	Local persistence
HealthKit	Apple Health integration (read-only)
CoreLocation	Location for weather lookup
Open-Meteo API	Weather
WidgetKit + App Intents	Home screen widget
WatchConnectivity	Apple Watch sync
XcodeGen	Project generation

Repo Layout

HeadacheLogger/          iPhone app
HeadacheLoggerWatch/     Apple Watch companion
HeadacheLoggerWidget/    Home screen widget extension
HeadacheLoggerTests/     Unit tests
SharedHeadache/          App group helpers and shared keys
docs/                    GitHub Pages (landing page, privacy, support)
scripts/                 Helper scripts (e.g. TestFlight upload)

Build

xcodegen generate
xcodebuild -project HeadacheLogger.xcodeproj -scheme HeadacheLogger -destination 'generic/platform=iOS' build

Test

xcodebuild -project HeadacheLogger.xcodeproj -scheme HeadacheLogger -destination 'platform=iOS Simulator,name=iPhone 17' test

License

See LICENSE for details.

Author

Jack Wallner — [email protected]