Ppt Compressor

PPT Compressor (Videos & Images)

Overview

Compress embedded videos and large images (>1MB) in PowerPoint (.pptx) files to significantly reduce file size while maintaining playback compatibility. The skill provides a bundled Python script with built-in ffmpeg — no installation required.

Prerequisites

• Python 3.7+ must be installed
• Pillow — automatically installed if missing (used for image compression)
• ffmpeg — bundled in {SKILL_DIR}/scripts/bin/. No manual installation needed!
  • If the bundled ffmpeg is missing, run: python {SKILL_DIR}/scripts/download_ffmpeg.py to re-download
  • Supports automatic download for Windows, macOS, and Linux

Architecture

{SKILL_DIR}/
├── SKILL.md                          # This file
└── scripts/
    ├── compress_ppt_videos.py        # Main compression script (cross-platform)
    ├── path_helper.py                # Cross-platform path utilities
    ├── download_ffmpeg.py            # FFmpeg downloader (Windows/macOS/Linux)
    └── bin/
        ├── ffmpeg[.exe]              # Bundled ffmpeg (platform-specific)
        └── ffprobe[.exe]             # Bundled ffprobe (platform-specific)

FFmpeg Resolution Order

The script automatically finds ffmpeg in this priority:

1. Bundled version in {SKILL_DIR}/scripts/bin/ (preferred)
2. System PATH as fallback

This means users never need to install ffmpeg manually.

User Interaction Guide (IMPORTANT for UX)

获取用户的 PPT 文件路径

当用户请求压缩 PPT 但没有提供文件路径时，Agent 应该：

方式 1: 引导用户拖拽文件（推荐，跨平台通用）

直接告诉用户：

📂 请把要压缩的 PPT 文件拖拽到这里，或者直接发送文件路径给我。

方式 2: 根据用户系统提供复制路径的指引

Windows 用户：

💡 在文件资源管理器中，按住 Shift 键右键点击文件，选择"复制为路径"，然后粘贴到这里。

macOS 用户：

💡 在 Finder 中选中文件，按 Option + Command + C 复制文件路径，然后粘贴到这里。 或者：右键点击文件，按住 Option 键，选择"将xxx拷贝为路径名"。

Linux 用户：

💡 在文件管理器中右键点击文件，选择"复制路径"或"Copy Path"。 或者使用终端：readlink -f /path/to/file.pptx

方式 3: 自动识别用户消息中的路径

Agent 应该智能识别用户消息中的各种路径格式：

路径识别正则表达式参考：

