mediasnacks 0.30.2 → 0.32.0

package/README.md

@@ -31,6 +31,7 @@ mediasnacks <command> <args>
 - `countframes` Counts frames in a video
 - `ssim` Computes similarity of two images
 - `gif`: Video to GIF
+- `info`: Prints video attributes
 
 
 - `detectdups` Detects sequentially duplicate frames in a video

package/index.js

@@ -21,3 +21,4 @@ export { unemoji } from './src/unemoji.js'
 export { vsplit } from './src/vsplit.js'
 export { vtrim } from './src/vtrim.js'
 export { base64 } from './src/base64.js'
+export { infoSummary } from './src/info.js'

package/package.json

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

package/src/avif.js

@@ -1,7 +1,7 @@
 import { join, basename, dirname } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
 import { replaceExt, lstat } from './utils/fs-utils.js'
-import { ffmpeg } from './utils/subprocess.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -17,13 +17,13 @@ EXAMPLES
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		outdir: { type: 'string', default: '' },
 		overwrite: { short: 'y', type: 'boolean' },
 	})
 
 	if (!files.length)
-		throw 'Invalid input image'
+		throw usage('Invalid input image')
 
 	for (const file of files) {
 		await avif({

package/src/base64.js

@@ -45,13 +45,13 @@ const mimes = new class {
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		css: { type: 'boolean' },
 		img: { type: 'boolean' },
 	})
 
-	if (files.length === 0) throw 'Missing or invalid file'
-	if (files.length !== 1) throw 'Only one file is accepted'
+	if (files.length === 0) throw usage('Missing or invalid file')
+	if (files.length !== 1) throw usage('Only one file is accepted')
 
 	const { data, mime } = base64(files[0])
 	if (values.css) console.log(`background-image: url(data:${mime};base64,${data});`)

package/src/cli.js

@@ -17,7 +17,8 @@ const COMMANDS = {
 	frameseq: ['./frameseq.js', 'Converts video to sequence of PNGs'],
 	countframes: ['./countframes.js', 'Counts frames in a video'],
 	ssim: ['./ssim.js', 'Computes SSIM between two images'],
-	gif: ['./gif.js', 'Video to GIF\n'],
+	gif: ['./gif.js', 'Video to GIF'],
+	info: ['./info.js', 'Prints video stream attributes\n'],
 
 	detectdups: ['./detectdups.js', 'Detects duplicate frames in a video'],
 	dropdups: ['./dropdups.js', 'Removes duplicate frames in a video'],

package/src/countframes.js

@@ -22,7 +22,7 @@ EXAMPLES
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		fps: { type: 'string' },
 		start: { short: 's', type: 'string' },
 		end: { short: 'e', type: 'string' },
@@ -31,7 +31,7 @@ export default async function main() {
 	const { fps, start, end } = values
 	const video = files[0]
 	if (!video)
-		throw 'No video file specified'
+		throw usage('No video file specified')
 
 	const n = await countframes({ video, fps, start, end })
 	console.log(String(n))

package/src/detectdups.js

@@ -1,6 +1,6 @@
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg } from './utils/subprocess.js'
 import { videoAttrs } from './utils/videoAttrs.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 const STDEV_THRESHOLD = 0.2
 
@@ -29,18 +29,18 @@ SEE ALSO
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		seek: { short: 's', type: 'string', },
 		duration: { short: 'd', type: 'string' },
 	})
 
 	if (files.length !== 1)
-		throw 'Invalid input file. One video file must be specified.'
+		throw usage('Invalid input file. One video file must be specified.')
 
 	const video = files[0]
 	const v = await videoAttrs(video)
 	if (v.codec_type !== 'video')
-		throw 'Invalid input file. Must be a video.'
+		throw usage('Invalid input file. Must be a video.')
 
 	const vDur = Number(v.duration)
 
@@ -52,9 +52,9 @@ export default async function main() {
 		? Number(values.duration)
 		: vDur > 60 ? 20 : vDur
 
-	if (isNaN(seek) || seek < 0) throw `Invalid --seek value: ${values.seek}`
-	if (isNaN(duration) || duration < 1) throw `Invalid --duration value: ${values.duration}`
-	if ((seek + duration) > vDur) throw `Invalid analysis range. Exceeds video duration: ${vDur}`
+	if (isNaN(seek) || seek < 0) throw usage(`Invalid --seek value: ${values.seek}`)
+	if (isNaN(duration) || duration < 1) throw usage(`Invalid --duration value: ${values.duration}`)
+	if ((seek + duration) > vDur) throw usage(`Invalid analysis range. Exceeds video duration: ${vDur}`)
 
 	const dups = await detectdups({ video: files[0], seek, duration })
 	const h = deltaHistogram(dups)

package/src/dlaudio.js

@@ -12,10 +12,10 @@ DESCRIPTION
 `
 
 export default async function main() {
-	const { values, positionals } = await parseOptions(HELP)
+	const { values, positionals, usage } = await parseOptions(HELP)
 
 	if (!positionals[0])
-		throw 'Missing URL'
+		throw usage('Missing URL')
 
 	const f = await dlaudio(positionals[0])
 	console.log(f)

package/src/dlvideo.js

@@ -11,10 +11,10 @@ DESCRIPTION
 `
 
 export default async function main() {
-	const { values, positionals } = await parseOptions(HELP)
+	const { values, positionals, usage } = await parseOptions(HELP)
 
 	if (!positionals[0])
-		throw 'Missing URL'
+		throw usage('Missing URL')
 
 	await dlvideo(positionals[0])
 }

package/src/dropdups.js

@@ -1,7 +1,8 @@
 import { resolve, parse, format } from 'node:path'
-import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg, run } from './utils/subprocess.js'
 import { ProresProfiles } from './prores.js'
+import { parseOptions } from './utils/parseOptions.js'
+import { ffmpegWithProgress } from './utils/ffmpeg.js'
+import { infoSummary } from './info.js'
 
 
 const PROFILE = ProresProfiles.default
@@ -15,7 +16,7 @@ DESCRIPTION
 
 OPTIONS
   -n, --dup-frame-num <n>  Known frame interval to drop.
-		                       Default: n=0, which auto-detects repeated frames (slower)
+ 		                       Default: n=0, which auto-detects repeated frames (slower)
 
 EXAMPLES
   Use n=2 when every other frame is repeated:
@@ -27,25 +28,25 @@ EXAMPLES
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		'dup-frame-num': { short: 'n', type: 'string' },
 	})
 
 	if (!files.length)
