FFmpeg 9.1
Since* 9.1
#

Convert 360 videos between various formats. Supported formats (projections) are subset of v360 filter, that are most popular 360-degree video formats.

The filter accepts subset of v360 options:

input, output

Set format of the input/output video.

e, equirect

Equirectangular projection.

eac

Equi-Angular Cubemap. (Output only)

FIXME: current output doesn’t contain padding.

flat

Regular video.

dfisheye

Dual fisheye.

sg

Stereographic format.

fisheye

Fisheye projection.

gopromax

GoPro Max .360 format. (Input only)

A .360 video file contains two video streams (front and rear); with this input projection the filter takes two inputs and combines them into a single stream. See the overlap option.

w, h

Set the output video resolution. See v360 options.

yaw, pitch, roll, rorder

Set rotation for the output video. See v360 options.

h_fov, v_fov

Set output horizontal/vertical field of view. See v360 options.

ih_fov, iv_fov

Set input horizontal/vertical field of view. See v360 options.

overlap

Set number of overlapped pixels on input .360 video. Only used with input=gopromax.

The GoPro Max .360 video contains overlapped area (See https://gopro.com/news/max-tech-specs-stitching-resolution). The filter blends overlapped images in these two areas.

The number of pixels of overlapped areas depends on the video resolution. In most cases, the value is automatically calculated based on input video size, but it may be changed on GoPro Max2 or future models. The option is to adjust for unknown video resolutions.

#

Examples

Special notes exist to use with input=gopromax.

The GoPro Max .360 video file contains two video streams, and the stream number must be specified. The stream number (e.g., [0:5]) depends on the model and shooting mode. Please check actual stream number with ffprobe command.

  • Convert GoPro Max (8bit color depth) .360 to Equirectangular projection. GoPro Max uses obsolete yuvj420p pixel format, thus convert the format to yuv420p before this filter.

    ffmpeg -init_hw_device vulkan -i INPUT.360 -filter_complex "[0:0]format=yuv420p,hwupload[vf],[0:5]format=yuv420p,hwupload[vr], [vf][vr]v360_vulkan=input=gopromax:output=e, hwdownload,format=yuv420p" OUTPUT.mkv
  • Convert GoPro Max2 (10bit color depth) .360 to Dual fisheye projection. GoPro Max2 uses yuv420p10le pixel format.

    ffmpeg -init_hw_device vulkan -i INPUT.360 -filter_complex "[0:0]hwupload[vf],[0:4]hwupload[vr], [vf][vr]v360_vulkan=input=gopromax:output=dfisheye, hwdownload,format=yuv420p10le" OUTPUT.mkv