pptopic

将 PowerPoint 演示文稿导出为长图的工具。

功能

• 将 PPTX 文件的所有幻灯片垂直拼接为一张长图
• 支持 JPG 和 PNG 格式输出
• 支持自定义输出宽度和目录
• 内置图片优化功能，使用图片优化引擎进行无损压缩

安装

安装 uv

# 使用 scoop
scoop install uv

安装 pptopic

uv pip install -e .

使用

导出 PPTX 为长图

# 基本用法
pptopic export presentation.pptx

# 指定输出文件名
pptopic export presentation.pptx --output result.png

# 优化导出的图片
pptopic export presentation.pptx --optimize -o result.png

# 自定义宽度和最大高度
pptopic export presentation.pptx --width 1080 --optimize --max-height 20000

单独优化图片

# 优化图片
pptopic optimize image.png

# 指定输出文件
pptopic optimize image.png --output optimized.png

# 自定义优化参数
pptopic optimize image.png --max-height 20000 --engine pngquant

系统要求

• Windows 系统（使用 win32com 调用 PowerPoint）
• Python >= 3.13
• Microsoft PowerPoint

图片优化

推荐使用 pngquant 进行图片压缩。 当然，使用自己熟悉的图片优化压缩引擎是一样的。

自动安装脚本

使用提供的 PowerShell 脚本自动安装 pngquant：

.\install-pngquant.ps1

该脚本会自动：

1. 检查 pngquant 是否已安装
2. 如果未安装，检查 scoop 是否已安装
3. 如果 scoop 未安装，自动安装 scoop
4. 使用 scoop 安装 pngquant

手动安装

scoop install pngquant

License

MIT License