# ffmpeg命令用法总结
## 前言
ffmpeg是开源的媒体处理框架，使用其自带的ffmpeg工具可以很便捷的对媒体文件进行处理。ffmpeg参数很多，通过组合参数可以实现很多功能。下面我将分享一些常用的参数，总结一些经常用到的使用场景。

## 常用参数
```
-i：输入文件
-y：覆盖输出文件
-f：指定输出文件格式
-c：指定编解码器
-c copy 表示音视频保持原有编码
-b：指定比特率
-s：指定分辨率
-r：指定帧率
-t：指定转码时长
-ss：指定转码开始时间
-acodec：指定音频编码器
-vcodec：指定视频编码器
-ac：指定音频通道数
-ar：指定音频采样率
-ab：指定音频比特率
-vn 禁用视频
-an 禁用音频
-map：指定转码流
-metadata：指定输出文件元数据
-threads：指定线程数
-preset：指定编码速度
-crf：指定视频质量
-pix_fmt：指定像素格式
-filter_complex：指定复杂滤镜
-vf：指定简单滤镜
-stream_loop: 指定循环次数
```
## 使用场景
### 1.转协议
使用ffmpeg，可以很轻松的将一种协议的视频流转换成另一种协议。下面举几个例子：
- 将存储在电脑上的视频文件推送为rtmp流
```
ffmpeg -re -stream_loop -1 -i input.mp4 -c:v libx264 -f flv rtmp://server:1935/live/test
```
- 将存储在电脑上的视频文件拉取为rtsp流
```
ffmpeg -re -stream_loop -1 -i input.mp4 -c:v libx264 -f rtsp rtsp://server:8554/live
```
- 将rtsp流转推为rtmp流
```
ffmpeg -i rtsp://server:8554/live -c copy -f flv rtmp://server:1935/live/test
```

### 2.转封装
在工作中，有时可能会遇到需要对视频文件的封装格式进行转换的情况。比如需要将MP4格式的文件转换成MKV，或者将MP4转化成flv。这个时候使用ffmpeg也可以很便捷的实现。例子如下：
- MP4转MKV
```
ffmpeg -i input.mp4 -c copy output.mkv
```
- MP4转flv
```
ffmpeg -i input.mp4 -c copy -f flv output.flv
```

### 3.转编码
使用ffmpeg，可以通过指定编解码器，将一种编码转换成另一种编码。
> 需要注意的是，如果想要进行某个编码格式的转换，需要在编译ffmpeg的时候，将对应的编解码器编译进去。
- 转H264编码
```
ffmpeg -i input.mp4 -c:v libx264 -c:a aac output.mp4
```
- 转H265编码
```
ffmpeg -i input.mp4 -c:v libx265 -c:a aac output.mp4
```
- 转VP9编码
```
ffmpeg -i input.mp4 -c:v vp9 -c:a libvorbis output.webm
```

### 4.音视频裁剪
使用ffmpeg可以实现对视频进行剪切。比如，需要将视频的10~30s的内容剪切出来，可以使用命令：
```
ffmpeg -i input.mp4 -ss 10 -t 10 -c:v copy -c:a copy output.mp4
```
- -ss 10: 指定起始时间，这里是第 10 秒。
- -t 10: 指定持续时间，这里是 10 秒，所以输出文件将包含从第 10 秒到第 20 秒的内容。
### 5.音视频拼接
如果需要将多个视频进行拼接，可以创建一个文本文件，列出要拼接的视频文件的路径。例如，创建一个名为 input.txt 的文本文件，其中包含：

```
file 'video1.mp4'
file 'video2.mp4'
file 'video3.mp4'
```
这表示要拼接的三个视频文件为 video1.mp4、video2.mp4 和 video3.mp4。

