FFmpeg

https://ffmpeg.org/documentation.html
Admin
FFmpeg is a complete, cross-platform solution to record, convert, stream, and play multimedia...
Tokens:546,046
Snippets:3,843
Trust Score:9.9
Update:1 week ago
Show doc for...
Tokens:
Raw
### Create video from image sequence starting at index 100

Source: https://ffmpeg.org/ffmpeg-all.html

Similar to the previous example, but starts reading from a file with index 100 in the sequence.

```bash
ffmpeg -framerate 10 -start_number 100 -i 'img-%03d.jpeg' out.mkv
```

--------------------------------

### Capture JACK audio with ffmpeg

Source: https://ffmpeg.org/ffmpeg-all.html

This example shows how to capture audio from a JACK readable client using ffmpeg. It creates a JACK writable client named 'ffmpeg', starts a sample readable client (jack_metro), lists clients, and connects them.

```bash
# Create a JACK writable client with name "ffmpeg".
$ ffmpeg -f jack -i ffmpeg -y out.wav

# Start the sample jack_metro readable client.
$ jack_metro -b 120 -d 0.2 -f 4000

# List the current JACK clients.
$ jack_lsp -c
system:capture_1
system:capture_2
system:playback_1
system:playback_2
ffmpeg:input_1
metro:120_bpm

# Connect metro to the ffmpeg writable client.
$ jack_connect metro:120_bpm ffmpeg:input_1
```

--------------------------------

### Setup a listening TCP connection with ffmpeg and access with ffplay

Source: https://ffmpeg.org/ffmpeg-all.html

Start ffmpeg to listen on a TCP port, then use ffplay to connect to that port. The listen option enables listening mode.

```bash
ffmpeg -i input -f format tcp://hostname:port?listen
ffplay tcp://hostname:port
```

--------------------------------

### Key info file example

Source: https://ffmpeg.org/ffmpeg-all.html

A complete key info file example with key URI, key file path, and IV.

```text
http://server/file.key
/path/to/file.key
0123456789ABCDEF0123456789ABCDEF

```

--------------------------------

### Example of mpegts muxer with custom IDs and metadata

Source: https://ffmpeg.org/ffmpeg-all.html

This example demonstrates how to use the mpegts muxer with custom original network ID, transport stream ID, service ID, PMT start PID, and start PID, along with service provider and name metadata.

```bash
ffmpeg -i file.mpg -c copy \
     -mpegts_original_network_id 0x1122 \
     -mpegts_transport_stream_id 0x3344 \
     -mpegts_service_id 0x5566 \
     -mpegts_pmt_start_pid 0x1500 \
     -mpegts_start_pid 0x150 \
     -metadata service_provider="Some provider" \
     -metadata service_name="Some Channel" \
     out.ts

```

--------------------------------

### coreimage list filters example

Source: https://ffmpeg.org/ffmpeg-all.html

Command-line example to list all filters available with the coreimage filter.

```plaintext
coreimage=list_filters=true
```

--------------------------------

### MediaFoundation Encoder Examples

Source: https://ffmpeg.org/ffmpeg-all.html

Command-line examples for using MediaFoundation encoders with hardware acceleration and scaling.

```APIDOC
## MediaFoundation Encoder Examples

### Description
Example ffmpeg commands for hardware encoding with MediaFoundation encoders.

### Example 1: Hardware encoding
```
ffmpeg -i input.mp4 -c:v h264_mf -hw_encoding 1 output.mp4
```

### Example 2: Hardware-accelerated decoding with hardware encoding
```
ffmpeg -hwaccel d3d11va -i input.mp4 -c:v h264_mf -hw_encoding 1 output.mp4
```

### Example 3: Hardware-accelerated decoding, HW scaling and encoding with quality setting
```
ffmpeg -hwaccel d3d11va -hwaccel_output_format d3d11 -i input.mp4 -vf scale_d3d11=1920:1080 -c:v hevc_mf -hw_encoding 1 -quality 80 output.mp4
```
```

--------------------------------

### Example x264opts string

Source: https://ffmpeg.org/ffmpeg-all.html

Example of a colon-separated list of key=value options for x264opts or x264-params. The value can be omitted for x264opts, in which case 1 is assumed.

```text
level=30:bframes=0:weightp=0:cabac=0:ref=1:vbv-maxrate=768:vbv-bufsize=2000:analyse=all:me=umh:no-fast-pskip=1:subq=6:8x8dct=0:trellis=0
```

--------------------------------

### psnr filter example with different containers

Source: https://ffmpeg.org/ffmpeg-all.html

Command line example using psnr filter with main.mpg and ref.mkv, outputting to null.

```bash
ffmpeg -i main.mpg -i ref.mkv -lavfi  "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]psnr" -f null -

```

--------------------------------

### Contents of split.txt for concatf example

Source: https://ffmpeg.org/ffmpeg-all.html

