Skip to content

Latest commit

 

History

History
74 lines (52 loc) · 3.69 KB

File metadata and controls

74 lines (52 loc) · 3.69 KB

Tesla Dashcam Stamp (特斯拉行车记录仪水印工具)

Tesla Dashcam Stamp License Platform

Tesla Dashcam Stamp 是一款专为特斯拉车主设计的开源网页版视频水印工具。它能够自动从特斯拉行车记录仪导出的原始 MP4 文件中提取隐藏的遥测数据(如时速、油门、刹车、自动驾驶状态等),并将其美观地叠加热合成到视频中,支持本地高性能合成与导出。


✨ 核心特性

  • 🛡️ 隐私至上:100% 纯客户端处理。所有视频解析、数据提取和画面合成均在您的浏览器内完成,绝不上传任何数据到服务器
  • 📊 深度遥测数据提取
    • 实时车速 (km/h)
    • 加速踏板深度 (%)
    • 刹车状态 (ON/OFF)
    • 自动驾驶状态 (NONE / TACC / Autosteer 等)
    • 精准时间戳:自动解析 SEI 元数据或文件名,还原真实的驾驶时刻。
  • 高性能架构
    • WebGL 2.0 渲染:利用显卡硬件加速叠加热合水印,保证流畅的预览体验。
    • WebCodecs 硬件编码:采用现代浏览器 VideoEncoder API,实现极速视频导出。
  • 🎨 特斯拉美学 UI:采用深色模式与玻璃拟态设计,延续特斯拉科技感。
  • 📱 多端兼容:优化了 iOS Safari 与微信浏览器的兼容性,支持移动端操作。

🚀 快速开始

  1. 访问地址:下载所有项目文件后,直接在浏览器中打开 index.html。或者打开本项目的GitHub Page
  2. 导入视频:点击上传区域或将特斯拉记录仪导出的 MP4 文件(例如 2024-04-02_14-15-54-front.mp4)拖入页面。
  3. 预览与跳转:等待数据解析完成后,您可以随意拖动进度条预览带水印的画面。
  4. 合成导出
    • 点击 “开始合成”
    • 页面将进行逐帧渲染(此时请勿离开浏览器标签页以保证编码连续性)。
    • 完成后点击 “保存视频” 即可下载带水印的成品文件。

🛠️ 技术实现

本项目的核心逻辑完全由原生 JavaScript 实现,无需复杂的后端支撑:

  • MP4 解析器:集成 DashcamMP4 类,深度解析 MP4 Box 结构(mdat/moov/stbl等),提取隐藏在 SEI NAL 单元中的 Protobuf 数据。
  • Protobuf 解码:利用 protobuf.js 解析特斯拉定义的车辆状态协议,获取高频物理参数。
  • 混合渲染管线
    • Canvas 2D 负责高效率的水印文本布局。
    • WebGL 2.0 负责将视频帧与水印图层进行 Alpha 混合与色彩空间处理。
  • 视频封装:集成 mp4-muxer,将编码后的 H.264 原始流实时封装为符合标准的 MP4 容器。

📦 依赖项

项目运行依赖以下库(已包含在 public/ 目录下):


⚠️ 免责声明

  1. 本工具仅供个人学习与驾驶行为记录参考使用。
  2. 所提取的遥测数据(如速度、加速度等)来源于视频文件中的元数据,其精度由车辆传感器决定。
  3. 请确保您的浏览器支持 WebCodecsWebGL 2.0(推荐使用最新版 Chrome、Edge 或 Safari)。

📜 开源协议

本项目基于 MIT License 协议开源。


Inspired by the innovation of Tesla and the open-source community.