# labexp/osmtracker-android architecture

> Architecture diagram of the GitHub repository labexp/osmtracker-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/labexp/osmtracker-android
- Repository: https://github.com/labexp/osmtracker-android

## Overview

##### Project type and purpose
- This is a native Android mobile application (“OSMTracker for Android™”) whose primary purpose is to record GPS tracks, allow users to drop POIs (via buttons, voice, photos, text), persist them in a local GPX-compatible SQLite database, and optionally upload to the OpenStreetMap™ server.

##### File structure
- **app/src/main/java/net/osmtracker/activity** – Presentation layer: Android Activities and Adapters for UI screens (track list, map, track logger, preferences, etc.).
- **app/src/main/java/net.osmtracker/db** – Persistence layer: DataHelper, SQLiteOpenHelper (DatabaseHelper), ContentProvider (TrackContentProvider), model classes (Track, WayPoint, TrackPoint).
- **app/src/main/java/net.osmtracker/gpx** – Domain logic for exporting GPX tracks to storage, zipping, temporary files.
- **app/src/main/java/net.osmtracker/osm** – Integration with OSM server: HTTP upload tasks, REST constants.
- **app/src/main/java/net.osmtracker/layout** – Custom‐buttons and layout download code, XML parsers, network tasks for layout files.
- **app/src/main/java/net.osmtracker/util** – Utility classes (file system, projections, URL creation, theme validation).
- **app/src/main/java/net.osmtracker/view** – Custom Views and dialogs.
- **Configuration & CI**: fastlane, GitHub Actions, Travis, Transifex config appear but are orthogonal to runtime architecture.

##### README
- Confirms it is a GPS-tracking app for mappers/hikers.
- Mentions GPX, custom button layouts, voice/picture/note POIs, OSM upload.