-		throw 'No video specified.'
+		throw usage('No video specified.')
 
 	let dupFrameNum = values['dup-frame-num']
 	if (dupFrameNum && !Number.isInteger(+dupFrameNum))
-		throw 'Invalid -n. It must be a positive integer.'
+		throw usage('Invalid -n. It must be a positive integer.')
 
-	for (const file of files)
+	for (const file of files) {
+		console.log(await infoSummary(file))
 		await dropdups(resolve(file), dupFrameNum)
+	}
 }
 
 export async function dropdups(video, dupFrameNum) {
-	await run('ffmpeg', [
-		'-v', 'error',
-		'-stats',
+	await ffmpegWithProgress(video, [
 		'-an',
 		'-i', video,
 		'-vf', dupFrameNum

package/src/edgespic.js

@@ -3,7 +3,7 @@ import { basename, extname, join, parse } from 'node:path'
 import { mkDir } from './utils/fs-utils.js'
 import { videoAttrs } from './utils/videoAttrs.js'
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg } from './utils/subprocess.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const WIDTH = 640
@@ -24,13 +24,13 @@ EXAMPLES
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		width: { short: 'w', type: 'string', default: String(WIDTH) }
 	})
 
 	const width = Number(values.width)
-	if (width <= 0 || !Number.isInteger(width)) throw '--width must be a positive number'
-	if (!files.length) throw 'No video files specified'
+	if (width <= 0 || !Number.isInteger(width)) throw usage('--width must be a positive number')
+	if (!files.length) throw usage('No video files specified')
 
 	const outDir = join(parse(files[0]).dir, 'edgespic')
 	await mkDir(outDir)

package/src/frameseq.js

@@ -2,7 +2,7 @@ import { basename, extname, join, parse } from 'node:path'
 
 import { mkDir } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg } from './utils/subprocess.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 import { countframes } from './countframes.js'
 
 
@@ -28,7 +28,7 @@ EXAMPLES
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		fps: { short: 'f', type: 'string' },
 		start: { short: 's', type: 'string' },
 		end: { short: 'e', type: 'string' },
@@ -37,10 +37,10 @@ export default async function main() {
 
 	const { fps, start, end, outdir } = values
 	const video = files[0]
-	if (!video) throw 'No video files specified'
-	if (fps && isNaN(parseFloat(fps))) throw 'Invalid --fps'
-	if (start && isNaN(parseFloat(start))) throw 'Invalid --start'
-	if (end && isNaN(parseFloat(end))) throw 'Invalid --end'
+	if (!video) throw usage('No video files specified')
+	if (fps && isNaN(parseFloat(fps))) throw usage('Invalid --fps')
+	if (start && isNaN(parseFloat(start))) throw usage('Invalid --start')
+	if (end && isNaN(parseFloat(end))) throw usage('Invalid --end')
 
 	const nFrames = await countframes({ video, fps, start, end })
 	const pad = String(nFrames).length

package/src/gif.js

@@ -19,13 +19,13 @@ OPTIONS
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		fps: { short: 'f', type: 'string', default: String(FPS) },
 		width: { short: 'w', type: 'string', default: String(WIDTH) },
 	})
 
 	if (!files.length)
