video2ppt.git from github

 

Video2PPT 專案執行指南

本文件旨在解決 macOS 環境下 Python 套件安裝受限（PEP 668）的問題，並提供完整的環境架設流程。

1. 快速開始 (指令彙整)

請在您的終端機 (Terminal) 中，於專案根目錄下依序複製並執行以下指令：

Bash

# 步驟 1：建立虛擬環境
python3 -m venv .venv

# 步驟 2：啟用虛擬環境
source .venv/bin/activate

# 步驟 3：更新 pip 並安裝必要套件
pip install --upgrade pip
pip install -r requirements.txt

# 步驟 4：執行轉檔程式
python3 main.py 0401.mp4 -i 30 -o output.pptx

---

2. 詳細步驟說明

🟢 第一步：建立虛擬環境 (venv)

由於系統 Python 受到保護，我們建立一個獨立的資料夾 .venv，將所有套件安裝在這裡，不會干擾到作業系統。

• 指令： python3 -m venv .venv

🔵 第二步：啟用環境

這會告訴終端機：「從現在起，請使用這個資料夾裡的 Python 執行檔」。

• 指令： source .venv/bin/activate

• 檢查： 執行後，您的指令列前方應該會出現 (.venv) 的字樣。

🟡 第三步：安裝依賴項目

透過 requirements.txt 批次安裝所需的函式庫。針對此專案，您的 requirements.txt 內容應包含：

• opencv-python (即錯誤訊息中的 cv2)

• python-pptx (產生 PPT 檔案用)

• numpy (數值運算用)

• 指令： pip install -r requirements.txt

🔴 第四步：執行程式

使用帶有參數的指令來運行您的 main.py。

• 指令： python3 main.py [影片檔名] -i [間隔秒數] -o [輸出檔名]

---

3. 日常維護小撇步

• 如何關閉環境？ 當您完成工作後，只需輸入 deactivate 即可回到系統預設環境。

• 下次開啟電腦後如何執行？ 您不需要重新安裝。只需重新執行 步驟 2 (source .venv/bin/activate) 即可直接進入工作狀態。

• 遇到 requirements.txt 遺失？ 如果沒有該檔案，您可以手動建立一個名為 requirements.txt 的文字檔，並貼入以下內容：

  Plaintext

  opencv-python
  python-pptx
  numpy
  

---

Neo Freeman，照著這份清單執行後，原先的 ModuleNotFoundError: No module named 'cv2' 應該就能順利解決了！

video2ppt 是什麼？

它是一個 Python CLI 工具，功能是：

• 從影片中擷取畫面（frame），例如每秒一張或每 5 秒一張

• 自動將這些畫面放入 PowerPoint 投影片中

• 支援自訂擷取間隔、輸出檔名等參數

macOS 安裝與使用流程（模組化步驟）

✅ 安裝步驟

bash

# 1. 下載原始碼
git clone https://github.com/wangxs404/video2ppt.git
cd video2ppt

# 2. 安裝依賴套件
pip3 install -r requirements.txt

建議使用 Python 3.8+，macOS 原生支援，若有多版本可用 python3 -m venv 建立虛擬環境。

▶️ 基本使用指令

bash

# 每秒擷取一張畫面
python3 main.py video.mp4
# 每 5 秒擷取一張，並指定輸出檔名
python3 main.py video.mp4 -i 5 -o output.pptx


# 2026/1/25.  main.py 4:3.    main2.py 16:9

python3 main.py apv40.mp4 -i 30 -o output.pptx

python3 main.py apv40.mov -i 30 -o output.pptx

2026/1/26

python3 main.py apv40.mov -i 15 -o output.pptx

2026/4/1.       

python3 main.py asf.mp4 -i 15 -o output.pptx

2026/4/9  

python3 main.py 0401.mp4 -i 30 -o output.pptx

# 查看所有參數選項
python3 main.py -h





在 Windows 上执行需要做一些调整，主要是使用 python 而不是 python3，并确保您使用的是正确的命令行工具。

以下是详细的安装和执行步骤：

🪟 在 Windows 上的安装与执行指南

第一步：准备工作

1. 安装 Python：确保您的 Windows 系统已安装 Python（版本 3.6 或更高）。您可以在 python.org 下载。安装时，请务必勾选“Add Python to PATH”。

2. 打开命令行工具：您可以使用 命令提示符 (cmd)、PowerShell 或 Windows Terminal。

第二步：克隆仓库

在命令行中，逐条输入以下命令：

bash

# 克隆仓库到本地
git clone https://github.com/wangxs404/video2ppt.git

# 进入项目文件夹
cd video2ppt

💡 如果没有安装 Git：您也可以直接访问 https://github.com/wangxs404/video2ppt，点击绿色的“Code”按钮，选择“Download ZIP”。下载后解压到一个文件夹，然后在命令行中 cd 进入到该解压后的文件夹。

第三步：安装依赖

在 video2ppt 目录下，运行以下命令来安装所需的 Python 库：

bash

pip install -r requirements.txt

第四步：执行转换（Windows 适用版）

在 Windows 中，命令是 python 而不是 python3。请将下面的 video.mp4 替换为您想要转换的视频文件路径。

• 基本使用（默认每秒提取一帧）

  bash

  python main.py video.mp4

• 每 5 秒提取一帧，并指定输出文件名

  bash

  python main.py video.mp4 -i 5 -o output.pptx

• 每 10 秒提取一帧（快速模式，生成的文件较小）

  bash

  python main.py video.mp4 -i 10