traffic-video-watermark-cli 0.1.0

Cross-platform CLI tool to burn timestamp and location watermarks into traffic report videos.

Traffic Video Watermark CLI

跨平台命令行工具，用于给交通举报视频烧录动态时间和位置水印，并导出可播放 MP4。

水印格式：

时间: 2026-04-27 09:11:50
位置: 深圳市宝安区南光高速洲石路出口前约2公里路段

工具会优先读取视频容器里的 creation_time，按上海时区换算为画面时间；如果视频没有该元数据，会尝试从 Tesla 文件名里的时间读取。

安装

本地目录安装：

pip install .

从 wheel 安装：

pip install dist/traffic_video_watermark_cli-0.1.0-py3-none-any.whl

使用

只查看视频信息：

traffic-watermark --input 2026-04-27_09-11-50-front.mp4 --info

生成水印视频：

traffic-watermark \
  --input 2026-04-27_09-11-50-front.mp4 \
  --output report-watermarked.mp4 \
  --location "深圳市宝安区南光高速洲石路出口前约2公里路段"

如果不传 --output，默认输出到输入视频同目录，文件名后追加 -watermarked.mp4。

发布到 PyPI

构建发布包：

python -m pip install -e ".[build]"
python -m build
python -m twine check dist/*

上传到 PyPI 需要 PyPI API token：

python -m twine upload dist/*

也可以使用环境变量：

set TWINE_USERNAME=__token__
set TWINE_PASSWORD=pypi-你的token
python -m twine upload dist/*