-		throw 'Missing input file'
+		throw usage('Missing input file')
 
 	await gif(files[0], values.fps, values.width)
 }

package/src/hev1tohvc1.js

@@ -1,7 +1,7 @@
 import { parseOptions } from './utils/parseOptions.js'
 import { uniqueFilenameFor, overwrite } from './utils/fs-utils.js'
-import { ffmpeg } from './utils/subprocess.js'
 import { videoAttrs } from './utils/videoAttrs.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -16,10 +16,10 @@ DESCRIPTION
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP)
+	const { values, files, usage } = await parseOptions(HELP)
 
 	if (!files.length)
-		throw 'Missing input file(s)'
+		throw usage('Missing input file(s)')
 
 	for (const file of files) {
 		await hev1tohvc1(file)

package/src/info.js

@@ -0,0 +1,63 @@
+import { parseOptions } from './utils/parseOptions.js'
+import { videoAttrs } from './utils/videoAttrs.js'
+import { formatSeconds, cleanDecimals } from './utils/formatSeconds.js'
+
+
+const HELP = `
+SYNOPSIS
+  mediasnacks info [-a | --all] <file>
+
+DESCRIPTION
+  Prints all available attributes for the primary video stream from ffprobe.
+
+OPTIONS
+  -a, --all    Prints all attributes as JSON
+`
+
+export default async function main() {
+	const { values, files, usage } = await parseOptions(HELP, {
+		all: { short: 'a', type: 'boolean' }
+	})
+
+	const video = files[0]
+	if (!video) throw usage('No video file specified')
+
+	if (values.all)
+		console.log(JSON.stringify(await videoAttrs(video), '', 2))
+	else
+		console.log(await infoSummary(video))
+}
+
+
+export async function infoSummary(video) {
+	const v = await videoAttrs(video)
+	return [
+		`${v.width}x${v.height}`,
+		`${fps(v.r_frame_rate)}fps`,
+		formatSeconds(v.duration),
+		prettyCodecName(v.codec_name)
+	].join('  ')
+}
+
+function fps(rFrameRate) {
+	const [num, den] = rFrameRate.split('/').map(Number)
+	return cleanDecimals((num / den).toFixed(2))
+}
+
+function prettyCodecName(codec) {
+	// ffmpeg -codecs | grep '^...V'
+	return {
+		'dnxhd': 'DNxHD',
+		'dvvideo': 'DV (Digital Video)',
+		'h264': 'H.264',
+		'hevc': 'H.265',
+		'jpeg2000': 'JPEG 2000',
+		'mpeg4': 'MPEG-4 Part 2',
+		'prores': 'ProRes',
+		'qtrle': 'QuickTime RLE',
+		'rawvideo': 'Uncompressed',
+	}[codec] || codec
+}
+
+
+

package/src/moov2front.js

@@ -1,6 +1,6 @@
-import { ffmpeg } from './utils/subprocess.js'
 import { uniqueFilenameFor, overwrite } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -17,10 +17,10 @@ SEE ALSO
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP)
+	const { values, files, usage } = await parseOptions(HELP)
 
 	if (!files.length)
