# ffmpeg-node-demo

**Repository Path**: hepingmogul/ffmpeg-node-demo

## Basic Information

- **Project Name**: ffmpeg-node-demo
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-03
- **Last Updated**: 2025-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ffmpeg-node-demo

## 项目介绍

这是一个使用 Node.js 调用 ffmpeg 命令行工具的示例项目，提供了一系列实用的音视频处理功能。

## 前提条件

- 安装 [Node.js](https://nodejs.org/) (推荐 v14 或更高版本)
- 安装 [ffmpeg](https://ffmpeg.org/download.html) 并确保其在系统 PATH 中可用

## 功能列表

### 1. 从视频提取音频

从 MP4 文件中提取音频并保存为 MP3 格式。

```javascript
import extractAudio from './ffmpeg/extractAudio.js';

extractAudio('input.mp4', 'output.mp3')
  .then(() => console.log('音频提取成功！'))
  .catch(err => console.error('音频提取失败:', err.message));
```

### 2. 获取视频或音频详细信息

获取媒体文件的详细信息，包括格式、时长、比特率、视频流和音频流等信息。

```javascript
import detection from './ffmpeg/detection.js';

detection('media.mp4')
  .then(info => {
    console.log(`格式: ${info.format.format_name}`);
    console.log(`时长: ${info.duration} 秒`);
    console.log(`大小: ${info.size} 字节`);
    console.log(`比特率: ${info.bitRate} bps`);
    console.log(`视频流数量: ${info.videoStreams.length}`);
    console.log(`音频流数量: ${info.audioStreams.length}`);
  })
  .catch(err => console.error('获取媒体信息失败:', err.message));
```

## 安装

```bash
# 使用 npm
npm install

# 或使用 pnpm
pnpm install
```

## 示例

查看 `examples` 目录中的示例文件，了解如何使用各个功能。

## 注意事项

- 确保 ffmpeg 已正确安装并可在命令行中访问
- 处理大文件时可能需要较长时间，请耐心等待