副標：雙擊選資料夾 → 自動把監視器／相機「照片」做成 MP4 縮時；支援 NAS/UNC、補副檔名、時間戳與標籤。
Repo 連結：https://github.com/bill86854238/timelapse-from-folders為什麼做這個？
- 想把監視器每天存到 NAS 的日期資料夾快速回顧，但都是一張張照片很難看。
- 部分照片沒有副檔名，檔名也沒有時間序（只能靠檔案時間）。
- Windows 對 UNC 路徑（\\NAS\...）當「目前目錄」不友善，很多現成工具會出錯。
目標：雙擊一次、選資料夾，就能把「照片 → MP4 縮時」，每天一支、清楚回顧整日動態。
這個小工具能做什麼
- ✅ 日期資料夾批次處理：選「根目錄」就會把底下每一天各做一支 MP4。
- ✅ 單一天也可：直接選那天的資料夾就輸出一支影片。
- ✅ 自動補副檔名：沒有副檔名但其實是 JPEG 的，會補 .jpg。
- ✅ 時間排序：以檔案最後修改時間排序（檔名亂序也不怕）。
- ✅ 畫面處理：EXIF 方向校正、等比縮放、必要時補黑邊對齊尺寸。
- ✅ 疊字：左下角可放時間戳、來源標籤（例：SpotCam 1 號機）。
- ✅ NAS/UNC 友善：啟動檔在本機、來源可選 NAS，工具會自動映射臨時磁碟處理。
下載與檔案配置
把下列三個檔案放在本機（非 NAS）同一個資料夾，例如 C:\TimelapseTool\：
- timelapse_from_folders.py
- requirements.txt
- timelapse_pick_folder_askfps.cmd（雙擊啟動）
來源資料夾可選 NAS（\\ShanjiaNas\... 這種路徑沒問題）。
使用步驟（無需打指令）
- 雙擊 timelapse_pick_folder_askfps.cmd。
- 在視窗中選擇： 根目錄（含多個日期子資料夾）→ 批次輸出 <日期>.mp4 到 _Timelapse\ 單一天（只有照片的資料夾）→ 輸出 <該資料夾名>.mp4
- 輸入 FPS（建議 12 / 24 / 30），並選擇： 是否覆蓋已存在影片 是否顯示時間戳
- 首次執行會自動建立本機虛擬環境（%LocalAppData%\TimelapseTool\.venv）並安裝套件；之後就會直接跑。
參數建議
- FPS： 12–15 fps → 長時間縮時、片長較長 24–30 fps → 一般觀看最自然
- 片長估算：片長（秒） ≈ 照片張數 ÷ FPS 例：2,400 張、24 fps → 約 100 秒
- 寬度：內建 1280，會等比縮放並補黑邊；想更清楚可改 1920。
- 編碼：預設 mp4v；如播放或寫檔有問題可改 XVID。
驗證與結果（我的使用情境）
- 以 SpotCam 日資料夾為單位輸出，每天得到一支 1～2 分鐘的 MP4。
- 片頭直接看時間戳＋「SpotCam 1 號機」標籤，回顧重點更快。
- NAS 路徑穩定可用；中文資料夾名稱也正常。
常見問題／排錯表
症狀或訊息 可能原因 解法 一開頭顯示「不支援 UNC 路徑」 直接在 NAS 上雙擊啟動檔 請把三個檔案放本機資料夾，啟動後再選 NAS 路徑 視窗一閃即關 舊版拖曳或權限問題 用 timelapse_pick_folder_askfps.cmd（內建停留與提示） 找不到 Python 尚未安裝 安裝 Python 3.8+（官網或 Microsoft Store），再執行 影片方向不對 原圖 EXIF 方向 工具會自動校正；若仍異常，請回報一張原圖 mp4 寫不出／不能播 系統解碼器問題 改 XVID、或提升輸出寬度、或安裝對應編碼器
結語
如果你也把監視器或相機快照存成「每天一個資料夾」，這個小工具可以把照片變縮時的流程降到：雙擊 → 選資料夾 → 等出 MP4。
