TeslaCam Viewer

A powerful browser-based Tesla dashcam viewer with synchronized multi-angle playback, telemetry visualization, and comprehensive incident analysis tools. All processing happens locally - your video files never leave your computer.

Live Site: teslacamviewer.com

Key Features

Video Playback

• Synchronized Multi-Camera Playback - View front, back, left, right (and pillar cameras on newer vehicles) simultaneously
• Multiple Layout Presets - Grid, Picture-in-Picture, Focus views, and more
• Custom Layout Editor - Design your own camera arrangements with drag-and-drop
• Playback Speed Control - 0.25x to 2x speed with frame-by-frame stepping
• Fullscreen Mode - Double-click any camera for fullscreen view

Event Management

• Multi-Drive Support - Add multiple TeslaCam folders and switch between them
• Event Filtering - Filter by type (Saved/Sentry/Recent), date range, location, or search
• Interactive Map - View all events on a map with location markers and heatmap
• Bookmarks and Notes - Add notes and tags to events, backed up to event folders
• Statistics Dashboard - Analytics on event types, locations, recording time, and trends

Telemetry and Analysis

• Live Telemetry Overlay - Speed, G-force, turn signals, brake/throttle from embedded video data
• Telemetry Graphs - Interactive speed, G-force, and steering graphs with speed limit reference
• GPS Mini-Map - Real-time vehicle position overlay
• Elevation Profile - Route elevation visualization
• Weather Display - Historical weather conditions for each event
• Street View Integration - Compare dashcam view with Google Street View

Incident Documentation

• Insurance Report Generator - PDF reports with frames, telemetry data, and maps
• Near-Miss Detection - Automatic incident scoring with timeline markers
• Hard Braking Detection - Identifies sudden acceleration/deceleration events
• Driving Smoothness Score - Safety scoring based on driving behavior
• Autopilot Analysis - Phantom braking detection and AP struggle zone mapping

Export and Sharing

• Screenshot Capture - Save current frame from all cameras
• Video Export - Export clips as WebM or MP4 with overlays
• Clip Marking - Set IN/OUT points for precise export ranges
• Privacy Mode - Export with GPS and timestamp data stripped
• License Plate Blur - AI-powered automatic plate detection and blurring
• Telemetry CSV Export - Download telemetry data for external analysis

Customization

• Theme System - Dark, Light, Midnight, and Tesla Red themes
• Multi-Language Support - Interface available in multiple languages
• Offline Package - Download for fully offline use
• Automatic Updates - Notifications when new versions are available

Browser Requirements

Chrome, Edge, or Chromium-based browser required - This app uses the File System Access API which is only supported in Chromium browsers.

Firefox and Safari are not supported.

Getting Started

Option 1: Use the Live Site (Recommended)

Visit teslacamviewer.com - no installation required.

Option 2: Run Locally

1. Clone or download this repository
2. Open index.html in Chrome or Edge, or run a local server:

# Using Python
python -m http.server 8000

# Using Node.js
npx http-server -p 8000

3. Open http://localhost:8000 in your browser

Option 3: Offline Package

Use the "Download Offline Version" option in settings to create a portable copy that works without internet.

Quick Start

1. Click "Select TeslaCam Folder" and choose your TeslaCam directory
2. Browse events in the sidebar - they load with thumbnails and metadata
3. Click an event to start playback
4. Use the timeline to scrub through footage
5. Press L to cycle through layout presets
6. Press T for telemetry overlay, G for graphs, M for mini-map

Keyboard Shortcuts

Key	Action
Space	Play/Pause
Left/Right Arrow	Seek 5 seconds
Shift + Left/Right	Previous/Next clip
Up/Down Arrow	Previous/Next event
L	Cycle layouts
T	Toggle telemetry overlay
G	Toggle telemetry graphs
M	Toggle GPS mini-map
F	Toggle fullscreen
S	Take screenshot
?	Show all shortcuts

Tesla Dashcam Folder Structure

The app reads the standard Tesla TeslaCam folder structure:

