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 in your browser (client-side only). When you select your TeslaCam folder, the browser grants the page read-only access to those files for the current session. The app:
- 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).
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 (Saving the App)
- Open the viewer in your browser.
- Save the page as a single HTML file:
- Windows/Linux: press Ctrl+S, choose a location, keep the .html extension.
- macOS: press Cmd+S.
- Later, open that saved HTML file directly in your browser (double-click). You can use the viewer completely offline.
Note: Some browsers offer “Webpage, complete” or “HTML only.” Either works; “HTML only” is typically enough because the app is self-contained.
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
- Click Open folder and pick your TeslaCam root folder.
- Use the left sidebar to browse events. Click an event to load it.
- Use the Play button and the timeline scrubber to control playback.
- 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.
- Open the Map to see approximate locations for events. Click a marker to jump to that event.
- Use the filter bar for Sentry / Recent / Saved sources and sorting.
- 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.
Keyboard Shortcuts
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.