tesla_dashcam：把 40 个特斯拉行车记录视频合成一个

tesla_dashcam：把 40 个特斯拉行车记录视频合成一个

【免费下载链接】tesla_dashcamConvert Tesla dash cam movie files into one movie项目地址: https://gitcode.com/gh_mirrors/te/tesla_dashcam

一次事故之后，你从特斯拉 U 盘里翻出的是一个装 40 个 MP4 文件的事件文件夹——6 个摄像头各自录制，每分钟又拆成一个独立文件。tesla_dashcam 能把这 40 个片段合并成 1 个视频，还能把多个事件并成一个长视频。适合想整理行车记录仪素材的特斯拉车主，以及熟悉命令行的技术用户。

三步安装并运行 tesla_dashcam

工具用 Python 编写，视频编码交给 ffmpeg（开源音视频处理工具）完成。两条安装路径：

1. Windows 和 Mac 用户直接下载官方预编译包（ZIP / DMG），里面已内置 ffmpeg，解压即可运行；
2. Linux 等其他环境用 pip 安装，要求 Python 3.13 及以上，系统需另外装好 ffmpeg：

python3 -m pip install tesla_dashcam

3. 首次运行，把源目录指向事件文件夹，再指定输出位置：

tesla_dashcam /path/to/SavedClips/20260823_090000 --output ~/Videos

不提供源目录时，程序默认扫描 U 盘里的 SavedClips 和 SentryClips 两个文件夹。

常用场景：单事件合并、整卡批处理、GPU 加速

合并单个事件为一个视频

什么时候用：事故后想把某一个 10 分钟的事件单独合成视频回看。

怎么操作：源参数直接传事件文件夹。默认布局 FULLSCREEN 是前摄像头在上、后摄和左右侧摄在下，输出分辨率 1920x960：

tesla_dashcam ~/TeslaCam/SavedClips/20260823_090000 --output ~/Videos

输出效果：1 个 MP4 文件。视频里的时间戳取自源视频内嵌的时间，按运行机器的系统时区显示。

整卡批量处理并合并为一个长视频

什么时候用：U 盘里有多个事件，想一次性处理完并拼成一个长视频。

怎么操作：源指向整个 SavedClips 目录，加 --merge 把各事件视频合并成 1 个文件，文件名由模板生成：

tesla_dashcam ~/TeslaCam/SavedClips --output ~/Videos \ --merge "{start_timestamp} - {event_reason} - {event_city}"

再加 --monitor 可让程序常驻：检测到插了特斯拉 U 盘就自动处理，结束后继续等待下一次插入；配合 --delete_source 还能在处理完清理 U 盘里的原始文件。

输出效果：输出目录里一个长视频，各事件以章节形式拼接，文件名记录时间、原因和地点。

开启 GPU 加速加快编码

什么时候用：U 盘容量大、事件多，CPU 编码太慢。

怎么操作：本地加--gpu --gpu_type nvidia；在 Mac 以外系统上 --gpu_type 必须同时指定，可选 nvidia、intel、qsv、rpi、vaapi 五类。用 Docker 则直接选对应镜像，NVIDIA 版本示例：

docker run --rm --gpus all -v /media/tesla:/data -v ./output:/output \ tesla_dashcam:nvidia /data --output /output --gpu --gpu_type nvidia

输出效果：编码速度明显提升，文件体积与 CPU 版基本一致。

自定义布局、时间戳与编码参数

6 种内置布局，用 --layout 选择：

布局	分辨率	画面结构
FULLSCREEN（默认）	1920x960	前摄居上，后摄与左右摄在下
MOSAIC	2496x1824	前后摄放大，A 柱与侧摄缩小
CROSS	1280x1920	前摄顶、后摄底，两侧环绕
DIAMOND	2560x1920	6 摄菱形分布
HORIZONTAL	3840x480	6 摄横向排成一行
PERSPECTIVE	同 FULLSCREEN	侧摄像头加透视效果

常用参数：

参数	作用
--scale 0.5 或 --scale camera=front 1	整体或按摄像头调整画面大小
--no-front / --no-rear 等	从输出中排除某个摄像头
--start_timestamp / --end_timestamp	截取关键片段，去掉无关段落
--start_offset -60	从事件前 60 秒开始输出
--motion_only	无运动画面快进，Sentry 素材尤其有效
--quality HIGH / --compression medium	在体积和速度间取舍
--skip_existing	已生成的视频不再重做
--delete_source	处理完删除源文件
--title_screen_map	开头插入 3 秒事件位置地图
--ffmpeg /path/to/ffmpeg	ffmpeg 不在 PATH 时手动指定

项目 Preference_Files/ 目录里还有一组预设文件（FULLSCREEN.txt、CROSS.txt 等），命令行里直接写@FULLSCREEN.txt就能调用整套参数，不用每次敲长串。

常见坑与解决办法

1. 视频里某个摄像头发黑：不是错误。同一分钟内各摄像头的时长并不总是一致，先结束的摄像头会显示背景色（默认黑色）。
2. 换了布局却没有生成新视频：--skip_existing 只检查文件是否存在，不核对布局是否匹配。去掉该参数重新运行即可。
3. --gpu 没生效：非 Mac 系统上必须同时给 --gpu_type，只写 --gpu 不会启用加速。
4. 输出到网络盘时编码报错：加 --no-faststart；临时文件读写慢则用 --temp_dir 指到本地磁盘。
5. 视频时间和实际对不上：时间戳会按运行机器的时区转换，先校准系统时区再重新处理。

tesla_dashcam 把 40 个零散的行车记录片段变成一个直接可看的视频，多事件合并、U 盘触发和 GPU 加速都开箱可用，基本覆盖特斯拉行车记录仪素材的全部常见处理需求。项目托管在 gitcode 平台，需要源码可用git clone https://gitcode.com/gh_mirrors/te/tesla_dashcam获取。

【免费下载链接】tesla_dashcamConvert Tesla dash cam movie files into one movie项目地址: https://gitcode.com/gh_mirrors/te/tesla_dashcam