TeslaCam Viewer

This page explains what the TeslaCam Viewer is, how to use it, and answers common questions about privacy, offline use, and donations.

---

Overview

TeslaCam Viewer is a single-page, standalone web app that lets you browse and play your Tesla dashcam footage directly in your browser. It supports multi-camera playback, timelines, a quick filter bar, location markers on a mini-map, and smooth switching between clips.

• Zero uploads: your files never leave your device.
• No install required: just open the HTML file in a modern browser.
• Works offline: you can save the page and use it without internet access.
• Donationware: free to use; consider supporting via PayPal, Ko-fi, or Buy Me a Coffee.

---

Privacy & Security

Nothing is sent to any server. The Viewer runs fully client-side in your browser.

• does not upload or sync files;
• does not use analytics or tracking pixels;
• does not store your videos beyond the current session (object URLs live only in memory).

When you select your TeslaCam folder, the browser grants the page read-only access to those files for the current session only.

Map note: when you open the map, it loads tile images from OpenStreetMap; your video files are never uploaded.

If you refresh or close the page, access to your files is revoked by the browser and must be granted again next time.

---

Using it offline (optional)

TeslaCam Viewer is designed to work primarily as a website. This helps keep the project visible, up to date, and easy to support. However, offline use is available if you prefer.

Option 1: Save as a single HTML file
You can download once and save the HTML file locally. Opening this file directly in your browser gives you the full viewer experience, fully offline.

Option 2: Install as a PWA (recommended for convenience)
Most modern browsers allow you to install TeslaCam Viewer as a Progressive Web App. Use the "Install app" option in your browser menu while visiting the site. This adds the viewer to your device like a native app, with faster access and optional offline availability.

Tip: Even when installed, visiting the website occasionally ensures you're always using the latest version and helps support ongoing development.

---

Required TeslaCam folders

Select your TeslaCam root directory. The app expects these standard subfolders:

• RecentClips/
• SavedClips/
• SentryClips/

If these folders are missing or empty, the app will show an error or an empty list. Each event is presented as a set of clips that can include multiple cameras (front, left repeater, right repeater, back). All RecentClips in the selected folder are presented as one continuous event for browsing convenience.

---

How to use

1. Click Open folder and pick your TeslaCam root folder.
2. Use the left sidebar to browse events. Click an event to load it.
3. Use the Play button and the timeline scrubber to control playback.
4. Switch layouts by clicking a camera view (single vs quad). On narrow screens, the focused camera is on top and the others appear as small previews below.
5. Open the Map to see approximate locations for events. Click a marker to jump to that event.
6. Use the filter bar for Sentry / Recent / Saved sources and sorting.
7. Adjust Speed, Brightness, Contrast in the settings panel.

---

Key features

• Multi-camera sync: the Viewer lines up the front/left/right/back clips on a single timeline.
• Smooth segment transitions: segments are preloaded to avoid stutter at boundaries.
• Global scrubber: one slider targets all cameras; the app selects the right segment automatically.
• Map integration: optional markers based on event metadata (if available).
• Responsive layout: optimized for narrow and wide screens.

---

What it supports

Sentry Mode Viewer

Browse Sentry events with thumbnails (when available), timestamps, and optional event metadata like reason and approximate location.

RecentClips Viewer

RecentClips are presented as one continuous stream for fast browsing and scrubbing without juggling separate segments.

SavedClips Viewer

View Saved clips the same way as Sentry, with quick filtering and synced camera layout.

Multi-camera dashcam playback

Front/left/right/back clips are aligned on one timeline. Use a single scrubber to jump through the event across all cameras.

---

Keyboard shortcuts

• Space Play/Pause
• Left/right Forward/backward

---

Donationware

The app is free to use. If it saves you time or proves helpful, please consider supporting the project. Thank you!

---

Troubleshooting checklist

• Reload the page and reselect the TeslaCam folder.
• Confirm the folder contains RecentClips, SavedClips, and SentryClips.
• Try a different browser if playback or file permissions misbehave.
• Move the clips to a faster disk if you notice I/O bottlenecks.

---

Credits

Tesla is a trademark of Tesla, Inc. This project is an independent Viewer designed for personal use with locally stored footage.

---