Example file containing a line-break delimited list of resources to be concatenated by the concatf protocol.

```text
split1.mpeg
split2.mpeg
split3.mpeg
```

--------------------------------

### Initialize Vulkan hardware device with instance extensions

Source: https://ffmpeg.org/ffmpeg-all.html

Use this to choose the first Vulkan device and enable the Wayland and XCB instance extensions.

```bash
-init_hw_device vulkan:0,instance_extensions=VK_KHR_wayland_surface+VK_KHR_xcb_surface
```

--------------------------------

### Apply 3-second saturation fade-in starting at 0

Source: https://ffmpeg.org/ffmpeg-all.html

Example of using the hue filter to apply a 3-second saturation fade-in effect starting at 0.

```ffmpeg
hue="s=min(t/3\,1)"
```

--------------------------------

### Initialize Vulkan device and run nlmeans_vulkan filter

Source: https://ffmpeg.org/ffmpeg-all.html

Example of choosing the first Vulkan device and running the nlmeans_vulkan filter with default parameters. Requires Vulkan hardware and FFmpeg built with --enable-vulkan.

```bash
-init_hw_device vulkan=vk:0 -filter_hw_device vk -i INPUT -vf "hwupload,nlmeans_vulkan,hwdownload" OUTPUT
```

--------------------------------

### Keep 5 seconds starting 1.5 seconds into stream relative to first packet with trim filter

Source: https://ffmpeg.org/ffmpeg-all.html

Same as the previous example but with start_rel=1 to make the start relative to the first packet, so it works regardless of the stream's starting timestamp.

```bash
ffmpeg -i INPUT.aac -c copy -bsf:a trim=start=1500:start_type=msec_pt:start_rel=1:end=5000:end_type=dur_t_msec OUTPUT.aac
```

--------------------------------

### Initialize OpenCL device and run avgblur_opencl filter

Source: https://ffmpeg.org/ffmpeg-all.html

Example of choosing the first device on the second platform and running avgblur_opencl filter with default parameters on it.

```bash
-init_hw_device opencl=gpu:1.0 -filter_hw_device gpu -i INPUT -vf "hwupload, avgblur_opencl, hwdownload" OUTPUT
```

--------------------------------

### Apply 3-second saturation fade-out starting at 5 seconds

Source: https://ffmpeg.org/ffmpeg-all.html

Example of using the hue filter to apply a 3-second saturation fade-out effect starting at 5 seconds.

```ffmpeg
hue="s=max(0\, min(1\, (8-t)/3))"
```

--------------------------------

### Trim every 2nd silence period and keep 1.5s start silence with silenceremove

Source: https://ffmpeg.org/ffmpeg-all.html

Similar to the previous example, but also keeps a maximum of 1.5 seconds of silence from the start of the audio. It sets start_periods=1, start_duration=1, and start_silence=1.5.

```ffmpeg
silenceremove=stop_periods=-2:stop_duration=1:stop_threshold=-90dB:stop_silence=0.5:start_periods=1:start_duration=1:start_silence=1.5:stop_threshold=-90dB
```

--------------------------------

### Initialize QSV device on DRM render node

Source: https://ffmpeg.org/ffmpeg-all.html

Use -init_hw_device qsv:hw,child_device=/dev/dri/renderD129 to create a QSV device with 'MFX_IMPL_HARDWARE' on DRM render node /dev/dri/renderD129.

```bash
-init_hw_device qsv:hw,child_device=/dev/dri/renderD129
```

--------------------------------

### Trim filter example: drop everything except the second minute

Source: https://ffmpeg.org/ffmpeg-all.html

Uses the trim filter with start and end times (60 and 120 seconds) to keep only the second minute of the input.

```text
ffmpeg -i INPUT -vf trim=60:120

```

--------------------------------

### Initialize Vulkan hardware device by name substring

Source: https://ffmpeg.org/ffmpeg-all.html

Use this to choose the first Vulkan device with a name containing the string 'RADV'.

```bash
-init_hw_device vulkan:RADV
```

--------------------------------

### Initialize Vulkan hardware device by index

Source: https://ffmpeg.org/ffmpeg-all.html

Use this to choose the second Vulkan device on the system by its index.

```bash
-init_hw_device vulkan:1
```

--------------------------------

### Initialize second CUDA device and run scale_cuda and bilateral_cuda filters

Source: https://ffmpeg.org/ffmpeg-all.html

Example of initializing the second CUDA device on the system and running scale_cuda and bilateral_cuda filters. Requires CUDA hardware and FFmpeg built with CUDA support.

```bash
./ffmpeg -hwaccel cuda -hwaccel_output_format cuda -i input.mp4 -init_hw_device cuda:1 -filter_complex \
"[0:v]scale_cuda=format=yuv444p[scaled_video];[scaled_video]bilateral_cuda=window_size=9:sigmaS=3.0:sigmaR=50.0" \
-an -sn -c:v h264_nvenc -cq 20 out.mp4

```

