FFmpegthumbnailer 技术文档

FFmpegthumbnailer 技术文档

【免费下载链接】ffmpegthumbnailer Lightweight video thumbnailer that can be used by file managers to create thumbnails for video files 项目地址: https://gitcode.com/gh_mirrors/ff/ffmpegthumbnailer

1. 安装指南

1.1 系统要求

• 操作系统：Linux
• 依赖库：ffmpeg, libpng, libjpeg

1.2 安装步骤

1.2.1 通过包管理器安装

在 Arch Linux 系统中，可以通过以下命令安装 FFmpegthumbnailer：

sudo pacman -S ffmpegthumbnailer

1.2.2 从源码安装

1. 克隆项目仓库：

   git clone https://github.com/dirkvdb/ffmpegthumbnailer.git
   cd ffmpegthumbnailer
   

2. 编译并安装：

   mkdir build
   cd build
   cmake ..
   make
   sudo make install
   

2. 项目使用说明

2.1 基本用法

FFmpegthumbnailer 是一个轻量级的视频缩略图生成工具，可以通过命令行调用。以下是基本的使用示例：

ffmpegthumbnailer -i input_video.mp4 -o output_thumbnail.jpg -s 256 -t 10%

2.2 命令行参数说明

• -i: 输入视频文件名。
• -o: 输出缩略图文件名。文件名以 .jpg 或 .jpeg 结尾时，输出为 JPEG 格式；否则为 PNG 格式。
• -s: 缩略图尺寸（像素）。使用 0 表示原始尺寸。默认值为 128。
• -t: 时间点（百分比或绝对时间 hh:mm:ss）。默认值为 10%。
• -f: 在生成的缩略图上叠加电影条。
• -q: 图像质量（0 为最差，10 为最好）。仅适用于 JPEG 输出。默认值为 8。
• -c: 覆盖图像格式（jpeg 或 png）。默认根据文件名确定。
• -a: 忽略宽高比，生成方形缩略图。
• -w: 解决旧版本 ffmpeg 中的一些问题（仅在遇到问题时使用）。
• -rN: 每 N 秒重复生成缩略图，N=0 表示禁用重复（默认：0）。
• -h: 显示帮助信息。

3. 项目 API 使用文档

FFmpegthumbnailer 主要通过命令行接口使用，没有提供编程语言的 API。如果需要在代码中生成视频缩略图，可以通过调用系统命令来实现。

3.1 示例代码

以下是一个使用 Python 调用 FFmpegthumbnailer 生成缩略图的示例：

import subprocess

def generate_thumbnail(input_file, output_file, size=256, time="10%"):
    command = [
        "ffmpegthumbnailer",
        "-i", input_file,
        "-o", output_file,
        "-s", str(size),
        "-t", time
    ]
    subprocess.run(command)

generate_thumbnail("input_video.mp4", "output_thumbnail.jpg")

4. 项目安装方式

4.1 通过包管理器安装

在 Arch Linux 系统中，可以通过以下命令安装 FFmpegthumbnailer：

sudo pacman -S ffmpegthumbnailer

4.2 从源码安装

1. 克隆项目仓库：

   git clone https://github.com/dirkvdb/ffmpegthumbnailer.git
   cd ffmpegthumbnailer
   

2. 编译并安装：

   mkdir build
   cd build
   cmake ..
   make
   sudo make install
   

通过以上步骤，您可以成功安装并使用 FFmpegthumbnailer 生成视频缩略图。

【免费下载链接】ffmpegthumbnailer Lightweight video thumbnailer that can be used by file managers to create thumbnails for video files 项目地址: https://gitcode.com/gh_mirrors/ff/ffmpegthumbnailer