1 import { FfprobeData } from 'fluent-ffmpeg'
2 import { getMaxBitrate } from '@shared/core-utils'
10 getVideoStreamDimensionsInfo,
11 getVideoStreamDuration,
14 } from '@shared/extra-utils/ffprobe'
15 import { VideoResolution, VideoTranscodingFPS } from '@shared/models'
16 import { CONFIG } from '../../initializers/config'
17 import { VIDEO_TRANSCODING_FPS } from '../../initializers/constants'
18 import { logger } from '../logger'
22 * Helpers to run ffprobe and extract data from the JSON output
26 // ---------------------------------------------------------------------------
28 // ---------------------------------------------------------------------------
30 async function getVideoStreamCodec (path: string) {
31 const videoStream = await getVideoStream(path)
32 if (!videoStream) return ''
34 const videoCodec = videoStream.codec_tag_string
36 if (videoCodec === 'vp09') return 'vp09.00.50.08'
37 if (videoCodec === 'hev1') return 'hev1.1.6.L93.B0'
39 const baseProfileMatrix = {
52 let baseProfile = baseProfileMatrix[videoCodec][videoStream.profile]
54 logger.warn('Cannot get video profile codec of %s.', path, { videoStream })
55 baseProfile = baseProfileMatrix[videoCodec]['High'] // Fallback
58 if (videoCodec === 'av01') {
59 const level = videoStream.level
61 // Guess the tier indicator and bit depth
62 return `${videoCodec}.${baseProfile}.${level}M.08`
65 // Default, h264 codec
66 let level = videoStream.level.toString(16)
67 if (level.length === 1) level = `0${level}`
69 return `${videoCodec}.${baseProfile}${level}`
72 async function getAudioStreamCodec (path: string, existingProbe?: FfprobeData) {
73 const { audioStream } = await getAudioStream(path, existingProbe)
75 if (!audioStream) return ''
77 const audioCodecName = audioStream.codec_name
79 if (audioCodecName === 'opus') return 'opus'
80 if (audioCodecName === 'vorbis') return 'vorbis'
81 if (audioCodecName === 'aac') return 'mp4a.40.2'
82 if (audioCodecName === 'mp3') return 'mp4a.40.34'
84 logger.warn('Cannot get audio codec of %s.', path, { audioStream })
86 return 'mp4a.40.2' // Fallback
89 // ---------------------------------------------------------------------------
91 // ---------------------------------------------------------------------------
93 function computeLowerResolutionsToTranscode (videoFileResolution: number, type: 'vod' | 'live') {
94 const configResolutions = type === 'vod'
95 ? CONFIG.TRANSCODING.RESOLUTIONS
96 : CONFIG.LIVE.TRANSCODING.RESOLUTIONS
98 const resolutionsEnabled: number[] = []
100 // Put in the order we want to proceed jobs
101 const resolutions: VideoResolution[] = [
102 VideoResolution.H_NOVIDEO,
103 VideoResolution.H_480P,
104 VideoResolution.H_360P,
105 VideoResolution.H_720P,
106 VideoResolution.H_240P,
107 VideoResolution.H_144P,
108 VideoResolution.H_1080P,
109 VideoResolution.H_1440P,
113 for (const resolution of resolutions) {
114 if (configResolutions[resolution + 'p'] === true && videoFileResolution > resolution) {
115 resolutionsEnabled.push(resolution)
119 return resolutionsEnabled
122 // ---------------------------------------------------------------------------
123 // Can quick transcode
124 // ---------------------------------------------------------------------------
126 async function canDoQuickTranscode (path: string): Promise<boolean> {
127 if (CONFIG.TRANSCODING.PROFILE !== 'default') return false
129 const probe = await ffprobePromise(path)
131 return await canDoQuickVideoTranscode(path, probe) &&
132 await canDoQuickAudioTranscode(path, probe)
135 async function canDoQuickAudioTranscode (path: string, probe?: FfprobeData): Promise<boolean> {
136 const parsedAudio = await getAudioStream(path, probe)
138 if (!parsedAudio.audioStream) return true
140 if (parsedAudio.audioStream['codec_name'] !== 'aac') return false
142 const audioBitrate = parsedAudio.bitrate
143 if (!audioBitrate) return false
145 const maxAudioBitrate = getMaxAudioBitrate('aac', audioBitrate)
146 if (maxAudioBitrate !== -1 && audioBitrate > maxAudioBitrate) return false
148 const channelLayout = parsedAudio.audioStream['channel_layout']
149 // Causes playback issues with Chrome
150 if (!channelLayout || channelLayout === 'unknown') return false
155 async function canDoQuickVideoTranscode (path: string, probe?: FfprobeData): Promise<boolean> {
156 const videoStream = await getVideoStream(path, probe)
157 const fps = await getVideoStreamFPS(path, probe)
158 const bitRate = await getVideoStreamBitrate(path, probe)
159 const resolutionData = await getVideoStreamDimensionsInfo(path, probe)
161 // If ffprobe did not manage to guess the bitrate
162 if (!bitRate) return false
164 // check video params
165 if (!videoStream) return false
166 if (videoStream['codec_name'] !== 'h264') return false
167 if (videoStream['pix_fmt'] !== 'yuv420p') return false
168 if (fps < VIDEO_TRANSCODING_FPS.MIN || fps > VIDEO_TRANSCODING_FPS.MAX) return false
169 if (bitRate > getMaxBitrate({ ...resolutionData, fps })) return false
174 // ---------------------------------------------------------------------------
176 // ---------------------------------------------------------------------------
178 function getClosestFramerateStandard <K extends keyof Pick<VideoTranscodingFPS, 'HD_STANDARD' | 'STANDARD'>> (fps: number, type: K) {
179 return VIDEO_TRANSCODING_FPS[type].slice(0)
180 .sort((a, b) => fps % a - fps % b)[0]
183 function computeFPS (fpsArg: number, resolution: VideoResolution) {
187 // On small/medium resolutions, limit FPS
188 resolution !== undefined &&
189 resolution < VIDEO_TRANSCODING_FPS.KEEP_ORIGIN_FPS_RESOLUTION_MIN &&
190 fps > VIDEO_TRANSCODING_FPS.AVERAGE
192 // Get closest standard framerate by modulo: downsampling has to be done to a divisor of the nominal fps value
193 fps = getClosestFramerateStandard(fps, 'STANDARD')
197 if (fps > VIDEO_TRANSCODING_FPS.MAX) fps = getClosestFramerateStandard(fps, 'HD_STANDARD')
199 if (fps < VIDEO_TRANSCODING_FPS.MIN) {
200 throw new Error(`Cannot compute FPS because ${fps} is lower than our minimum value ${VIDEO_TRANSCODING_FPS.MIN}`)
206 // ---------------------------------------------------------------------------
209 // Re export ffprobe utils
210 getVideoStreamDimensionsInfo,
214 getVideoStreamDuration,
219 getVideoStreamBitrate,
225 getClosestFramerateStandard,
227 computeLowerResolutionsToTranscode,
230 canDoQuickVideoTranscode,
231 canDoQuickAudioTranscode