TeslaCam/
├── SavedClips/
│   └── YYYY-MM-DD_HH-MM-SS/
│       ├── event.json
│       ├── thumb.png
│       └── *.mp4 (4-6 cameras x multiple clips)
├── SentryClips/
│   └── YYYY-MM-DD_HH-MM-SS/
│       ├── event.json
│       ├── thumb.png
│       └── *.mp4
└── RecentClips/
    └── *.mp4 (rolling buffer)

Privacy and Security

• No data uploads - All video processing happens in your browser
• No server backend - The entire app runs client-side
• No tracking - No analytics or telemetry collection
• Local storage only - Settings and bookmarks stored in your browser

External Services

TeslaCamViewer connects to the following external services for enhanced functionality. No personal information is transmitted - only GPS coordinates when specific features are used.

Data APIs

Service	Data Sent	Purpose
Open-Meteo	GPS coordinates, date	Weather conditions for events
Overpass API	GPS coordinates	Speed limit data from OpenStreetMap
Nominatim	GPS coordinates	Address lookup for insurance reports
TeslaCamViewer.com	None	Version update check only

Map Tile Providers (Images Only)

Provider	Attribution
OpenStreetMap	© OpenStreetMap contributors
Carto	© OpenStreetMap © CARTO
Stadia Maps	© Stadia Maps © OpenStreetMap

User-Initiated Links

Links to Google Maps and Google Street View open in new tabs when you click GPS coordinates or the Street View button. No data is sent automatically.

All video files remain on your computer and are never uploaded.

AI Models

TeslaCamViewer uses several AI/ML models for advanced features. All models run locally in your browser using WebAssembly - no cloud processing.

License Plate Detection

Model	Size	Purpose
YOLOv11n	5.4 MB	Primary plate detector - fast and accurate for most regions
YOLOv8	6.2 MB	Alternative detector with different detection characteristics
LPDNet USA	3.1 MB	Optimized for North American plate formats
UK Plate Model	2.8 MB	Specialized for UK/EU plate styles

License Plate Recognition (OCR)

Model	Size	Purpose
CCT-XS	2.1 MB	Primary OCR - trained on 220k+ plates from 65+ countries
Tesseract.js	~15 MB	General-purpose OCR fallback
PaddleOCR	~10 MB	Alternative OCR with PP-OCRv3 architecture

Image Enhancement

Model	Size	Purpose
ESRGAN 4x	~5 MB	Super-resolution upscaling for plate enhancement
Super Resolution	5 MB	ONNX-based image upscaling

Object Tracking

Model	Size	Purpose
NanoTrack	1.2 MB	Tracks detected plates across video frames for multi-frame enhancement

How Models Are Used

1. License Plate Blur - Automatically detects and blurs plates in exports for privacy
2. Plate Enhancement - Captures multiple frames, aligns them, and uses super-resolution to improve readability
3. OCR Reading - Extracts text from enhanced plate images with confidence scoring

Model Loading

Models are downloaded on-demand when you first use a feature requiring them. They're cached in your browser's IndexedDB for future use. You can pre-download models in Settings → Advanced.

Troubleshooting

"Browser not supported": Use Chrome or Edge browser.

No events showing: Ensure you selected the TeslaCam folder or its parent directory.

Videos won't play: Check that .mp4 files aren't corrupted. Try another event.

Telemetry not showing: Not all Tesla firmware versions embed telemetry data. Older recordings may not have this data.

Buffering issues with multiple windows: Use tabs in the same window rather than separate browser windows.

Contributing

Contributions welcome! Feel free to open issues or pull requests on GitHub.

Community

Have questions, ideas, or want to share how you use TeslaCam Viewer?

Join the Discussion

• Q&A - Get help with setup or usage questions
• Ideas - Suggest new features or improvements
• Show and Tell - Share interesting clips or use cases
• General - Chat with other Tesla owners

License

MIT License - see LICENSE file for details.

Version

Current version: 2026.5.1.1

Click the version number in the app to view the full changelog.