Skip to content

Retro-Ace/TimeThrottle

Repository files navigation

TimeThrottle

How much time did speed really buy you?

TimeThrottle is an iPhone pace-analysis app that helps drivers understand what faster driving actually bought them.

Apple Maps provides route lookup, autocomplete, route options, and the ETA baseline. TimeThrottle then tracks or compares pace tradeoffs such as above-target gain, below-target loss, fuel penalty, and overall result versus Apple ETA where that baseline exists.

TimeThrottle does not provide built-in turn-by-turn navigation. In Live Drive, it can hand off navigation to Apple Maps, Google Maps, or Waze while TimeThrottle continues tracking the trip and comparing pace tradeoffs.

How much time did speed really buy you?

What's New in v1.3.2

Use this block for GitHub, TestFlight, and App Store Connect release copy:

TimeThrottle 1.3.2

  • Added a cleaner compact Live Drive HUD for in-motion use
  • Improved one-screen HUD fit so trip status, Apple ETA, projected arrival, and controls are easier to reach
  • Clarified HUD metric wording around Apple ETA and target-speed time
  • Better balanced the lower HUD map area without claiming built-in navigation
  • Kept the app focused on two modes: Live Drive and Compare

What's New in v1.3.1

Use this block for GitHub, TestFlight, and App Store Connect release copy:

TimeThrottle 1.3.1

  • Clarified finished-trip result labels so Above-target gain, Below-target loss, and Overall vs Apple ETA are clearly separated
  • Updated Trip History, trip detail, and shared trip summaries to use the same Apple ETA baseline framing
  • Tightened in-app and release-facing wording around finished-trip metrics for consistency
  • Simplified the active iPhone app to two intentional modes: Live Drive and Compare

What's New in v1.3

Use this block for GitHub, TestFlight, and App Store Connect release copy:

TimeThrottle 1.3

  • Added Pause, Resume, and End Trip controls for Live Drive
  • Finished trips now stay visible after completion
  • Added optional Observed MPG fuel refinement after a drive
  • Added Trip History for completed Live Drive trips
  • Added a shareable finished-trip summary
  • Added Waze as a navigation handoff option
  • Improved the navigation provider selector and trip-status timing
  • Added a destination clear control during route setup
  • Added a small safety reminder to obey traffic laws and road conditions

Core Modes

Live Drive

Live Drive is the real-time trip analysis mode.

It can:

  • Capture an Apple Maps route and ETA baseline
  • Use Current Location as the default route start
  • Offer Apple Maps-style address autocomplete for route setup
  • Track speed, distance, and trip progress with iPhone location services
  • Open a compact in-app Drive HUD with current speed, Apple ETA, projected arrival, and pause/end controls
  • Pause, resume, and end the active trip without losing the finished result
  • Compare live projected pace against the Apple ETA baseline
  • Show above-target gain, below-target loss, fuel penalty, and overall result vs Apple ETA on completed trips
  • Keep completed trips visible for review, sharing, and optional Observed MPG refinement
  • Save completed Live Drive trips into local Trip History
  • Hand off navigation to Apple Maps, Google Maps, or Waze without claiming built-in navigation

Compare

Compare is the Apple Maps ETA-baseline planning and simulation mode.

It includes:

  • Apple Maps route lookup
  • Route options
  • Route preview
  • Apple ETA baseline
  • Pace comparison input
  • Final result versus Apple ETA

Live Drive HUD in v1.3.2

TimeThrottle 1.3.2 includes a compact in-app Live Drive HUD that opens when a drive starts.

The HUD is designed to keep the most useful trip data easy to glance at:

  • Current speed as the primary metric
  • Apple ETA as the baseline route reference
  • Projected arrival using current trip progress
  • Time above target speed and time below target speed
  • Pause / Resume and End Trip controls

It stays powered by the same real TimeThrottle trip state already used in Live Drive and does not claim built-in turn-by-turn navigation, live traffic, or road speed-limit data.

Navigation Handoff in v1.3.2

TimeThrottle 1.3.2 still keeps Apple Maps as the planning layer and Apple ETA baseline source.

During Live Drive, users can choose:

  • Apple Maps
  • Google Maps
  • Waze
  • Ask Every Time

When a Live Drive starts, TimeThrottle starts trip tracking first, then opens the selected navigation app if background continuity requirements are met. If Google Maps or Waze is not installed, the app falls back cleanly instead of leaving the user stuck.

Product Positioning

TimeThrottle is a pace-analysis app, not a navigation replacement.

The app is designed to answer questions like:

  • Did driving faster meaningfully change the trip?
  • How much above-target gain did the trip create?
  • How much below-target loss built up during the trip?
  • How did the finished trip land versus the Apple ETA baseline?
  • What was the fuel penalty?
  • Was the overall tradeoff worth it?

Safety Note

TimeThrottle includes a small reminder during Live Drive and trip review screens:

Always obey traffic laws and road conditions.

Privacy at a Glance

  • No user account is required
  • Apple Maps is used for route lookup, autocomplete resolution, route options, and ETA baseline planning
  • Live Drive uses iPhone location services when the user enables them
  • External navigation handoff is optional
  • Completed Live Drive trips are stored locally on-device
  • The preferred navigation app choice is stored locally on-device
  • Sharing only happens when the user explicitly opens the iOS share sheet

For the full policy, see privacy-policy.md.

Tech Overview

  • Platform: iPhone / iOS only
  • Deployment target: iOS 17+
  • Bundle ID: com.timethrottle.app
  • Current release: v1.3.2
  • Current build: 5
  • Primary app target: TimeThrottle.xcodeproj
  • Primary shared UI: Sources/SharedUI/RouteComparisonView.swift

Core Components

  • LiveDriveTracker.swift — Live Drive tracking, permission state, speed, and distance updates
  • TripHistoryStore.swift — local persistence for completed Live Drive trips
  • TripAnalysisEngine.swift — live pace/trip summary generation
  • SpeedCostCalculator.swift — shared pace and fuel-tradeoff math
  • TimeThrottleCalculator.swift — shared trip-comparison math for Apple Maps ETA-baseline comparisons
  • RouteModels.swift — shared route, lookup, autocomplete, and mode models
  • LiveDriveHUDView.swift — compact in-app Live Drive HUD
  • NavigationHandoffService.swift — Apple Maps / Google Maps / Waze / Ask Every Time handoff behavior

Repository Layout

TimeThrottle
├── TimeThrottle.xcodeproj
├── TimeThrottle.xcworkspace
├── README.md
├── CHANGELOG.md
├── privacy-policy.md
├── Assets.xcassets
├── Resources
│   ├── iOS
│   ├── LaunchScreen.storyboard
│   └── TimeThrottleLogo
├── Sources
│   ├── Core
│   ├── SharedUI
│   └── iOS
├── Tests
│   └── CoreTests
├── scripts
└── dist-ios

Build Notes

  • Main iOS app scheme: TimeThrottle
  • Simulator packaging script: ./dist-ios
  • Current packaging path: dist/iOSSimulator/TimeThrottle.app
  • Generated build outputs live in build/ and dist/ and are intentionally git-ignored

Support

For support or privacy questions, contact: fixitall329@gmail.com

About

See if driving faster is actually worth it. Calculate time saved vs fuel cost instantly.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors