A gentle iOS companion for tracking symptoms and daily patterns.
Murmur helps you notice and understand patterns in how you feel. Whether you're managing a chronic condition, tracking symptoms, or just trying to understand what affects your wellbeing, it offers a simple way to log what's happening and see connections over time.
- Timeline view - Browse your symptom history day by day
- Quick logging - Record symptoms with a 1-5 severity scale
- Activity tracking - Note events that might influence how you feel
- Pattern analysis - Visualise trends and potential connections
- Reminders - Gentle prompts to log entries when you need them
- Manual cycle tracking - Track menstrual cycles alongside other symptoms
- HealthKit integration - Connect with Apple Health data
- Accessibility - Voice commands, switch control, and audio graphs
- Privacy first - Your data stays on your device, with optional backup
- Export options - Share data with healthcare providers as PDFs
Living with symptoms that come and go can be isolating. Murmur was built to make tracking less of a chore and more of a helpful practice. No medical jargon, no overwhelming features - just what you need to notice patterns and have better conversations with your healthcare team.
- Clone this repository
- Open
Murmur.xcodeprojin Xcode - Build and run on your iOS device or simulator
The app includes an onboarding flow that will guide you through initial setup.
- Built with SwiftUI and Core Data
- Supports iOS 16 and later
- Integrates with HealthKit, Location Services, and Calendar
- Includes StoreKit configuration for optional tip jar support
- Automated testing and deployment with fastlane
The project uses fastlane for test automation and screenshot generation:
fastlane ios test- Run unit tests with coverage (< 1 min)fastlane ios test_ui- Run UI tests on iPhone and iPad (2-3 mins)fastlane ios test_smoke- Quick validation of core functionality (~1 min)fastlane ios test_all- Standard test suite (3-5 mins)fastlane ios test_complete- Full test suite including all HealthKit tests (10-15 mins)
fastlane ios test_healthkit- Test with 7 days of synthetic data (1-2 mins)fastlane ios test_healthkit_extended- Test with 30 days of data (3-5 mins)fastlane ios test_healthkit_deterministic- Verify reproducible data generation (~1 min)
fastlane ios screenshots- Generate App Store screenshotsfastlane ios prepare_framed_screenshots- Generate screenshots with device frames
Run fastlane ios clean to remove test outputs and screenshots.
All symptom data is stored locally using Core Data. HealthKit integration is optional and always under your control. The app includes backup and export features, but you choose when and where your data goes.
This is a personal health tool, but suggestions and improvements are welcome. If you've found it helpful or have ideas to make it better, please open an issue or submit a pull request.
MIT License - see LICENSE file for details. The name, logo, and branding are protected, and commercial app store distribution requires substantial modifications, distinct branding, and proper attribution to prevent low-effort clones. The MIT-licensed code can be freely used and modified.
If you find Murmur helpful, the app includes an optional tip jar. There's no pressure and all features work regardless.
Murmur is a tracking tool, not medical advice. Always consult with healthcare professionals about your symptoms and treatment.