Skip to content

Latest commit

 

History

502 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JourneyDeck

Your journeys, places, and music—beautifully remembered.

A private driving journal for Tesla data, any-car iPhone recording, Spotify history, maps, memories, and personal insights.

Version 6.0.1 · Personal project · Web, iPhone Recorder, and Windows desktop

JourneyDeck Overview with fictional demo data

Every vehicle, location, journey, metric, artist, and recording shown here is fictional demo data. No personal location history is included.

What is JourneyDeck?

JourneyDeck turns everyday travel into a private, searchable story. It brings together where you went, how you got there, what you listened to, and the patterns that emerge over time.

Journeys can arrive automatically from a Tesla through Tessie or be recorded directly by the JourneyDeck Recorder on an iPhone. Both sources feed the same Timeline, Atlas, Memories, music views, and statistics.

JourneyDeck is currently a personal, single-household project—not a public hosted service.

Highlights

  • Overview and Live — current vehicle state, latest journey, battery, range, recent music, and quick actions.
  • Timeline — journeys, charging, songs, and stops arranged in chronological order.
  • Memories — collect journeys into visual chapters such as road trips, weekends, seasons, and favorites.
  • Atlas — explore places, routes, recurring patterns, and changes in your personal mobility graph.
  • Journey Music — connect Spotify listening history to the miles where each song played.
  • Statistics — mileage, energy, efficiency, drive time, music, Autopilot, and period comparisons.
  • Privacy-aware sharing — generate journey cards without exposing a home address or exact private coordinates.
  • Responsive access — use the hosted dashboard on desktop or mobile, or package the Windows desktop experience.

Record with Tesla—or just an iPhone

Tesla + Tessie JourneyDeck Recorder
Works with A Tesla connected to Tessie Any car, rental, walk, or road trip
Capture Automatic telemetry import Start and finish from the iPhone app
Data Route, vehicle, battery, charging, efficiency, and drive metrics GPS route, time, distance, and speed metrics
Background use Cloud synchronization Continues while the iPhone is locked
Offline behavior Depends on the vehicle provider Queues points safely and retries automatically

The two approaches can coexist. Recorder journeys are labeled clearly and appear alongside provider-imported journeys.

Memories made from the road

JourneyDeck Memories with fictional demo collections

Build collections, combine them into larger Memories, attach photos, and revisit the routes and music that made a season or trip memorable.

JourneyDeck Recorder for iPhone

JourneyDeck Recorder with fictional recording metrics

The Recorder is a small Expo iOS companion that captures background GPS without requiring a Tesla. It stores the private server key in iOS Keychain, keeps an offline SQLite queue, retries uploads safely, and creates a normal JourneyDeck journey when recording finishes.

Locking the phone is fine; force-quitting the Recorder stops iOS background location until the app is reopened.

Try the demo UI

The repository includes a privacy-safe mock server with fictional journeys and music. With Node.js 24 or newer:

git clone https://github.com/drumpat01/DriveOS.git
cd DriveOS
npm install
node tests/mock-web-server.mjs

Open http://127.0.0.1:8790 to explore the interface without connecting any accounts.

Run your own JourneyDeck

JourneyDeck is designed for a technically comfortable owner who wants to operate a private archive. A full setup needs:

  1. A JourneyDeck server and SQLite or Turso database.
  2. At least one journey source: Tessie for Tesla or the iOS Recorder for any vehicle.
  3. Optional Spotify OAuth for listening history and journey soundtracks.
  4. Optional place enrichment for friendlier destination names.

Choose the guide that matches your setup:

Development

Install dependencies and run the full validation suite:

npm install
.\tools\Test-DriveOS.ps1

README screenshots can be regenerated entirely from fictional fixtures:

node tools/capture-readme-screenshots.mjs

Architecture and migration notes live in docs/ARCHITECTURE.md and docs/MIGRATION-ROADMAP.md.

Privacy and project status

  • JourneyDeck contains sensitive location history and should remain behind strong authentication.
  • Hosted secrets stay in the deployment environment; Recorder credentials stay in iOS Keychain.
  • Local runtime data, credentials, logs, and generated databases are excluded from Git.
  • The project is a personal beta and still assumes a trusted owner or household rather than public multi-user onboarding.

JourneyDeck is not affiliated with or endorsed by Tesla, Tessie, Spotify, Apple, Expo, Foursquare, OpenFreeMap, or OpenStreetMap. Product names and trademarks belong to their respective owners.

About

JourneyDeck turns driving, charging, location, and music history into a private personal dashboard. Explore trips, discover favorite routes, see what you listened to on each drive, track charging and efficiency, search places, and create shareable drive recaps.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages