GifHorse - 对话搜索与GIF制作器

通过搜索对话并添加时间字幕，从您的视频库创建反应GIF。

GifHorse的功能

1. 视频转录- 通过下载字幕、使用本地.srt文件或Whisper AI，提取带时间戳的对话
2. 搜索对话- 即时在整个视频库中查找引用片段
3. 预览片段- 在创建GIF前精确查看将要捕捉的内容
4. 制作GIF- 生成带精确时间字幕和可选水印的GIF

设置

首次设置

1. 安装gifhorse（通过上方的安装按钮）
2. 安装FFmpeg-full用于字幕渲染（通过上方的安装按钮）
3. 转录您的视频库（自动下载字幕）：

cd ~/gifhorse && source venv/bin/activate
gifhorse transcribe ~/Movies

gifhorse命令必须在虚拟环境中运行。您可以通过以下方式激活：

cd ~/gifhorse && source venv/bin/activate

或使用激活助手：

source ~/gifhorse/activate.sh

可用命令

视频转录

从视频中提取对话（每视频限一次）：

# Default: downloads subtitles from online providers (fast, recommended)
gifhorse transcribe /path/to/videos

# Use only local .srt files (no downloading, no Whisper)
gifhorse transcribe /path/to/videos --use-subtitles

# Use Whisper AI (slow but works for any video)
gifhorse transcribe /path/to/video.mp4 --use-whisper

# Re-transcribe videos already in database
gifhorse transcribe /path/to/videos --force

仅下载字幕

下载.srt文件而不存入数据库：

gifhorse fetch-subtitles /path/to/videos
gifhorse fetch-subtitles /path/to/videos --skip-existing

搜索对话

在整个资源库中查找引用：

# Basic search
gifhorse search "memorable quote"

# Search with surrounding context
gifhorse search "memorable quote" --context 2

# Show all results (no limit)
gifhorse search "memorable quote" --all

# Custom result limit (default: 100)
gifhorse search "memorable quote" --limit 50

创建前预览

精确查看将捕获的内容：

gifhorse preview "memorable quote" 1
gifhorse preview "quote" 1 --include-before 1 --include-after 1

生成GIF

生成带字幕的GIF：

# Basic GIF (auto-named from dialogue, saved to exports/)
gifhorse create "memorable quote" 1

# Explicit output path
gifhorse create "memorable quote" 1 -o reaction.gif

# High quality for social media
gifhorse create "quote" 1 --width 720 --fps 24 --quality high

# Include conversation context
gifhorse create "quote" 1 --include-before 2 --include-after 1

# Substitute words in subtitles (repeatable, target segments by number from preview)
gifhorse create "the age of men" 1 --include-after 1 \
  -s 1 "men" "standardized software" \
  -s 2 "orc" "custom applications"

# Clean replace (no strikethrough)
gifhorse create "quote" 1 -r 1 "old word" "new word"

# Create and send via iMessage
gifhorse create "quote" 1 --send
gifhorse create "quote" 1 --send-to "+15551234567"

管理数据库

# Remove videos by path pattern (SQL LIKE wildcards)
gifhorse remove "%Adventure Time%"
gifhorse remove "%S01%" --yes

# Check subtitle status for a directory
gifhorse subtitle-status ~/Videos
gifhorse subtitle-status ~/Videos --missing-only

检查状态

# See transcription stats
gifhorse stats

# List all transcribed videos
gifhorse list

配置

# Set phone number for iMessage sending
gifhorse config --set-phone "+15551234567"

# Show current configuration
gifhorse config --show

时间选项

精确控制捕获内容：

• --include-before N- 包含匹配项之前的N个对话片段
• --include-after N- 包含匹配项之后的N个对话片段
• --padding-before SECS- 在对话开始前添加缓冲秒数（默认值：1.0）
• --padding-after 秒数- 在对话结束后添加缓冲秒数（默认值：1.0）
• --start-offset 秒数- 手动调整开始时间（可为负值）
• --end-offset 秒数- 手动调整结束时间（可为负值）

