特斯拉行車記錄器如何加時間浮水印？教你用 tesla_dashcam 加上時間戳記

特斯拉自 2023 年起陸續推出內建的行車記錄器播放器，讓車主能直接在車內檢視 Dashcam 與哨兵模式（Sentry Mode）所錄製的影片。隨著 2025 年春季 OTA 軟體更新（版本 2025.14）釋出，特斯拉進一步針對配備 HW4 的車款，新增兩組 B 柱攝影機的錄影視角，將原本的前、後、左、右四個視角擴充為六個，強化車側畫面與盲區覆蓋，提升整體影像紀錄的完整性。

本文主要內容

不過，這些影片仍未內嵌時間與日期資訊，若要作為行車糾紛或交通檢舉的佐證，通常仍需搭配其他工具輔助。先前介紹過的 Sentry Viewer，雖然提供時間浮水印與片段合併等功能，但目前已自 App Store 下架。本文將改為推薦使用開源專案《tesla_dashcam》，提供更穩定的影片管理與轉檔方式，較能符合多數特斯拉車主的使用需求。

本文將以 macOS 15.5 作為示範環境，實際上 tesla_dashcam 可在 macOS、Windows 與 Linux 系統上執行，只需安裝 Python 3.7 以上版本與 ffmpeg，即可正常運作。

所需工具與安裝說明

tesla_dashcam：將 Tesla 錄影畫面合成並加上時間浮水印的命令列工具
pipx：用來安裝 tesla_dashcam 的 Python 工具管理器
FFmpeg：影片處理工具，由 tesla_dashcam 呼叫使用
TeslaCam 檢視器：免安裝網頁工具，可預覽並篩選想要的哨兵影片

1. 安裝 Homebrew（若尚未安裝）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安裝 FFmpeg 與 pipx

brew install ffmpeg pipx
pipx ensurepath

執行完 pipx ensurepath 後請重新打開終端機，或執行：

source ~/.zshrc

3. 安裝 tesla_dashcam

pipx install tesla_dashcam

完成後確認是否安裝成功：

tesla_dashcam --help

為什麼不直接用 pip 安裝？macOS 的 PEP 668 限制

在 macOS 上，若透過 Homebrew 安裝 Python，系統會啟用 PEP 668，限制使用 pip 安裝全域套件，以避免影響系統或其他工具。若直接執行 python3 -m pip install tesla_dashcam，將會出現 error: externally-managed-environment 錯誤。建議改用 pipx 安裝，讓 tesla_dashcam 運作於獨立環境中，更穩定也更不易與其他套件衝突。

建議先預覽影片片段再轉檔

由於哨兵模式的錄影會將每個事件分割成多個 1 分鐘的片段，若直接轉出整個資料夾，將耗費大量時間與電腦資源。因此，建議先使用 TESLAGURU 推出的免費工具「TeslaCam 哨兵行車記錄器檢視器」，快速預覽各段影片內容與時間，篩選所需片段後再進行轉出，可大幅提升效率，並避免不必要的轉檔作業。

TeslaCam 哨兵行車記錄器檢視器：https://electrify.tw/teslacam-sentry-viewer

此工具支援直接瀏覽 Tesla USB 裡的影片資料夾，提供四鏡頭同步播放與鍵盤控制功能，並可自訂篩選特定日期、片段或時間點，使用上無需下載其他資源，亦可在離線環境中順利運作。

找出需要的片段後，將想轉檔的影片（如 2025-05-30_15-00-28-front.mp4）複製到電腦中的 Downloads/input 資料夾。

建立輸入與輸出資料夾

在進行影片轉檔之前，建議先在 macOS 預設的「下載項目」（Downloads）資料夾中建立兩個臨時資料夾，一個用來放入需要加上時間標籤的影片，另一個作為轉出影片的儲存位置。可透過以下指令快速建立：

mkdir -p ~/Downloads/input ~/Downloads/output

其中，input 資料夾用來放置你從 TeslaCam 中挑選出來、準備加上時間戳記的影片片段；output 資料夾則會儲存轉出後的新影片。你也可以依照個人需求，自行修改這兩個資料夾的名稱與路徑，例如改放在桌面或其他指定的工作目錄，只要後續指令中的路徑一致即可。這樣的做法能協助檔案清楚分類，避免混淆或檔案被覆蓋的情況發生。

輸出影片並加上時間標籤

選定好輸入與輸出資料夾後，就可以開始進行影片轉檔並加上時間標籤。你可以依照實際需求調整參數，例如只輸出特定鏡頭、變更時間格式或調整字體大小等。建議一開始先挑選一段影片進行測試，確認轉出效果符合預期後再批次處理其他檔案，能節省時間，也能避免重複操作。

範例指令（僅轉出前鏡頭）：

tesla_dashcam \
--no-left --no-right --no-rear \
--monitor_once \
--scale 1 \
--timestamp_format "%Y-%m-%d %H:%M:%S" \
--fontsize 35 \
--output ~/Downloads/output \
~/Downloads/input

各參數說明：

--no-left --no-right --no-rear：排除左、右、後鏡頭，僅輸出前鏡頭畫面。
--monitor_once：執行一次後結束，不持續監控資料夾。
--scale 1：影片輸出比例，1 表示原始大小。
--timestamp_format：時間顯示格式，可自由調整（例如 %H:%M 顯示時分）。
--fontsize：時間字體大小，依畫面需求調整。
--output：輸出資料夾。
最後一個參數是輸入資料夾。

如需設定輸出畫面的鏡頭組合與排列方式，可直接參考以下對照表，依需求選擇對應參數。在執行指令時，只需將表中所列參數加入轉檔指令中，例如若僅需保留前鏡頭畫面，可加入 –no-left –no-right –no-rear；若想輸出四分割畫面，則加上 –layout WIDESCREEN。

需求	對應參數
僅保留前鏡頭	`--no-left --no-right --no-rear`
僅保留後鏡頭	`--no-left --no-right --no-front`
四鏡頭合併畫面	不加任何 `--no-*` 參數
使用四分割畫面	加上 `--layout WIDESCREEN`