Open source, privacy-first iOS location tracking — your data stays on your device.

iso.me is a location tracking app for iOS and watchOS. It automatically records the places you visit throughout the day, tracks routes with continuous GPS logging, and keeps every byte of your data on-device. No accounts. No cloud sync. No third-party dependencies. No analytics. Just you, your phone, and your history.

🌐 isome.isolated.tech · 📲 Download on the App Store · 🛠 Contribute · 💬 Discussions · 👥 Discord · ⭐ Star this repo

Capture every visit	Keep it on-device	Export your history

Automatic background detection of places you arrive at and depart from, powered by CLLocationManager visit monitoring. Each visit is reverse-geocoded to show a human-readable address and location name.

High-accuracy GPS tracking that records your exact path. Configurable distance filter (5m-200m) and auto-off timer (30 min to never). Tracked points include altitude, speed, and accuracy metadata.

Real-time tracking status on the lock screen and Dynamic Island. Shows current location, distance traveled, points recorded, and remaining auto-off time.

Export visits and location points as JSON, CSV, or Markdown. Choose a date range, time-of-day window, and per-format field toggles, and either condense everything into a single file or split the export into one file per day for easier downstream slicing. Customize filenames and dated subfolders with tokens (for example, Markdown can use {year}/{year}-{month}/Daily Track - {date}.md). Optionally set a default export folder for one-tap saves and schedule a daily auto-export. Scheduled exports use a routing-only APNs worker to wake the app near your selected time; your location records, files, folder paths, and filename templates stay on-device. Import previously exported data back into the app. Export is the one paid feature — see Pricing.

Exports drop in cleanly to the iso.me Maps Obsidian plugin, which renders visits, routes, heatmaps, and outliers as Leaflet maps inline in your notes — point a code block at a single condensed export, a folder of per-day files, or a filename glob.

Companion watchOS app showing today's visit count, distance traveled, and tracking status. Syncs with the main app via shared App Groups.

iOS lock screen widget via Live Activities and watchOS complications for quick tracking status.

Tracking is free and unlimited — visits, continuous routes, watch app, Live Activities, widgets. No subscription, no ads, no usage caps.

The one paid feature is export: a one-time $9.99 unlock for JSON, CSV, and Markdown export of your visits and location points. Lifetime, no recurring charge.

The split is on purpose: tracking is the commodity, but a clean, lossless export of your full history is the part that's worth paying for once. It also keeps the privacy promise free at the door — you never have to pay to keep your data on your device.

• Language: Swift 5
• UI: SwiftUI
• Data: SwiftData
• Minimum iOS: 17.0
• Minimum watchOS: 10.0
• Dependencies: None (all native Apple frameworks)

IsoMe/
  Models/
    Visit.swift                    # Visit data model (coordinates, times, address)
    LocationPoint.swift            # Continuous tracking point model
    LocationActivityAttributes.swift  # Live Activity state
  Services/
    LocationManager.swift          # Core location tracking logic
    ActivityDetectionManager.swift # CoreMotion activity detection
    LiveActivityManager.swift      # Live Activity lifecycle
    GeocodingService.swift         # Reverse geocoding with caching
    StoreManager.swift             # In-app purchase management
    LogManager.swift               # Crash and debug logging
  ViewModels/
    LocationViewModel.swift        # Data coordination between UI and services
  Views/
    ContentView.swift              # Root view with onboarding and tab navigation
    TrackingView.swift             # Tracking controls
    MapView.swift                  # Map with visit pins
    SessionPathMapView.swift       # Route path visualization
    SettingsView.swift             # Preferences, export, import, data management
    VisitDetailView.swift          # Individual visit details
    PaywallView.swift              # Pro upgrade screen
    LogViewerView.swift            # Debug log viewer
  Utilities/
    ExportService.swift            # JSON/CSV/Markdown export
    ImportService.swift            # Data import parsing
    ExportFolderManager.swift      # Default export folder management
    DistanceFormatter.swift        # Metric/imperial formatting
    TEDesign.swift                 # Design tokens and typography
  IsoMeApp.swift                   # App entry point
  AppDelegate.swift                # Background launch handling

IsoMeWidget/                       # iOS widget and Live Activity extension
IsoMeWatch/                        # watchOS companion app
IsoMeWatchWidget/                  # watchOS widget extension
Shared/                            # Shared code (App Group data sync)

1. Open IsoMe.xcodeproj in Xcode 15+
2. Select the IsoMe scheme
3. Set your development team for all four targets
4. Configure the App Group entitlement (group.com.bontecou.isome) for your team
5. Build and run on a physical device (location features require real hardware)

Run the app unit tests with:

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

Export round-trip coverage lives in IsoMeTests/ExportRoundTripTests.swift. It uses inline representative visit and route-point fixtures, renders JSON, CSV, Markdown, GeoJSON, GPX, OwnTracks, and Overland through ExportService.render, then parses each payload back into normalized records while asserting the emitted schema keys. OwnTracks and Overland are points-only protocols, so their cases verify route points and explicitly assert that visits are not emitted.

The app requests the following permissions at runtime:

• Location (Always) - Background visit detection and tracking
• Location (When in Use) - Foreground location display
• Motion & Fitness - Activity detection for auto-start feature

• App Groups (group.com.bontecou.isome) - Shared data between app, widgets, and watch
• Background Modes: Location updates
• Live Activities support

The app registers the isome:// URL scheme. Currently supports:

• isome://stop - Stops continuous tracking (used by Live Activity)

Contributions are welcome — bug reports, feature ideas, and pull requests. See CONTRIBUTING.md for the full setup guide (Xcode, signing, TestFlight) and a list of good first issues.

If you want to chat about the project, design decisions, or what to build next, jump into GitHub Discussions.

iso.me is licensed under the GNU Affero General Public License v3.0. The AGPL ensures that any modified version of iso.me — including ones run as a hosted service — must also be open source. This protects the privacy-first promise: nobody can take iso.me, bolt on tracking, and ship it as a closed product.