TYPO3 12.4文件列表生成MP4缩略图及替换错误预览图方法

一、为MP4文件生成自动缩略图 #

• 先确认服务器已安装ffmpeg工具，TYPO3依赖它提取视频帧生成缩略图。
• 在站点配置文件（config.yaml）中启用视频处理并配置参数：

  processing:
    video:
      enabled: true
      ffmpegPath: '/usr/bin/ffmpeg' # 替换为服务器上ffmpeg的实际路径
      ffmpegOptions: '-ss 00:00:01 -vframes 1' # 提取视频第1秒的帧作为缩略图
  

• 清除TYPO3缓存后，重新上传MP4文件，或对已存在的MP4文件执行右键菜单中的「重新处理文件」操作，系统会自动生成并显示缩略图。

二、替换默认错误预览图（无法生成缩略图时） #

若服务器无法安装ffmpeg或缩略图生成失败，可全局替换默认视频预览图：

• 准备自定义预览图标（建议尺寸与TYPO3默认预览图一致，如128x128像素），上传至fileadmin目录（例如fileadmin/custom-icons/mp4-preview.png）。
• 通过全局TSconfig配置替换：

  # 替换MP4文件的默认预览图标
  file_list.previewIcons.mp4 = fileadmin/custom-icons/mp4-preview.png
  # 如需覆盖其他视频格式，可添加对应配置
  file_list.previewIcons.mov = fileadmin/custom-icons/mp4-preview.png
  

• 进阶方案：通过自定义扩展注册预览图标，在扩展的Configuration/FileIcons.php中添加：

  return [
      'mp4' => [
          'provider' => \TYPO3\CMS\Core\Imaging\IconProvider\BitmapIconProvider::class,
          'source' => 'EXT:your_extension/Resources/Public/Icons/mp4-preview.png',
      ],
  ];
  

  激活扩展并清除缓存后，系统将使用自定义图标作为MP4文件的默认预览。

内容的提问来源于stack exchange，提问作者jonasmautner