-		throw 'Missing input file(s)'
+		throw usage('Missing input file(s)')
 
 	for (const file of files) {
 		await moov2front(file)

package/src/openrand.js

@@ -14,12 +14,12 @@ DESCRIPTION
 `
 
 export default async function main() {
-	const { values, positionals } = await parseOptions(HELP, {
+	const { values, positionals, usage } = await parseOptions(HELP, {
 		recursive: { short: 'r', type: 'boolean' },
 	})
 
 	if (process.platform !== 'darwin')
-		throw 'This command is only supported on macOS.'
+		throw usage('This command is only supported on macOS.')
 
 	const dir = positionals[0] || '.'
 	openrand(dir, values.recursive)

package/src/play.js

@@ -17,7 +17,7 @@ EXAMPLE
 
 
 export default async function main() {
-	const { values, positionals } = await parseOptions(HELP, {
+	const { values, positionals, usage } = await parseOptions(HELP, {
 		recursive: { short: 'r', type: 'boolean', default: true },
 	}, { allowNegative: true })
 
@@ -29,7 +29,7 @@ export default async function main() {
 	})
 
 	if (!files.length)
-		throw 'No matching files found.'
+		throw usage('No matching files found.')
 
 	play(files)
 }

package/src/png.js

@@ -14,10 +14,10 @@ EXAMPLE
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP)
+	const { values, files, usage } = await parseOptions(HELP)
 
 	if (!files.length)
-		throw 'Missing input image(s)'
+		throw usage('Missing input image(s)')
 
 	await png(...files)
 }

package/src/prores.js

@@ -1,6 +1,7 @@
 import { resolve, parse, join } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
-import { run } from './utils/subprocess.js'
+import { ffmpegWithProgress } from './utils/ffmpeg.js'
+import { infoSummary } from './info.js'
 
 
 // https://github.com/oyvindln/vhs-decode/wiki/ProRes-The-Definitive-FFmpeg-Guide#profiles-can-be-the-following
@@ -51,30 +52,29 @@ EXAMPLES
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		profile: { short: 'p', type: 'string', default: String(ProresProfiles.default) },
 		start: { short: 's', type: 'string' },
 		end: { short: 'e', type: 'string' },
 	})
 
 	if (!ProresProfiles.isValid(Number(values.profile)))
-		throw 'Invalid profile. Must be one of: ' + ProresProfiles.list().join(',')
+		throw usage('Invalid profile. Must be one of: ' + ProresProfiles.list().join(','))
 
 	if (files.length !== 1)
-		throw 'Expected 1 argument: video file.'
+		throw usage('Expected 1 argument: video file.')
 
 	const video = resolve(files[0])
 	const { name, dir } = parse(video)
 	const output = join(dir, `${name}.prores.mov`)
 
 	const { profile, start, end } = values
+	console.log(await infoSummary(video))
 	await prores({ video, profile, start, end, output })
 }
 
 export async function prores({ video, profile, start, end, output }) {
-	await run('ffmpeg', [
-		'-v', 'error',
-		'-stats',
+	await ffmpegWithProgress(video, [
 		start ? ['-ss', start] : [],
 		end ? ['-to', end] : [],
 		'-i', video,

package/src/resize.js

@@ -3,8 +3,8 @@ import { rename } from 'node:fs/promises'
 
 import { parseOptions } from './utils/parseOptions.js'
 import { isFile, uniqueFilenameFor } from './utils/fs-utils.js'
-import { ffmpeg } from './utils/subprocess.js'
 import { videoAttrs } from './utils/videoAttrs.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -32,7 +32,7 @@ EXAMPLES
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		width: { type: 'string', default: '-2' },
 		height: { type: 'string', default: '-2' },
 		outdir: { type: 'string', default: '' },
@@ -42,8 +42,8 @@ export default async function main() {
 	const width = Number(values.width)
 	const height = Number(values.height)
 
-	if (!files.length) throw 'No video files specified'
-	if (width <= 0 && height <= 0) throw '--width or --height must be > 0'
+	if (!files.length) throw usage('No video files specified')
+	if (width <= 0 && height <= 0) throw usage('--width or --height must be > 0')
 
 	for (const file of files) {
 		await resize({

package/src/sqcrop.js

@@ -1,10 +1,10 @@
 import { join } from 'node:path'
 import { rename } from 'node:fs/promises'
 
-import { ffmpeg } from './utils/subprocess.js'
 import { lstat, uniqueFilenameFor } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
 import { videoAttrs } from './utils/videoAttrs.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -16,13 +16,13 @@ DESCRIPTION
 `
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		outdir: { type: 'string', default: '' },
 		overwrite: { short: 'y', type: 'boolean' },
 	})
 
 	if (!files.length)
