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.

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.

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.

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.

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

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.