# python-ffmpeg-installer

**Repository Path**: gdty/python-ffmpeg-installer

## Basic Information

- **Project Name**: python-ffmpeg-installer
- **Description**: 通过 Python 安装 FFmpeg v6 的最简单方法。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-27
- **Last Updated**: 2025-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# python-ffmpeg-installer

这是通过 Python 安装 FFmpeg v6 的最简单方法。

## 安装

```bash
> pip install --extra-index-url https://pypi.cnb.cool/gdteyu/python/-/packages/simple python_ffmpeg_installer
```

## 使用方法

```py
import python_ffmpeg_installer

# 在第一次调用 add_paths() 时安装 python_ffmpeg_installer，线程安全。
python_ffmpeg_installer.add_paths()  # 阻塞直到文件下载完成
# 或者使用 python_ffmpeg_installer.add_paths(weak=True) 仅在 ffmpeg/ffprobe 不在路径中时添加
# 现在 ffmpeg 和 ffprobe 将使用 python_ffmpeg_installer 的版本。
os.system("python_ffmpeg_installer -i myfile.mp4 ...")
```

或者，如果您希望在首次使用时安装，或者不想修改系统路径，请使用 `python_ffmpeg_installer`

```py
import python_ffmpeg_installer

# 在第一次调用时安装 python_ffmpeg_installer，线程安全。
os.system("python_ffmpeg_installer -i myfile.mp4 ...")
```

您也可以在命令行中使用它

```bash
> pip install python_ffmpeg_installer
> python_ffmpeg_installer -i file.mp4 ...
> python_ffprobe_installer ...
> python_ffmpeg_paths
FFMPEG=\**\ffmpeg.exe
FFPROBE=\**\ffprobe.exe
```

## 关于

此工具将为运行平台安装 FFmpeg 和 FFProbe 的二进制文件（包含所有插件和编解码器）。平台二进制文件在首次使用时安装，无需管理员权限。

此包旨在允许依赖 `ffmpeg` 的工具只需包含此包即可获得功能齐全的 `ffmpeg`。不需要单独安装 ffmpeg。

### 没有此库的情况下...

您的 ffmpeg 工具必须依赖用户安装 `ffmpeg`，并确保使用正确的构建设置以确保您的工具正常运行。对于基于 ffmpeg 的工具来说，这是一个主要的痛点（例如缺少编解码器），而此库解决了这个问题。

目前支持以下平台的二进制文件：
  * `win32` (Windows)
  * `darwin` (MacOS)
  * `linux` (来自 Ubuntu 20LTS)
  * 欢迎 Pull Requests 添加其他平台支持！要添加支持，请参见相关 git 仓库：others。

这里既有 Python API 也有命令行 API。安装此包后，以下命令行别名将可用：

  * `python_ffmpeg` 的行为与 `ffmpeg` 相同
  * `python_ffprobe` 的行为与 `ffprobe` 相同
  * `python_ffmpeg_paths` 打印出 ffmpeg 二进制文件的路径

```bash
> python_ffmpeg_paths
FFMPEG=\*\ffmpeg.exe
FFPROBE=\*\ffprobe.exe
```

## API

以下是获取二进制文件并执行它们的方法。

```py
# 使用别名方法
import os
# 平台二进制文件将在第一次运行时安装。
os.system("python_ffmpeg_installer -version")  # python_ffmpeg_installer 是此工具 python_ffmpeg_installer 的别名。
os.system("python_ffprobe_installer -version")
```

```py
# 使用程序位置方法
import subprocess
from python_ffmpeg_installer import run

# 平台二进制文件将在第一次运行以下命令时安装。
ffmpeg, ffprobe = run.get_or_fetch_platform_executables_else_raise()
# ffmpeg, ffprobe 将是 ffmpeg 和 ffprobe 的路径。
subprocess.check_output([ffmpeg, "-version"])
subprocess.check_output([ffprobe, "-version"])
```

## 上传

    python setup.py upload

## 测试

  * 克隆此项目 `git clone https://gitee.com/gdty/python_ffmpeg_installer`
  * `cd python_ffmpeg_installer`
  * 然后运行测试

## 虚拟环境（可选）

要在一个虚拟环境中测试它，请使用这个简单的助手：

要轻松设置虚拟环境，请运行
```bash
python setupvirtualenv.py
```

然后运行 `./activate.sh` 来激活 shell。

或者在 idea 项目设置中添加 python sdk venv 和模块，但必须添加 python tools

## 二进制源
  * others

## 版本

ffmpeg 和 ffprobe 均为版本：6.0

## 发布历史
  * 1.0.0 初始版本