@effing/ffmpeg

中文文档
0.48.0发布于 2026/11/12MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 3345

Effing 的 FFmpeg 二进制下载器

中文使用文档
文档目录4 节
  1. 使用量
  2. 如何运作
  3. 支持的平台
  4. 环境变量

@effing/ffmpeg

平台专用的FFmpeg 二进制下载器.

部分 财源 家庭——用TypeScript制作节目视频.

安装时下载特定平台的 FFmpeg 二进制 建筑工程 GitHub 发布( 目前标记) 页:1页:1.

使用量

import { pathToFFmpeg } from "@effing/ffmpeg";

// pathToFFmpeg is the absolute path to the binary, or null on unsupported platforms

如何运作

这个 install 生命周期脚本( e)node install.mjs运行期间 pnpm install 和:

  1. 检测当前平台和架构
  2. 如果二进制已存在, 则跳过下载, 其 SHA-256 匹配被绑定的文摘 checksums.json (旧版的一纸二进制,或短发或错误的一纸被替换)
  3. 从 GitHub 版本下载 gzipped 二进制
  4. 解压并验证它的SHA-256 与被钉住的文摘 checksums.json
  5. 重命名为位置并设置可执行权限( 仅在验证通过时)

在检查和不匹配时, 部分下载的文件被删除, 安装失败; 一个已存在的二进制将保持不变, 直到其替换被验证为止 .

维修: 每个 FFmpeg 版本起伏(FFMPEG_VERSION 内 install.mjs)必须再生 checksums.json。对于每个支持的目标: curl -sL "<base-url>/ffmpeg-<platform>-<arch>.gz" | gunzip | shasum -a 256

二进制放在包根(packages/ffmpeg/ffmpeg) (中文(简体) ). 在单曲中,pnpm symlinks指所有工作空间消费者共享相同的二进制.

支持的平台

平台建筑
达文x64, 武装64
链接x64, 武装64
赢32x64 (韩语)

环境变量

变量说明
FFMPEG_BINARIES_URL覆盖二进制下载的基础 URL( 默认为 effing- ffmpeg- buildings GitHub 发行) 。 被钉住的校验和仍然适用,所以一个镜子必须服务于同样的建筑,除非 FFMPEG_SKIP_CHECKSUM=1 设定
FFMPEG_SKIP_CHECKSUM设定为 1 以跳过 SHA-256 对已下载的二进制进行校验, 并保留任何已存在的二进制 FFMPEG_BINARIES_URL

版本与发布记录

@effing/ffmpeg 共发布 113 个版本,首次发布于 2026/02/07;过去 12 个月发布了 113 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.48.0latest2026/11/121 天前
0.47.32026/11/112 天前
0.47.22026/11/104 天前
0.47.12026/10/2915 天前
0.47.02026/10/2717 天前
0.46.22026/10/2222 天前

关于 @effing/ffmpeg 的常见问题

@effing/ffmpeg 是什么?

Effing 的 FFmpeg 二进制下载器

如何安装 @effing/ffmpeg?

在项目目录运行 npm install @effing/ffmpeg,或使用 pnpm add / yarn add / bun add。

@effing/ffmpeg 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@effing/ffmpeg 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@effing/ffmpeg 可以商用吗?

@effing/ffmpeg 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@effing/ffmpeg 的下载量有多少?

根据 npm 官方下载统计,@effing/ffmpeg 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,345 次,日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@effing/ffmpeg 还在维护吗?

最新版本 0.48.0 发布于 2026/11/12(1 天前);至今共发布 113 个版本,其中过去 12 个月发布了 113 个;首次发布于 2026/02/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。