mediasnacks 0.18.2 → 0.19.0

package/.zsh/completions/_mediasnacks

@@ -8,7 +8,8 @@ _mediasnacks_commands=(
   'edgespic:Extracts first and last frames'
   'gif:Video to GIF'
   
-  'dropdups:Removes duplicate frames in a video'
+  'detectdups:Detects sequentially duplicate frames in a video'
+  'dropdups:Removes sequentially duplicate frames in a video'
   'framediff:ffplay with a filter for diffing adjacent frames'
   'hev1tohvc1:Fixes video thumbnails not rendering in macOS Finder'
   'moov2front:Rearranges metadata for fast-start streaming'
@@ -38,7 +39,7 @@ fi
 
 local cmd="$words[2]"
 case "$cmd" in
-	avif|resize|sqcrop|moov2front|dropdups|edgespic|seqcheck|hev1tohvc1|framediff|vdiff|vconcat|vsplit|vtrim|dlaudio|dlvideo|unemoji|rmcover|curltime|gif|flattendir|prores)
+	avif|resize|sqcrop|moov2front|detectdups|dropdups|edgespic|seqcheck|hev1tohvc1|framediff|vdiff|vconcat|vsplit|vtrim|dlaudio|dlvideo|unemoji|rmcover|curltime|gif|flattendir|prores)
 		_files
 		;;
 	qdir)

package/README.md

@@ -34,7 +34,8 @@ mediasnacks <command> <args>
 - `gif`: Video to GIF
 
 
-- `dropdups` Removes duplicate frames in a video
+- `detectdups` Detects sequentially duplicate frames in a video
+- `dropdups` Removes sequentially duplicate frames in a video
 - `framediff`: Plays a video of adjacent frames diff
 - `hev1tohvc1`: Fixes video thumbnails not rendering in macOS Finder
 - `moov2front` Rearranges .mov and .mp4 metadata for fast-start streaming

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mediasnacks",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "Utilities for optimizing and preparing videos and images",
   "license": "MIT",
   "author": "Eric Fortis",

package/src/cli.js

@@ -14,6 +14,7 @@ const COMMANDS = {
 	edgespic: ['edgespic.js', 'Extracts first and last frames'],
 	gif: ['gif.sh', 'Video to GIF\n'],
 
+	detectdups: ['detectdups.js', 'Detects duplicate frames in a video'],
 	dropdups: ['dropdups.js', 'Removes duplicate frames in a video'],
 	framediff: ['framediff.sh', 'Plays a video of adjacent frames diff'],
 	hev1tohvc1: ['hev1tohvc1.js', 'Fixes video thumbnails not rendering in macOS Finder '],

package/src/detectdups.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+import { parseOptions } from './utils/parseOptions.js'
+import { ffmpeg, assertUserHasFFmpeg, videoAttrs } from './utils/ffmpeg.js'
+
+
+const USAGE = `
+Usage: mediasnacks detectdups [options] <video>
+
+Detects sequentially duplicate frames in a video and prints their frame numbers.
+
+Options:
+  -s, --seek <sec>      Video start time for detection
+  -d, --duration <sec>  Analyze this many seconds of video
+  -v, --verbose
+  -h, --help
+`.trim()
+
+
+async function main() {
+	await assertUserHasFFmpeg()
+
+	const { values, files } = await parseOptions({
+		seek: { short: 's', type: 'string', },
+		duration: { short: 'd', type: 'string' },
+		help: { short: 'h', type: 'boolean' }
+	})
+
+	if (values.help) {
+		console.log(USAGE)
+		process.exit(0)
+	}
+
+	if (files.length !== 1)
+		throw new Error('One video file must be specified. See mediasnacks detectdups --help')
+
+	const v = await videoAttrs(files[0])
+
+	if (v.codec_type !== 'video')
+		throw new Error('Input file must be a video.')
+
+	const vDur = Number(v.duration)
+	const seek = Number(values.seek) || (vDur > 60 ? 20 : 0)
+	const duration = Number(values.duration) || (vDur > 60 ? 20 : vDur)
+
+	if (isNaN(seek) || seek < 0)
+		throw new Error(`Invalid --seek value: ${values.seek}`)
+
+	if (isNaN(duration) || duration < 1)
+		throw new Error(`Invalid --duration value: ${values.duration}`)
+
+	if ((seek + duration) > vDur)
+		throw new Error(`Invalid analysis range. Exceeds video duration: ${vDur}`)
+
+
+	const dupFrames = await detectDuplicateFramesNums(files[0], seek, duration)
+	analyze(dupFrames, seek, duration)
+}
+
+async function detectDuplicateFramesNums(video, seek, duration) {
+	const { stderr } = await ffmpeg([
+		'-v', 'info',
+		'-stats',
+		'-ss', seek,
+		'-t', duration,
+		'-i', video,
+		'-vf', [
+			'scale=320:-1',
+			'tblend=all_mode=difference',
+			'format=gray',
+			'showinfo',
+		].join(','),
+		'-f', 'null', '-',
+	])
+
+	const reBlackFramesNum = /n:\s*(\d+).*?mean:\[0]/
+	const dupFrames = []
+	for (const line of stderr.split('\n')) {
+		const match = line.match(reBlackFramesNum)
+		if (match)
+			dupFrames.push(Number(match[1]))
+	}
+	return dupFrames
+}
+
+function analyze(dup_frames, seek, duration) {
+	const dup_distance = []
+	const histogram = {}
+	for (let i = 1; i < dup_frames.length; i++) {
+		const diff = dup_frames[i] - dup_frames[i - 1]
+		dup_distance.push(diff)
+		histogram[diff] = (histogram[diff] || 0) + 1
+	}
+	console.log({
+		analyzed_region: {
+			start: seek + 's',
+			end: (seek + duration) + 's',
+		},
+		dup_frames,
+		dup_distance,
+		histogram
+	})
+}
+
+main().catch(err => {
+	console.error(err.message || err)
+	process.exit(1)
+})

package/src/dropdups.js

@@ -20,7 +20,7 @@ const PROFILE = PRORES_PROFILES.hq
 const USAGE = `
 Usage: mediasnacks dropdups [-n <bad-frame-number>] <video>
 
-Removes duplicate frames and outputs ProRes 422 HQ.
+Removes sequentially duplicate frames and outputs ProRes 422 HQ.
 
 Options:
   -n, --bad-frame-number <n>  Known frame interval to drop.

package/src/utils/ffmpeg.js

@@ -141,7 +141,7 @@ export async function videoAttrs(v) {
 		'-of', 'json',
 		v
 	])
-	return JSON.parse(stdout).streams[0]
+	return JSON.parse(stdout).streams?.[0] || {}
 }