Windows 绝对路径: [A-Za-z]:[\\\/][^\s"'<>|*?]+\.pptx
Unix 绝对路径: /[^\s"'<>|*?]+\.pptx
Home 目录路径: ~/[^\s"'<>|*?]+\.pptx
带引号的路径: ["'][^"']+\.pptx["']

方式 4: 如果无法识别，友好询问

如果用户消息中没有明确的文件路径，根据用户系统使用以下模板询问：

Windows 系统：

我需要知道 PPT 文件的位置才能帮你压缩。请用以下任一方式告诉我：

1. **拖拽文件**：直接把 .pptx 文件拖到对话框
2. **复制路径**：在文件资源管理器中，按住 Shift 右键点击文件 → "复制为路径"
3. **直接输入**：例如 `C:\Users\你的用户名\Desktop\文件名.pptx`

macOS 系统：

我需要知道 PPT 文件的位置才能帮你压缩。请用以下任一方式告诉我：

1. **拖拽文件**：直接把 .pptx 文件拖到对话框
2. **复制路径**：在 Finder 中选中文件，按 Option + Command + C
3. **直接输入**：例如 `/Users/你的用户名/Documents/文件名.pptx` 或 `~/Desktop/文件名.pptx`

Linux 系统：

我需要知道 PPT 文件的位置才能帮你压缩。请用以下任一方式告诉我：

1. **拖拽文件**：直接把 .pptx 文件拖到对话框
2. **复制路径**：在文件管理器中右键点击文件 → "复制路径"
3. **直接输入**：例如 `/home/你的用户名/Documents/文件名.pptx` 或 `~/Documents/文件名.pptx`

路径清理和标准化

Agent 在获取到路径后，应该：

1. 移除首尾引号："C:\path\file.pptx" → C:\path\file.pptx
2. 统一为正斜杠：C:\Users\file.pptx → C:/Users/file.pptx（Python 兼容）
3. 验证文件扩展名：确保是 .pptx 文件
4. 验证文件存在：在执行前检查文件是否存在

验证文件存在的方法

在执行压缩前，Agent 应该先验证文件存在：

python -c "import os; print('✓ 文件存在' if os.path.exists(r'<path>') else '✗ 文件不存在')"

如果文件不存在，友好提示用户检查路径是否正确。

Agent 完整执行流程

当用户请求压缩 PPT 时，Agent 应该按以下步骤执行：

Step 1: 检测用户消息中是否有路径

使用 path_helper.py 或正则表达式从用户消息中提取路径：

python -c "import sys; sys.path.insert(0, r'{SKILL_DIR}/scripts'); from path_helper import extract_pptx_paths; paths = extract_pptx_paths(r'''<用户的完整消息>'''); print(paths[0] if paths else 'NO_PATH_FOUND')"

Step 2: 根据检测结果决定下一步

情况 A: 找到路径 → 进入 Step 3 验证

情况 B: 没有路径 → 根据用户的操作系统友好询问（参考上方的"用户交互指南"）

快速版本（通用）：

📂 请把要压缩的 PPT 文件路径发给我。

**最简单的方法：** 直接把文件拖拽到对话框即可！

或者复制文件路径粘贴给我。

Step 3: 验证文件

python -c "import sys; sys.path.insert(0, r'{SKILL_DIR}/scripts'); from path_helper import validate_path; r = validate_path(r'<提取到的路径>'); print(f'Valid: {r[\"valid\"]}, Size: {r[\"size_mb\"]}MB' if r['valid'] else f'Error: {r[\"error\"]}')"

Step 4: 执行压缩

验证通过后，执行压缩（使用 Python one-liner）：

python -c "import sys; sys.path.insert(0, r'{SKILL_DIR}/scripts'); from compress_ppt_videos import run; run(r'<验证后的路径>')"

Step 5: 报告结果

压缩完成后，告诉用户：

• 原始文件大小
• 压缩后文件大小
• 压缩比例
• 输出文件位置

CRITICAL: Execution Instructions (Agent MUST Follow)

⚠️ IMPORTANT: Avoid Path Parsing Issues

When running the compression script, you MUST use the following approach to avoid shell path parsing issues on Windows:

RECOMMENDED METHOD (Most Reliable):

Use Python's -c flag with raw strings to bypass shell escaping issues:

python -c "
import sys
sys.path.insert(0, r'{SKILL_DIR}/scripts')
from compress_ppt_videos import compress_pptx
compress_pptx(r'<input_path>')
"

ALTERNATIVE: Use forward slashes with double-quoted paths:

python "{SKILL_DIR}/scripts/compress_ppt_videos.py" "<input_path>"

Common Pitfalls to AVOID:

1. DON'T use backslashes with cd in PowerShell - it may fail silently
2. DON'T use complex path concatenation in shells
3. DON'T attempt multiple cd commands in sequence
4. DO use raw strings (r'...') in Python for Windows paths
5. DO use forward slashes in paths when possible (Python accepts them on Windows)
6. DO double-quote paths containing spaces or non-ASCII characters

Handling Chinese Filenames / Paths with Spaces

Chinese characters and spaces in paths are common. Always:

• Wrap file paths in quotes: "path/to/文件.pptx"
• Use raw strings in Python: r"C:\Users\用户\桌面\文件.pptx"

Workflow

Quick Start

To compress a PPT file with default settings (compresses both videos and images >1MB):

python "{SKILL_DIR}/scripts/compress_ppt_videos.py" "<input.pptx>"

This produces <input>_compressed.pptx in the same directory.

How It Works

1. Extract — The .pptx file (ZIP archive) is extracted to a temporary directory
2. Discover Videos — All video files under ppt/media/ are identified (supports: .mp4, .avi, .mov, .wmv, .m4v, .mkv, .webm, .flv, .mpeg, .mpg)
3. Compress Videos — Each video is compressed using ffmpeg with H.264 codec and AAC audio
4. Discover Images — All image files > 1MB under ppt/media/ are identified (supports: .png, .jpg, .jpeg, .bmp, .tiff, .tif, .webp)
5. Compress Images — Each large image is compressed using Pillow with quality optimization and optional downscaling
6. Smart Replace — Compressed files only replace originals if they are actually smaller
7. Repackage — The modified directory is re-zipped into a valid .pptx file

Command-Line Options

python compress_ppt_videos.py <input.pptx> [options]

General Options:
  -o, --output PATH           Output file path (default: <input>_compressed.pptx)
  --no-videos                 Skip video compression
  --no-images                 Skip image compression
  --dry-run                   Preview what would be compressed without doing it

Video Compression Options:
  --crf VALUE                 Quality factor 0-51 (default: 28, higher = smaller file)
  --preset PRESET             Encoding speed (default: medium)
  --max-height PIXELS         Max video height, 0 = no scaling (default: 720)
  --audio-bitrate BITRATE     Audio bitrate (default: 128k)

Image Compression Options:
  --image-quality VALUE       JPEG quality 1-95 (default: 80, lower = smaller file)
  --image-max-dim PIXELS      Max image dimension, 0 = no scaling (default: 1920)
  --image-threshold BYTES     Size threshold for image compression (default: 1048576 = 1MB)

Video Compression Parameters Guide

Image Compression Parameters Guide