-		throw 'No images specified'
+		throw usage('No images specified')
 
 	for (const file of files) {
 		await sqcrop({

package/src/ssim.js

@@ -1,5 +1,5 @@
-import { ffmpeg } from './utils/subprocess.js'
 import { parseOptions } from './utils/parseOptions.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -11,10 +11,10 @@ DESCRIPTION
 `
 
 export default async function main() {
-	const { values, positionals } = await parseOptions(HELP)
+	const { values, positionals, usage } = await parseOptions(HELP)
 
 	if (positionals.length !== 2)
-		throw 'Expected two images'
+		throw usage('Expected two images')
 
 	const score = await ssim(...positionals)
 	console.log(score.toString())

package/src/unemoji.js

@@ -29,12 +29,12 @@ const EMOJI_RE = new RegExp(
 )
 
 export default async function main() {
-	const { values, positionals } = await parseOptions(HELP, {
+	const { values, positionals, usage } = await parseOptions(HELP, {
 		recursive: { short: 'r', type: 'boolean' }
 	})
 
 	if (positionals.length !== 1)
-		throw 'Must pass only one dir'
+		throw usage('Must pass only one dir')
 
 	const files = findFiles({
 		dir: positionals[0],

package/src/utils/ffmpeg.js

@@ -0,0 +1,53 @@
+import { spawn } from 'node:child_process'
+import { printProgress } from './printProgress.js'
+import { videoAttrs } from './videoAttrs.js'
+import { runSilently } from './subprocess.js'
+
+
+async function assertUserHasFFmpeg() {
+	try {
+		await runSilently('ffmpeg', ['-version'])
+		await runSilently('ffprobe', ['-version'])
+	}
+	catch {
+		throw new Error('ffmpeg not found. Please install ffmpeg.')
+	}
+}
+
+
+export async function ffmpeg(args) {
+	await assertUserHasFFmpeg()
+	return runSilently('ffmpeg', args)
+}
+
+
+export async function ffmpegWithProgress(input, args, onProgress = printProgress) {
+	await assertUserHasFFmpeg()
+	const µsVideoDuration = 1e6 * (await videoAttrs(input)).duration
+
+	const p = spawn('ffmpeg', [
+		'-v', 'error',
+		'-nostats',
+		'-progress', 'pipe:1',
+		...args
+	], { stdio: ['inherit', 'pipe', 'pipe'] })
+
+	p.stderr.pipe(process.stderr)
+	p.stdout.on('data', chunk => {
+		const text = chunk.toString()
+		if (text.includes('progress=end'))
+			onProgress(1)
+		else {
+			const m = text.match(/out_time_us=(\d+)/)
+			onProgress(Number(m[1]) / µsVideoDuration)
+		}
+	})
+
+	await new Promise((resolve, reject) => {
+		p.on('error', reject)
+		p.on('close', code => {
+			if (code === 0) resolve()
+			else reject(Error(`ffmpeg failed with code ${code}`))
+		})
+	})
+}

package/src/utils/formatSeconds.js

@@ -0,0 +1,33 @@
+/**
+ * Converts seconds to a string like "9h9m9s".
+ *
+ * Examples:
+ *   formatSeconds(1.1) -> "1.1s"
+ *   formatSeconds(3661, 2) -> "1h1m1s"
+ *   formatSeconds(3661.0, 2) -> "1h1m1s"
+ *   formatSeconds(3661.25, 2) -> "1h1m1.25s"
+ */
+export function formatSeconds(seconds, maxDecimals = 2) {
+	const intSeconds = seconds | 0
+	const partialSeconds = seconds % 60
+	const minutes = (intSeconds % 3600) / 60 | 0
+	const hours = intSeconds / 3600 | 0
+
+	let result = ''
+	if (hours) result += `${hours}h`
+	if (minutes) result += `${minutes}m`
+	if (partialSeconds || !result) result += `${cleanDecimals(partialSeconds.toFixed(maxDecimals))}s`
+	return result
+}
+
+
+/**
+ * Removes trailing zeros and a trailing decimal point.
+ *
+ * Examples:
+ *   cleanDecimals(3.1400) -> "3.14"
+ *   cleanDecimals(5.0) -> "5"
+ */
+export function cleanDecimals(number) {
+	return String(number).replace(/\.?0+$/, '') || '0'
+}

package/src/utils/parseOptions.js

@@ -1,4 +1,4 @@
-import { promisify, parseArgs } from 'node:util'
+import { promisify, parseArgs, styleText } from 'node:util'
 import { glob as _glob } from 'node:fs'
 
 const glob = promisify(_glob)
@@ -28,7 +28,10 @@ export async function parseOptions(helpText, options = {}, config = {}) {
 	return {
 		values,
 		positionals,
-		files: await resolveGlobs(positionals, tokens)
+		files: await resolveGlobs(positionals, tokens),
+		usage: err => err
+			? styleText('redBright', '' + err + '\n') + helpText
+			: helpText
 	}
 }
 

package/src/utils/printProgress.js

@@ -0,0 +1,14 @@
+export function printProgress(progress) {
+	process.stdout.write(`\r${progressBar(progress)} ${(progress * 100).toFixed(1)}%`)
+	if (progress === 1)
+		process.stdout.write('\n')
+}
+
+function progressBar(progress, width = 42) {
+	const nFull = (width * progress) | 0
+	const fPartial = (width * progress) - nFull
+	const nRemaining = width - nFull
+	const partials = ' ▏▎▍▌▋▊▉'
+	const partial = partials[Math.min(partials.length * fPartial | 0, partials.length - 1)]
+	return '█'.repeat(nFull) + partial + '⠂'.repeat(nRemaining)
+}

package/src/utils/subprocess.js

@@ -1,21 +1,6 @@
 import { spawn } from 'node:child_process'
 
 
-async function assertUserHasFFmpeg() {
-	try {
-		await runSilently('ffmpeg', ['-version'])
-		await runSilently('ffprobe', ['-version'])
-	}
-	catch {
-		throw new Error('ffmpeg not found. Please install ffmpeg.')
-	}
-}
-
-export async function ffmpeg(args) {
-	await assertUserHasFFmpeg()
-	return runSilently('ffmpeg', args)
-}
-
 export async function runSilently(program, args) {
 	return new Promise((resolve, reject) => {
 		const stdout = []
@@ -38,6 +23,7 @@ export async function runSilently(program, args) {
 	})
 }
 
+
 export async function run(program, args) {
 	return new Promise((resolve, reject) => {
 		const p = spawn(program, args, { stdio: ['inherit', 'pipe', 'pipe'] })

package/src/vsplit.js

@@ -35,10 +35,10 @@ SEE ALSO
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP)
+	const { values, files, usage } = await parseOptions(HELP)
 
 	if (files.length !== 2)
-		throw 'Expected 2 arguments: CSV file and video file.'
+		throw usage('Expected 2 arguments: CSV file and video file.')
 
 	const [csvPath, videoPath] = files.map(f => resolve(f))
 

package/src/vtrim.js

@@ -1,6 +1,6 @@
 import { resolve, parse } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg } from './utils/subprocess.js'
+import { ffmpeg } from './utils/ffmpeg.js'
 
 
 const HELP = `
@@ -20,13 +20,13 @@ SEE ALSO
 
 
 export default async function main() {
-	const { values, files } = await parseOptions(HELP, {
+	const { values, files, usage } = await parseOptions(HELP, {
 		start: { short: 's', type: 'string' },
 		end: { short: 'e', type: 'string' },
 	})
 
 	if (!files.length)
-		throw 'No video specified.'
+		throw usage('No video specified.')
 
 	for (const file of files)
 		await vtrim({