##### Be very detailed—capture every essential architectural element
- Sensors / media capture as separate subcomponents.
- If desired, annotate lifecycle triggers (e.g., “onCreate → bindService”).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        TrackListRVAdapter["TrackListRVAdapter"]:::ui
        TrackLoggerActivity["TrackLoggerActivity"]:::ui
        DisplayTrackMapActivity["DisplayTrackMapActivity"]:::ui
        PreferencesActivity["PreferencesActivity"]:::ui
        OpenStreetMapUploadUI["OpenStreetMapUpload"]:::ui
        DisplayTrackView["DisplayTrackView"]:::ui
        TextNoteDialog["TextNoteDialog"]:::ui
        VoiceRecDialog["VoiceRecDialog"]:::ui
    end

    %% Background Services & Listeners
    subgraph "Background Services & Listeners"
        direction TB
        GPSLoggerService["GPSLoggerService"]:::service
        GPSServiceConnection["GPSLoggerServiceConnection"]:::service
        SensorListener["SensorListener"]:::service
        PressureListener["PressureListener"]:::service
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        TrackContentProvider["TrackContentProvider"]:::db
        DatabaseHelper["DatabaseHelper"]:::db
        DataHelper["DataHelper"]:::db
        TrackListAdapter["TracklistAdapter"]:::db
        WaypointListAdapter["WaypointListAdapter"]:::db
        subgraph "Domain Models"
            direction TB
            TrackModel["Track"]:::db
            WayPointModel["WayPoint"]:::db
            TrackPointModel["TrackPoint"]:::db
        end
        DB["SQLite DB"]:::db_cyl
    end

    %% GPX Export Layer
    subgraph "GPX Export Layer"
        direction TB
        ExportToStorageTask["ExportToStorageTask"]:::domain
        ExportToTempFileTask["ExportToTempFileTask"]:::domain
        ExportTrackTask["ExportTrackTask"]:::domain
        ZipHelper["ZipHelper"]:::domain
    end

    %% Layout Management
    subgraph "Layout Management"
        direction TB
        DownloadCustomLayoutTask["DownloadCustomLayoutTask"]:::network
        URLValidatorTask["URLValidatorTask"]:::network
        GetStringResponseTask["GetStringResponseTask"]:::network
        UserDefinedLayoutReader["UserDefinedLayoutReader"]:::network
    end

    %% OSM Integration
    subgraph "OSM Integration"
        direction TB
        OpenStreetMapConstants["OpenStreetMapConstants"]:::external
        UploadToOSMTask["UploadToOpenStreetMapTask"]:::external
        Internet["Internet"]:::cloud
    end

    %% File System & Media
    subgraph "File System & Media"
        direction TB
        DefaultButtonsLayout["default_buttons_layout.xml"]:::file
        FilepathsConfig["filepaths.xml"]:::file
        MediaButtonReceiver["MediaButtonReceiver"]:::service
        FileSystemUtils["FileSystemUtils"]:::service
    end

    %% Relationships
    TrackLoggerActivity -->|binds to| GPSLoggerService
    GPSLoggerServiceConnection --> GPSLoggerService
    GPSLoggerService -->|writes| TrackContentProvider
    TrackLoggerActivity -->|writes| TrackContentProvider
    TrackListRVAdapter -.->|queries| TrackContentProvider
    TrackContentProvider -->|manages| DB

    TrackLoggerActivity -->|reads/writes| DatabaseHelper
    DisplayTrackMapActivity -->|queries| TrackContentProvider
    PreferencesActivity -->|invokes export| ExportTrackTask
    ExportTrackTask -->|reads| TrackContentProvider
    ExportTrackTask -->|writes .gpx| FileSystemUtils
    ZipHelper -->|zips .gpx| FileSystemUtils

    OpenStreetMapUploadUI -->|invokes upload| UploadToOSMTask
    UploadToOSMTask -->|posts to| Internet

    PreferencesActivity -->|fetch layout| DownloadCustomLayoutTask
    DownloadCustomLayoutTask -->|parses| GetStringResponseTask
    GetStringResponseTask -->|reads XML| UserDefinedLayoutReader
    UserDefinedLayoutReader -->|stores| DataHelper

    GPSLoggerService --> SensorListener
    GPSLoggerService --> PressureListener

    VoiceRecDialog -->|uses| MediaButtonReceiver

    %% Click Events
    click TrackListRVAdapter "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/activity/TrackListRVAdapter.java"
    click TrackLoggerActivity "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/activity/TrackLogger.java"
    click DisplayTrackMapActivity "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/activity/DisplayTrackMap.java"
    click PreferencesActivity "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/activity/Preferences.java"
    click OpenStreetMapUploadUI "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/activity/OpenStreetMapUpload.java"
    click DisplayTrackView "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/view/DisplayTrackView.java"
    click TextNoteDialog "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/view/TextNoteDialog.java"
    click VoiceRecDialog "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/view/VoiceRecDialog.java"
    click GPSLoggerService "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/service/gps/GPSLogger.java"
    click GPSServiceConnection "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/service/gps/GPSLoggerServiceConnection.java"
    click SensorListener "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/listener/SensorListener.java"
    click PressureListener "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/listener/PressureListener.java"
    click DatabaseHelper "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/DatabaseHelper.java"
    click DataHelper "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/DataHelper.java"
    click TrackContentProvider "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/TrackContentProvider.java"
    click TrackListAdapter "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/TracklistAdapter.java"
    click WaypointListAdapter "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/WaypointListAdapter.java"
    click TrackModel "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/model/Track.java"
    click WayPointModel "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/model/WayPoint.java"
    click TrackPointModel "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/db/model/TrackPoint.java"
    click ExportToStorageTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/gpx/ExportToStorageTask.java"
    click ExportToTempFileTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/gpx/ExportToTempFileTask.java"
    click ExportTrackTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/gpx/ExportTrackTask.java"
    click ZipHelper "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/gpx/ZipHelper.java"
    click DownloadCustomLayoutTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/layout/DownloadCustomLayoutTask.java"
    click URLValidatorTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/layout/URLValidatorTask.java"
    click GetStringResponseTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/layout/GetStringResponseTask.java"
    click UserDefinedLayoutReader "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/util/UserDefinedLayoutReader.java"
    click OpenStreetMapConstants "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/osm/OpenStreetMapConstants.java"
    click UploadToOSMTask "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/osm/UploadToOpenStreetMapTask.java"
    click DefaultButtonsLayout "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/res/xml/default_buttons_layout.xml"
    click FilepathsConfig "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/res/xml/filepaths.xml"
    click MediaButtonReceiver "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/receiver/MediaButtonReceiver.java"
    click FileSystemUtils "https://github.com/labexp/osmtracker-android/blob/master/app/src/main/java/net/osmtracker/util/FileSystemUtils.java"

    %% Styles
    classDef ui fill:#cde8ff,stroke:#0366d6,color:#0366d6
    classDef service fill:#d4f5d4,stroke:#28a745,color:#28a745
    classDef db fill:#fff5c2,stroke:#e3a008,color:#e3a008
    classDef db_cyl fill:#fff5c2,stroke:#e3a008,color:#e3a008,shape:cylinder
    classDef domain fill:#ffe4b5,stroke:#d48b00,color:#d48b00
    classDef network fill:#f0eafc,stroke:#6f42c1,color:#6f42c1
    classDef external fill:#eaeaea,stroke:#6a737d,color:#6a737d
    classDef cloud fill:#e0f7fa,stroke:#00796b,color:#00796b,shape:cloud
    classDef file fill:#fbe8a6,stroke:#d15704,color:#d15704,shape:file
```