使用 ffmpeg 命令进行拼接：
```
ffmpeg -f concat -i input.txt -c copy output.mp4
```
### 6.音视频分离
通过ffmpeg命令，将媒体文件中的音视频分离出来，可以使用如下命令：
- 分离音频，保存为aac文件
```
ffmpeg -i input.mp4 -c:a copy -vn audio.aac
```
- 分离视频，保存为MP4文件
```
ffmpeg -i input.mp4 -c:v copy -an video.mp4
```
### 7.音视频合并
将音频文件和视频文件合并：
```
ffmpeg -i video.mp4 -i audio.aac -c:v copy -c:a copy output.mp4
```
### 8.音视频添加水印
通过ffmpeg，给视频添加水印，可以添加图片水印，也可以添加文字水印。
- 添加图片水印
```
ffmpeg -i input.mp4 -vf "movie=logo.jpg[wm];[in][wm]overlay=30:10[out]" output.mp4
```
- 添加文字水印
```
ffmpeg -i input.mp4 -vf "drawtext=fontsize=100:fontfile=lazy.ttf:text='This is a test':x=20:y=20:fontcolor=green:box=1:boxcolor=yellow" output.mp4
```
- 添加时间水印
```
ffmpeg -re -i input.mp4 -vf "drawtext=fontsize=60:fontfile=lazy.ttf:text='%{localtime\:%Y\-%m\-%d %H-%M-%S}':fontcolor=green:box=1:boxcolor=yellow" output.mp4
```
### 9.音视频加密
关于HLS加密的实现，我专门写过一篇文章。感兴趣的朋友们可以移步[《HLS AES加密》](https://www.cnblogs.com/Azion/p/17501233.html)。

### 10.修改视频码率
- 指定码率
```
ffmpeg -i input.mp4 -b:v 1500k output.mp4
```
### 11.修改视频分辨率
```
ffmpeg -i input.mp4 -s 1280x720 output.mp4
```
### 12. 检测视频源是否失效
```
ffmpeg -i <source> -f null -
```
## 进阶命令
### h264禁用b帧
```sh
# -bf 0
ffmpeg -i input.mp4 -c:v libx264 -preset ultrafast -tune zerolatency -bf 0 -f rtsp rtsp://127.0.0.1:8554/live/stream

```
### rtsp推流
#### windows下列出媒体设备
```
ffmpeg -list_devices true -f dshow -i dummy
```
设置音频采样率，rtsp tcp传输模式等
```sh
ffmpeg -f dshow -i video="USB Video Device" -re -stream_loop -1 -i brave.wav -c:v mjpeg -huffman 0 -c:a pcm_mulaw -ar 8000 -ac 1 -rtsp_transport tcp -f rtsp rtsp://192.168.66.18:8554/TX00000206AQBMMD/dm?jwt=

ffmpeg -f dshow -i video="DV20 USB CAMERA":audio="麦克风 (USB Audio)" -c:v h264_qsv -preset fast -bf 0  -f dshow -c:a pcm_mulaw -ar 8000 -ac 1 -rtsp_transport tcp -f rtsp rtsp://192.168.66.133:8554/duid000000003905/dm
# 实时生成时间戳
ffmpeg -f dshow -use_wallclock_as_timestamps 1 -i video="DV20 USB CAMERA":audio="麦克风 (USB Audio)" -c:v mjpeg -huffman 0  -c:a pcm_mulaw -ar 8000 -ac 1 -rtsp_transport tcp -f rtsp rtsp://192.168.66.133:8554/duid000000003905/dm
```
### 杂项
#### 一些编码格式配置
```
ffmpeg -re -stream_loop -1 -i mecha.avi -c:v mjpeg -huffman 0 -rtsp_transport tcp -f rtsp rtsp://192.168.66.18:8554/live
ffmpeg -re -stream_loop -1 -i mecha.avi -c:v mjpeg -huffman 0 -pix_fmt yuvj420p -rtsp_transport udp -f rtsp rtsp://192.168.66.19:8554/live

ffmpeg -f video4linux2 -i "/dev/video0" -c:v mjpeg -huffman 0 -rtsp_transport tcp -f rtsp rtsp://192.168.66.18:8554/live
ffmpeg -f video4linux2 -i "/dev/video0" -c:v copy -huffman 0 -rtsp_transport tcp

ffplay -rtsp_transport tcp rtsp://192.168.66.18:8554/live

ffmpeg -re -stream_loop -1 -i mecha.mp4 -c:v mjpeg -c:a pcm_mulaw -huffman 0 -rtsp_transport tcp -f rtsp rtsp://192.168.66.18:8554/live

# 浏览器采集音频转化
ffmpeg -f f32le -ar 48000 -ac 1 -i raw_audio.pcm volum.wav
ffmpeg -f s16le -ar 48000 -ac 1 -i raw_audio.pcm -f f32le -ar 48000 -ac 1 volum.wav

ffmpeg -f f32le -ar 48000 -ac 1 -i raw_audio.pcm -f s32le -ar 48000 -ac 1 outputauto.pcm
ffmpeg -f mulaw -ar 8000 -ac 1 -i star.pcm -f f32le -ar 48000 -ac 1 starf32le.pcm

ffmpeg -f f32le -ar 48000 -ac 1 -i raw_audio.pcm -acodec pcm_f32le -ac 1 -ar 48000 origin.wav -y
ffmpeg -f mulaw -ar 8000 -ac 1 -i star.pcm -acodec pcm_f32le -ac 1 -ar 48000 star.wav -y
ffmpeg -f f32le -ar 48000 -ac 1 -i starf32le.pcm -acodec pcm_f32le -ac 1 -ar 48000 -f rtsp rtsp://192.168.66.19:8554/live
ffmpeg -f f32le -ar 48000 -ac 1 -i starf32le.pcm -acodec pcm_f32le -ac 1 -ar 48000 -f rtsp rtsp://192.168.66.19:8554/live


ffplay -f f32le -ar 48000 -ac 1 -i raw_audio.pcm 

ffmpeg -re -stream_loop -1  -f f32le -ar 48000 -ac 1 -i starf32le.pcm -acodec pcm_mulaw -sample_fmt u8 -ar 8000 -ac 1 -rtsp_transport tcp -f rtsp rtsp://192.168.66.19:8554/live

ffmpeg -re -stream_loop -1 -f mulaw -ar 8000 -ac 1  -i a.pcm -acodec pcm_mulaw -ar 8000 -ac 1 -rtsp_transport tcp -f rtsp rtsp://192.168.66.19:8554/live
```
#### mjpeg 转 h264
```
mjpeg 转 h264

软解 延迟很高（6~7s）
ffmpeg -i rtsp://192.168.66.136:8554/169 -c:v libx264 -preset fast -f mpegts -x264opts "keyint=60:min-keyint=60" udp://localhost:1234

降低编码质量
ffmpeg -i rtsp://192.168.66.136:8554/169 -c:v libx264 -preset ultrafast -crf 28 -f mpegts -x264opts "keyint=60:min-keyint=60" udp://localhost:1234

启用硬件加速
ffmpeg -i rtsp://192.168.66.136:8554/169 -c:v h264_qsv -preset fast -crf 28 -f mpegts -x264opts "keyint=30:min-keyint=30" udp://localhost:123

ffmpeg.exe -i .\20250721_174907.mp4 -c:v libx264 -b:v 500k -c:a aac -ar 8000  output500aac.mp4

低延时模式播放
ffplay.exe  -fflags nobuffer -flags low_delay -analyzeduration 0 -sync ext rtsp://192.168.66.18:8554/duid000000000629/dm

ffplay.exe -fflags nobuffer -flags low_delay -protocol_whitelist "file,rtp,udp,rtcp,tcp" .\video.sdp
```

## 补充
除了上述给出的参数外，ffmpeg还有很多参数，如果我们使用命令行对视频进行处理后，没有达到想要的效果，那么就有可能是ffmpeg的参数配置出现了问题，可以参考ffmpeg的[官方文档](https://ffmpeg.org/ffmpeg.html)来获取更多的参数用法。
当有一些特定的需求需要实现，但是又不知道该使用ffmpeg的哪些参数时，可以尝试使用**FFmpeg Commander**工具，你可以根据自己的需求手动选择配置，他可以帮你快速生成ffmpeg的命令行。
链接：https://alfg.dev/ffmpeg-commander/
![ffmpegComm.png](/static/img/190e3bdc898d788b03e6c97357591fab.ffmpegComm.webp)
> 我会持续对文章进行更新，增加更多的ffmpeg命令行的例子。

ffmpeg-command

## 命令
```sh
ssh -t -R 80:localhost:8080 proxy.tunnl.gg
```
## 网址
https://tunnl.gg/

免费的公网SSH反向隧道

##  一、包命名（Package Naming）

| 项目      | 规范              | 示例                                   | 说明               |
| ------- | --------------- | ------------------------------------ | ---------------- |
| **包名**  | 全小写、简短、语义明确     | `http`, `json`, `ossserver`          | 不要使用驼峰、大写、下划线    |
| **文件名** | 与包功能对应，小写加下划线分隔 | `server.go`, `handler_test.go`       | 文件名可带 `_test.go` |
| **目录名** | 通常与包名一致         | `/ossserver`, `/internal/ossserver`  | 导入路径中使用目录名       |
| **导入名** | 通常与包名相同         | `import "example.com/app/ossserver"` | Go 工具会自动识别       |

> 💡 **不要**在包名中包含 `go` 或项目名重复的前缀（例如 `ossserver/ossserver`）。



---

##  二、命名规则（导出与非导出）

| 名称   | 可见性       | 示例                                     | 说明                    |
| ---- | --------- | -------------------------------------- | --------------------- |
| 小写开头 | 包内可见      | `func start()`, `type server struct{}` | 内部使用                  |
| 大写开头 | 可导出（包外可见） | `func Start()`, `type Server struct{}` | 对外接口                  |
| 缩写   | 全部大写      | `HTTPServer`, `ID`, `URL`              | 保持一致，不写成 `HttpServer` |
| 常量   | 大写或驼峰     | `const MaxSize = 1024`                 | 根据上下文确定               |

---

##  三、推荐目录结构

适用于中大型项目（含多个模块、组件、API）：

```
myapp/
├── cmd/                  # 各独立可执行程序入口
│   └── myapp/            # 主程序入口（package main）
│       └── main.go
├── internal/             # 私有逻辑（仅限本项目导入）
│   └── ossserver/        # 内部模块
│       ├── server.go
│       └── handler.go
├── pkg/                  # 可复用模块（对外暴露）
│   └── uploader/         
│       ├── upload.go
│       └── storage.go
├── api/                  # 定义接口、协议、proto 等
│   └── v1/
│       └── types.go
├── configs/              # 配置文件模板
├── scripts/              # 启动/构建脚本
├── go.mod
└── go.sum
```

> * `internal/` → **项目内部使用的包**，外部无法导入。
> * `pkg/` → **可以被其他项目复用**的包。
> * `cmd/` → **每个可执行文件一个子目录**。

---

##  四、导入与引用风格

```go
import (
    "fmt"

    "example.com/myapp/internal/ossserver"
    "example.com/myapp/pkg/uploader"
)
```

使用：

```go
func main() {
    srv := ossserver.NewServer()
    uploader.UploadFile("test.mp4")
    fmt.Println("server started")
}
```

> ✅ **不要**在导入时使用别名，除非名字冲突：
>
> ```go
> import (
>     jsoniter "github.com/json-iterator/go" // 当标准库 json 冲突时
> )
> ```

---

##  五、常见错误示例

| 错误写法                                 | 问题                      |
| ------------------------------------ | ----------------------- |
| `package OssServer`                  | 包名含大写，不符合 Go 风格         |
| `import "github.com/xxx/OSS_Server"` | 导入路径不规范                 |
| `HttpServer`                         | 缩写大小写错误，推荐 `HTTPServer` |
| `pkg1`, `pkg2`                       | 包名无语义，不推荐               |

---

## ✅ 推荐命名模式总结

| 类型   | 命名示例                | 说明           |
| ---- | ------------------- | ------------ |
| 包名   | `ossserver`         | 全小写，简洁       |
| 结构体  | `Server`            | 首字母大写        |
| 方法   | `Start()`, `stop()` | 控制导出性        |
| 常量   | `DefaultPort`       | 驼峰命名         |
| 接口   | `Reader`, `Writer`  | 一般以 `-er` 结尾 |
| 测试文件 | `xxx_test.go`       | 包含测试函数       |

go命名规范

##  一、RTP 视频时间戳的含义

RTP 视频时间戳单位是 **时钟周期**，标准频率为 **90 kHz**（即每秒 90000 个 tick）。
它代表帧在播放时间轴上的“相对时间”，而不是发送时间。




---

##  二、基本计算公式（可变帧率）

如果上一帧捕获时间是 `t_prev`，当前帧捕获时间是 `t_now`，单位为秒：

```text
Δt = t_now - t_prev
timestamp_now = timestamp_prev + Δt × 90000
```

### 举例：

| 帧号 | 采集时间（秒） | 时间差 Δt | RTP ts 增量 | RTP timestamp |
| -- | ------- | ------ | --------- | ------------- |
| 0  | 0.000   | -      | -         | 1000000       |
| 1  | 0.033   | 0.033  | 2970      | 1002970       |
| 2  | 0.066   | 0.033  | 2970      | 1005940       |
| 3  | 0.100   | 0.034  | 3060      | 1009000       |
| 4  | 0.136   | 0.036  | 3240      | 1012240       |

这样生成的 RTP 时间戳完全根据真实捕获时间变化，可自然适应 VFR（可变帧率）。

---

##  三、代码示例（C风格伪代码）

```c
uint32_t video_ts_base = rand();   // 初始随机时间戳
uint32_t video_ts = video_ts_base;

double last_capture_time = now_seconds();  // 获取当前系统时间（秒）

while (get_next_frame(&frame)) {
    double now = now_seconds();
    double delta = now - last_capture_time;
    uint32_t inc = (uint32_t)(delta * 90000.0);
    video_ts += inc;

    send_rtp_packet(frame.data, frame.size, video_ts);
    last_capture_time = now;
}
```

---

## 四、注意事项

1. **不要用系统 tick 直接当 RTP 时间戳**
   RTP 时间戳只能反映**播放时间间隔**，不能是实际系统时间（否则 wraparound、同步都会出问题）。

2. **要避免时间抖动**
   如果帧间隔噪声大（比如摄像头捕获不稳定），可以对 `Δt` 做平滑（如移动平均）以减少 jitter。

3. **视频和音频的时钟不同**

   * 视频：90000 Hz
   * 音频：采样率（8000 Hz, 48000 Hz 等）
     但两者在 RTCP SR 包里可以对齐（NTP→RTP 时间基转换）。

4. **在录像/回放中保持一致的时间基**
   如果你的编码器输出带有 PTS/DTS（比如 ffmpeg），可以直接用帧的 `pts` → 转换到 90 kHz：

   ```text
   rtp_ts = pts_in_seconds × 90000
   ```

---

## 总结

| 场景         | 时间戳计算方式                              |
| ---------- | ------------------------------------ |
| 固定帧率       | `rtp_ts += 90000 / fps`              |
| 可变帧率 (VFR) | `rtp_ts += (t_now - t_prev) * 90000` |
| 从编码器 PTS   | `rtp_ts = pts * 90000`               |

rtp timestamp笔记

# 常见类型对照表
| 十进制 Type | 十六进制示例 | 名称          | 说明          |
| -------- | ------ | ----------- | ----------- |
| 1        | 0x41   | 非 IDR slice | 普通 P/B 帧    |
| 5        | 0x65   | IDR slice   | 关键帧 (I 帧)   |
| 6        | 0x06   | SEI         | 附加信息（如时间戳）  |
| 7        | 0x67   | SPS         | 序列参数集       |
| 8        | 0x68   | PPS         | 图像参数集       |
| 9        | 0x09   | AUD         | 访问单元分隔符     |
| 28       | -      | FU-A        | RTP 分片 (常用) |



## NAL Header（NAL 头部）
NAL 头部共 8 位，包含三个核心字段：

```
+---------------+---------------+-----------------+
| forbidden_bit | nal_ref_idc   | nal_unit_type   |
| (1位)         | (2位)         | (5位)           |
+---------------+---------------+-----------------+
```
### forbidden_zero_bit（1 位） ：

禁止位，固定为 0。若在接收端检测到该位为 1，表示 NALU 可能存在传输错误（如比特翻转），需丢弃该 NALU。
### nal_ref_idc（2 位） ：

参考重要性指示，取值范围为 0-3，值越大表示该 NALU 对解码的重要性越高：

0：表示该 NALU 不用于参考（如 B 帧数据），丢弃后不影响后续帧解码；

1-3：表示该 NALU 用于参考（如 I 帧、P 帧数据），丢弃可能导致错误传播。
### nal_unit_type（5 位） ：

指示 NALU 的类型，共 32 种（0-31），常见类型如下表：

![image.png](/static/img/7287ca033681c82ff3c4102be28a8fad.image.webp)
---

![image.png](/static/img/171a973e243fcb59fa55c1f1eba3d721.image.webp)

项目	规范	示例	说明
包名	全小写、简短、语义明确	`http`, `json`, `ossserver`	不要使用驼峰、大写、下划线
文件名	与包功能对应，小写加下划线分隔	`server.go`, `handler_test.go`	文件名可带 `_test.go`
目录名	通常与包名一致	`/ossserver`, `/internal/ossserver`	导入路径中使用目录名
导入名	通常与包名相同	`import "example.com/app/ossserver"`	Go 工具会自动识别