--------------------------------

### Example IV

Source: https://ffmpeg.org/ffmpeg-all.html

An example initialization vector (IV) as a hexadecimal string.

```text
0123456789ABCDEF0123456789ABCDEF

```

--------------------------------

### 3:1 compression starting at -15dB

Source: https://ffmpeg.org/ffmpeg-all.html

Applies 3:1 compression starting at -15dB.

```text
compand=points=-80/-80|-15/-15|0/-10.8|20/-5.2
```

--------------------------------

### Complete example of thumbnail creation with ffmpeg

Source: https://ffmpeg.org/ffmpeg-all.html

Creates a thumbnail image from a video by selecting the most representative frame and scaling it to 300x200, then saving as out.png.

```bash
ffmpeg -i in.avi -vf thumbnail,scale=300:200 -frames:v 1 out.png

```

--------------------------------

### 2:1 compression starting at -18dB

Source: https://ffmpeg.org/ffmpeg-all.html

Applies 2:1 compression starting at -18dB.

```text
compand=points=-80/-80|-18/-18|0/-9.8|20/0.7
```

--------------------------------

### Initialize QSV device on DirectX adapter

Source: https://ffmpeg.org/ffmpeg-all.html

Use -init_hw_device qsv:hw,child_device=1 to create a QSV device with 'MFX_IMPL_HARDWARE' on DirectX adapter 1.

```bash
-init_hw_device qsv:hw,child_device=1
```

--------------------------------

### 2:1 compression starting at -12dB

Source: https://ffmpeg.org/ffmpeg-all.html

Applies 2:1 compression starting at -12dB.

```text
compand=points=-80/-80|-12/-12|0/-6.8|20/1.9
```

--------------------------------

### Initialize D3D11VA device by index

Source: https://ffmpeg.org/ffmpeg-all.html

Use -init_hw_device d3d11va:1 to create a d3d11va device on the Direct3D 11 display adapter specified by index 1.

```bash
-init_hw_device d3d11va:1
```

--------------------------------

### 2:1 compression starting at -9dB

Source: https://ffmpeg.org/ffmpeg-all.html

Applies 2:1 compression starting at -9dB.

```text
compand=points=-80/-80|-9/-9|0/-5.3|20/2.9
```

--------------------------------

### 2:1 compression starting at -6dB

Source: https://ffmpeg.org/ffmpeg-all.html

Applies 2:1 compression starting at -6dB.

```text
compand=points=-80/-80|-6/-6|0/-3.8|20/3.5
```

--------------------------------

### Experimental HTTP server usage with ffmpeg and wget

Source: https://ffmpeg.org/ffmpeg-all.html

Demonstrates sending and receiving data using the experimental HTTP server enabled by the listen option. Includes server and client commands for both sending and receiving, with alternatives using wget.

```bash
# Server side (sending):
ffmpeg -i somefile.ogg -c copy -listen 1 -f ogg http://server:port

# Client side (receiving):
ffmpeg -i http://server:port -c copy somefile.ogg

# Client can also be done with wget:
wget http://server:port -O somefile.ogg

# Server side (receiving):
ffmpeg -listen 1 -i http://server:port -c copy somefile.ogg

# Client side (sending):
ffmpeg -i somefile.ogg -chunked_post 0 -c copy -f ogg http://server:port

# Client can also be done with wget:
wget --post-file=somefile.ogg http://server:port
```

--------------------------------

### Connect to a zmq stream with ffplay

Source: https://ffmpeg.org/ffmpeg-all.html

Example command for multiple clients to connect to the zmq stream using ffplay.

```bash
ffplay zmq:tcp://127.0.0.1:5555
```

--------------------------------

### Edge-preserving smoothing with guided filter

Source: https://ffmpeg.org/ffmpeg-all.html

Apply guided filter for edge-preserving smoothing. Uses default parameters.

```bash
ffmpeg -i in.png -vf guided out.png
```

--------------------------------

### Select first 5 seconds 1st audio stream and rest of time 2nd audio stream

Source: https://ffmpeg.org/ffmpeg-all.html

Same as the video example but for audio, using asendcmd and astreamselect.

```ffmpeg
asendcmd='5.0 astreamselect map 1',astreamselect=inputs=2:map=0
```

--------------------------------

### Keep 5 seconds starting 1.5 seconds into stream with trim filter

Source: https://ffmpeg.org/ffmpeg-all.html

Use the trim bitstream filter to keep a 5-second segment starting 1.5 seconds into the stream. The start and end are specified in milliseconds using msec_pt and dur_t_msec.

```bash
ffmpeg -i INPUT.aac -c copy -bsf:a trim=start=1500:start_type=msec_pt:end=5000:end_type=dur_t_msec OUTPUT.aac
```
Tokens:
Raw