重要提示：对于对话后的反应镜头，请使用--padding-after而非--include-after。include-after 选项会捕获直到下一个对话片段的所有时间（可能长达30秒以上！）。

质量选项

• --quality 低|中|高- 调色板质量（影响文件大小）
• --fps N- 每秒帧数（默认：15，使用24可获得流畅效果）
• --width N- 宽度像素值（默认：480，使用720可获得高清效果）

字幕选项

• -s, --sub NUM OLD NEW- 替换片段中的词语（可重复）。被替换的词语显示为红色删除线，替换词为红色。片段编号通过预览显示。
• -r, --replace 编号 旧词 新词- 干净地替换词语（无删除线）。可重复。
• --no-subtitles- 创建不带字幕叠加的GIF

输出

• 默认输出文件名自动从对话文本派生（例如，i_dont_think_so.gif）并保存到exports/
• 目录。使用-o 路径进行覆盖。文件名冲突处理会追加_2、_3等后缀。

iMessage

• --send- 通过iMessage将创建的GIF发送到配置的电话号码（仅限macOS）
• --send-to 号码- 发送至特定电话号码（覆盖配置）

注意：所有GIF自动在右下角包含一个微妙的"gifhorse"水印。

常用工作流程

快速反应GIF

gifhorse search "perfect"
gifhorse create "perfect" 1 --padding-after 2.0

完整对话交流

gifhorse search "key phrase"
gifhorse preview "key phrase" 1 --include-before 2 --include-after 1
gifhorse create "key phrase" 1 --include-before 2 --include-after 1

带文字替换的梗图

gifhorse preview "the age of men" 1 --include-after 1
gifhorse create "the age of men" 1 --include-after 1 \
  -s 1 "men" "standardized software" \
  -s 2 "orc" "custom applications"

适用于Twitter/X的高质量版本

gifhorse create "quote" 1 --width 720 --fps 24 --quality high -o tweet.gif

对话后有反应的场景

gifhorse create "memorable line" 1 --padding-after 3.0

创建并通过iMessage发送

gifhorse config --set-phone "+15551234567"
gifhorse create "quote" 1 --send

技巧与提示

1. 始终先预览- 使用preview在创建前验证时间点
2. 默认下载字幕- 只需运行gifhorse transcribe即可自动获取字幕
3. 注意文件大小- 高质量 + 长时长 = 大文件（20秒可能超过20 MB）
4. 填充 vs 包含- 对于反应，使用--padding-after而非--include-after
5. 带上下文搜索- 添加--context 2以查看周围对话
6. 使用 --force 重新转录- 使用--force在获得更好的字幕后更新转录
7. 检查字幕覆盖情况- 使用subtitle-status查看哪些视频需要字幕

文件大小指南

• 低质量，10秒，360p：约1-2 MB
• 中等质量，10秒，480p：约3-5 MB
• 高质量，20秒，720p：约20+ MB

故障排除

"未找到命令：gifhorse"

激活虚拟环境：

cd ~/gifhorse && source venv/bin/activate

字幕渲染错误

确保已安装 FFmpeg-full：

brew install ffmpeg-full

未找到视频文件

数据库存储绝对路径。如果在转录后移动了视频，请在新位置重新转录。

网络共享支持

GifHorse 支持网络挂载的视频：

# Mount network share (macOS)
open "smb://server-ip/share-name"

# Transcribe from network
gifhorse transcribe "/Volumes/server-ip/Movies"

何时使用此技能

当用户想要时，调用 gifhorse：

• 在他们的视频库中搜索对话或引用
• 从电影或电视节目中创建反应 GIF
• 制作带有替换文字的梗图 GIF
• 为视频片段添加字幕
• 转录视频以实现可搜索的对话
• 在创建前预览 GIF 效果
• 通过 iMessage 发送 GIF
• 从数据库中移除视频
• 检查其视频收藏的字幕状态

了解更多

• GitHub: https://github.com/Coyote-git/gifhorse
• 使用指南: https://github.com/Coyote-git/gifhorse/blob/main/USAGE_GUIDE.md
• 路线图: https://github.com/Coyote-git/gifhorse/blob/main/ROADMAP.md

许可证

MIT