mediasnacks 0.18.1 → 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

@@ -6,13 +6,20 @@ Utilities video and images.
 ### Install
 **FFmpeg and Node.js must be installed.**
 
-```shell
-npm install -g mediasnacks --ignore-scripts=true
+```sh
+npm install -g mediasnacks
+```
+
+Optionally, if you have `ignore-scripts=true` in your `.npmprc`, 
+you can install zsh auto-completions with:
+```sh
+$(npm root -g)/mediasnacks/install-zsh-completions.sh
 ```
 
 
+
 ## Overview
-```shell
+```sh
 mediasnacks <command> <args>
 ```
 
@@ -27,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/install-zsh-completions.sh

@@ -4,9 +4,6 @@ set -eu
 # Exit on systems without ZSH
 zsh=$(command -v zsh) || exit 0
 
-# Exit on non-global (npm -g) installations
-[ "${npm_config_global:-}" = "true" ] || exit 0
-
 src="$(cd "$(dirname "$0")" && pwd)/.zsh/completions/_mediasnacks"
 [ -f "$src" ] || exit 0
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mediasnacks",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "Utilities for optimizing and preparing videos and images",
   "license": "MIT",
   "author": "Eric Fortis",
@@ -10,7 +10,8 @@
 	},
 	"scripts": {
 		"test": "docker run --rm $(docker build -q .)",
-		"postinstall": "sh install-zsh-completions.sh"
+		"postinstall": "sh install-zsh-completions.sh",
+		"dev-install": "npm i -g . --ignore-scripts=false"
 	},
 	"files": [
 		"src",

package/src/avif.js

@@ -29,7 +29,7 @@ async function main() {
 	}
 
 	if (!files.length)
-		throw new Error('No images specified. See npx mediasnacks avif --help')
+		throw new Error('No images specified. See mediasnacks avif --help')
 
 	console.log('AVIF…')
 	for (const file of files)

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 '],
@@ -62,7 +63,7 @@ if (!opt) {
 	process.exit(1)
 }
 if (!Object.hasOwn(COMMANDS, opt)) {
-	console.error(`'${opt}' is not a command. See npx mediasnacks --help\n`)
+	console.error(`'${opt}' is not a command. See mediasnacks --help\n`)
 	process.exit(1)
 }
 

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.
@@ -45,7 +45,7 @@ async function main() {
 	}
 
 	if (!files.length)
-		throw new Error('No video specified. See npx mediasnacks dropdups --help')
+		throw new Error('No video specified. See mediasnacks dropdups --help')
 
 	let nBadFrame = values['bad-frame-number']
 	if (nBadFrame && !/^\d+$/.test(nBadFrame))

package/src/edgespic.js

@@ -14,8 +14,8 @@ Extracts the first and last frames from each video and saves them to the 'edgepi
 --width defaults to 640px and The aspect ratio is preserved.
 
 Example:
-    npx mediasnacks edgespic --width 800 *.mov
-    npx mediasnacks edgespic -w 600 'videos/**/*.mp4'
+    mediasnacks edgespic --width 800 *.mov
+    mediasnacks edgespic -w 600 'videos/**/*.mp4'
 `.trim()
 
 

package/src/prores.js

@@ -27,8 +27,8 @@ Options:
   -h, --help         Show this help message
 
 Example:
-  npx mediasnacks prores video.mov
-  npx mediasnacks prores --profile 2 video.mov
+  mediasnacks prores video.mov
+  mediasnacks prores --profile 2 video.mov
 
   Outputs: video.prores.mov
 `.trim()
@@ -48,7 +48,7 @@ async function main() {
 	}
 
 	if (files.length !== 1)
-		throw new Error('Expected 1 argument: video file. See npx mediasnacks prores --help')
+		throw new Error('Expected 1 argument: video file. See mediasnacks prores --help')
 
 	const videoPath = resolve(files[0])
 

package/src/resize.js

@@ -15,10 +15,10 @@ Usage: mediasnacks resize [--width=<num>] [--height=<num>] [-y | --overwrite] [-
 Resizes videos and images. The aspect ratio is preserved when only one dimension is specified.
 
 Example: Overwrites the input file (-y)
-    npx mediasnacks resize -y --width 480 'dir-a/**/*.png' 'dir-b/**/*.mp4'
+    mediasnacks resize -y --width 480 'dir-a/**/*.png' 'dir-b/**/*.mp4'
 
 Example: Output directory (-o)
-    npx mediasnacks resize --height 240 --output-dir /tmp/out video.mov
+    mediasnacks resize --height 240 --output-dir /tmp/out video.mov
    
 Details:
 	--width and --height are -2 by default:

package/src/sqcrop.js

@@ -30,7 +30,7 @@ async function main() {
 	}
 
 	if (!files.length)
-		throw new Error('No images specified. See npx mediasnacks sqcrop --help')
+		throw new Error('No images specified. See mediasnacks sqcrop --help')
 
 	console.log('Cropping…')
 	for (const file of files)

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] || {}
 }
 
 

package/src/vsplit.js

@@ -19,7 +19,7 @@ Arguments:
   <video>  Video file to split
 
 Example:
-  npx mediasnacks vsplit clips.csv video.mov
+  mediasnacks vsplit clips.csv video.mov
 
   Given clips.csv:
     start,end
@@ -44,7 +44,7 @@ async function main() {
 	}
 
 	if (files.length !== 2)
-		throw new Error('Expected 2 arguments: CSV file and video file. See npx mediasnacks vsplit --help')
+		throw new Error('Expected 2 arguments: CSV file and video file. See mediasnacks vsplit --help')
 
 	const [csvPath, videoPath] = files.map(f => resolve(f))
 

package/src/vtrim.js

@@ -32,7 +32,7 @@ async function main() {
 	}
 
 	if (!files.length)
-		throw new Error('No video specified. See npx mediasnacks vtrim --help')
+		throw new Error('No video specified. See mediasnacks vtrim --help')
 
 	for (const file of files)
 		await trim(resolve(file), values.start, values.end)