Metadata-Version: 2.1
Name: teslacam
Version: 1.0.1
Summary: Consolidate and format Tesla vehicle camera video data
Home-page: https://github.com/SillyGoat/teslacam
Author: SillyGoat
Author-email: fake.me.now.and.forever@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# teslacam
Tesla Camera

This is a very simple python 3 script to help me consolidate my Tesla's raw camera data into nicely formatted videos.  It tries to maintain the same resolution as the original with the same video quality by default.

This also makes use of nvidia video card GPUs to accelerate encoding.

Installation:

Download FFMpeg here:
https://ffmpeg.org/download.html

Run:
```
python -m pip install teslacam
```
Command line usage
```
python -m teslacam --help
```
```
usage: teslacam [-h] [--codec {hevc_nvenc,libx265}] [--preset PRESET] [--reduce REDUCE] [--layout {pyramid,tall_diamond,short_diamond,cross}] [--keep_temp_folder KEEP_TEMP_FOLDER]
                ffprobe_file_path ffmpeg_file_path input_folder_path output_folder_path

positional arguments:
  ffprobe_file_path     full path to ffprobe binary
  ffmpeg_file_path      full path to ffmpeg binary
  input_folder_path     full path to the video folder containing timestamped folders
  output_folder_path    full path of the output folder for merged files and temporary work folder

optional arguments:
  -h, --help            show this help message and exit
  --codec {hevc_nvenc,libx265}
                        codec to use for encoding
  --preset PRESET       preset to use for encoding
  --reduce REDUCE       percent to reduce video to
  --layout {pyramid,tall_diamond,short_diamond,cross}
                        camera layout
  --keep_temp_folder KEEP_TEMP_FOLDER
                        keep temporary working folder after extraction
```
API Usage
```
import teslacam
from teslacam import *

def main():
  print(f"Available layouts: {', '.join(teslacam.constants.LAYOUT.keys())}")
  print(f'Available codecs: {teslacam.constants.CODEC_OPTIONS.items()}')

  extract_videos(
    FFMpegPaths(
      r'some_ffmpeg_path\ffprobe.exe', # path to ffprobe
      r'some_ffmpeg_path\ffmpeg.exe'   # path to ffmpeg
    ),
    LayoutOptions(
      'hevc_nvenc', # Codec name
      'fast',       # Codec preset
      'pyramid',    # Layout name
      DONT_REDUCE   # Percentage value from 1-100 (or DONT_REDUCE constant)
    ),
    BaseFolderPaths(
      r'g:\TeslaCam\SentryClips',   # Path to your USB stick
      r'c:\users\user\videos\tesla' # Destination path
    ),
    True  # Keep temporary working folder
  )

if __name__ == '__main__':
  main()
```


