How To Use Tesla Companion

Welcome to your all-in-one Tesla toolkit. Here's a guide to get you started:

Camera Viewer

Load Clips: Click the "Select Directory" button and choose your main `TeslaCam` folder from your USB drive. The app will automatically find and group all video events.
Navigate Events: Use the dropdown or navigation buttons to move between events.
Playback: Use the main playback controls to play, pause, skip, and scrub through the combined video clips for an event.
Jump to Event: If an event was triggered, a "Jump to Event" button will appear.
View Location: If the event contains GPS data, a "Event Map" button will appear.
Grid Screenshots: Use the "Screenshot" button in the top controls to download a single, high-quality image stitching all visible camera feeds together.

Trip Range Estimator

Enter Locations: Type in a starting and destination address. You can also click "Use Current Location" for the starting point.
Select Vehicle: Choose your Tesla model from the dropdown. This sets the battery capacity and efficiency.
Set Trip Parameters: Enter your starting battery percentage, payload, and wheel size. Select your driving style and road conditions. Use the sliders to set the expected outdoor temperature and your desired interior cabin temperature.
Calculate: Click "Estimate Trip" to see the route on the map and get an estimate of your remaining battery percentage upon arrival. The calculation considers all selected factors for a more accurate result.

Charging Time Estimator

Calculate Time to Target %: Enter your vehicle's details, your current and target battery percentage, and select your charger type. The tool will estimate how long the charging session will take.
Calculate % Gained Over Time: Enter your current battery percentage, a start time/date, and an end time/date. The tool will estimate your battery's state of charge after that period.
Custom Chargers: For both modes, you can select "Custom" to input specific voltage and amperage for your charger.

Phantom Drain Estimator

Calculate Drain Time: Enter your current battery percentage and the percentage you expect it to drain to. The tool will estimate how long your battery will last under the selected conditions.
Calculate Percentage Lost: Enter your current battery percentage, a start time/date, and an end time/date. The tool will estimate how much battery percentage will be lost in that period.
Refine Calculation: For both modes, add your battery's current health, the outside temperature, and select any active features (like Sentry Mode) for a more accurate calculation.

Reference Information

Camera Indexes

The event.json file references cameras by a number. Here is the mapping used by this application:

Index	Camera View
`0`	Front
`3`	Left Pillar
`4`	Right Pillar
`5`	Left Repeater
`6`	Right Repeater
`7`	Back

Event Reasons

The reason field in the event file indicates what triggered the recording. Here are some common reasons:

Reason Code	Description
`sentry_aware_object_detection`	Sentry Mode detected an object or movement nearby.
`user_interaction_dashcam_icon_tapped`	You manually triggered a Dashcam recording by tapping the icon on the screen.
`sentry_locked_handle_pulled`	Sentry Mode detected someone pulling on a door handle while the car was locked.
`user_interaction_honk`	You manually triggered a Dashcam recording by honking the horn.

No Clips Selected

00:00 / 00:00

Select Directory

All Cameras

Front Back L Fender R Fender L Pillar R Pillar

Front

Back

Left Fender

Right Fender

Left Pillar

Right Pillar

Trip Range Estimator

Start Address

Destination Address

Vehicle

Starting Battery (%)

Road Conditions

Wheels

Tire Pressure

Additional Payload (lbs)

Driving Style

Outdoor Temperature70°F

Interior Temperature70°F

Enter trip details above to see your estimate.

Charging Time Estimator

Original Battery Capacity (kWh)

Charger Efficiency (%)

Charger Type

Current Battery (%)

Target Battery (%)

Current Battery (%)

Start Date

Start Time

End Date

End Time

About Tesla Companion

This application was created to provide an easy-to-use toolkit for Tesla owners. It combines several useful utilities into a single, responsive web interface that works on any device.

Credits & Acknowledgements

The core Camera Viewer functionality was originally created by Lythinari. You can find the original project on GitHub.
This version was further edited and refined by Joshua Leshnick. You can find the project on GitHub.
This app was built with HTML5, CSS3, and modern JavaScript.
Icons provided by Feather Icons.
Font by Google Fonts (Inter).

Disclaimer

This is an unofficial, open-source community project and is not affiliated with Tesla, Inc. All calculations are estimates and should be used for informational purposes only.