mediasnacks 0.25.0 → 0.26.0

package/README.md

@@ -47,7 +47,7 @@ mediasnacks <command> <args>
 - `flattendir`: Moves unique files to the top dir and deletes empty dirs
 - `qdir` Sequentially runs all *.sh files in a folder
 - `seqcheck` Finds missing sequence number
-- `random` Opens a random file
+- `openrand` Opens a random file
 - `play` Plays filtered playlist with mpv
 
 

package/index.js

@@ -0,0 +1,18 @@
+export { avif } from './src/avif.js'
+export { countframes } from './src/countframes.js'
+export { detectdups } from './src/detectdups.js'
+export { dropdups } from './src/dropdups.js'
+export { edgespic } from './src/edgespic.js'
+export { frameseq } from './src/frameseq.js'
+export { hev1tohvc1 } from './src/hev1tohvc1.js'
+export { moov2front } from './src/moov2front.js'
+export { play } from './src/play.js'
+export { prores } from './src/prores.js'
+export { qdir } from './src/qdir.js'
+export { openrand, pickRandomFile } from './src/openrand.js'
+export { resize } from './src/resize.js'
+export { seqcheck } from './src/seqcheck.js'
+export { sqcrop } from './src/sqcrop.js'
+export { ssim } from './src/ssim.js'
+export { vsplit } from './src/vsplit.js'
+export { vtrim } from './src/vtrim.js'

package/package.json

@@ -1,10 +1,10 @@
 {
-  "name": "mediasnacks",
-  "version": "0.25.0",
-  "description": "Utilities for optimizing and preparing videos and images",
-  "license": "MIT",
-  "author": "Eric Fortis",
-  "type": "module",
+	"name": "mediasnacks",
+	"version": "0.26.0",
+	"description": "Utilities for optimizing and preparing videos and images",
+	"license": "MIT",
+	"author": "Eric Fortis",
+	"type": "module",
 	"bin": {
 		"mediasnacks": "src/cli.js"
 	},
@@ -14,8 +14,16 @@
 		"postinstall": "node install-zsh-completions.js",
 		"dev-install": "npm i -g . --ignore-scripts=false"
 	},
+	"exports": {
+		".": {
+			"import": "./index.js",
+			"types": "./index.d.ts"
+		}
+	},
 	"files": [
 		"src",
+		"index.js",
+		"index.d.js",
 		"install-zsh-completions.js"
 	]
 }

package/src/avif.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { join, basename, dirname } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
 import { replaceExt, lstat } from './utils/fs-utils.js'
@@ -7,22 +6,22 @@ import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 
 const HELP = `
 SYNOPSIS
-  mediasnacks avif [-y | --overwrite] [--output-dir=<dir>] <images> 
+  mediasnacks avif [-y | --overwrite] [--outdir=<dir>] <images> 
 
 DESCRIPTION
  Converts images to AVIF.
 
 EXAMPLES
   mediasnacks avif -y '*.png'
-  mediasnacks avif --output-dir=foo/ 'a/**/*.png'
+  mediasnacks avif --outdir=foo/ 'a/**/*.png'
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
-		'output-dir': { type: 'string', default: '' },
+		outdir: { type: 'string', default: '' },
 		overwrite: { short: 'y', type: 'boolean' },
 		help: { short: 'h', type: 'boolean' },
 	})
@@ -37,27 +36,24 @@ async function main() {
 
 	console.log('AVIF…')
 	for (const file of files)
-		await avif({
-			file,
-			outFile: join(values['output-dir'] || dirname(file), replaceExt(basename(file), 'avif')),
-			overwrite: values.overwrite
-		})
+		try {
+			await avif({
+				file,
+				outFile: join(values.outdir || dirname(file), replaceExt(basename(file), 'avif')),
+				overwrite: values.overwrite
+			})
+			console.log(file)
+		}
+		catch (err) {
+			console.error(err?.message || err)
+		}
 }
 
-async function avif({ file, outFile, overwrite }) {
+export async function avif({ file, outFile, overwrite = false }) {
 	const stAvif = lstat(outFile)
+	if (!overwrite && stAvif?.isFile()) throw new Error(`output file exists but --overwrite=false. ${file}`)
+	if (stAvif?.mtimeMs > lstat(file)?.mtimeMs) throw new Error(`avif is newer. ${file}`)
 
-	if (!overwrite && stAvif?.isFile()) {
-		console.log('(skipped: output file exists but --overwrite=false)', file)
-		return
-	}
-	if (stAvif?.mtimeMs > lstat(file)?.mtimeMs) {
-		console.log('(skipped: avif is newer)', file)
-		return
-	}
-
-	// TODO fix transparent PNGs
-	console.log(file)
 	await ffmpeg([
 		'-y',
 		'-i', file,
@@ -66,8 +62,3 @@ async function avif({ file, outFile, overwrite }) {
 		outFile
 	])
 }
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/cli.js

@@ -1,45 +1,45 @@
 #!/usr/bin/env node
 
 import { join } from 'node:path'
-import { styleText } from 'node:util'
 import { spawn } from 'node:child_process'
+import { styleText } from 'node:util'
 import pkgJSON from '../package.json' with { type: 'json' }
 
 
 const COMMANDS = {
-	avif: ['avif.js', 'Converts images to AVIF'],
-	png: ['png.sh', 'Optimizes PNG images with oxipng'],
-	sqcrop: ['sqcrop.js', 'Square crops images\n'],
-
-	resize: ['resize.js', 'Resizes videos or images'],
-	edgespic: ['edgespic.js', 'Extracts first and last frames'],
-	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.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 on macOS Finder'],
-	moov2front: ['moov2front.js', 'Rearranges .mov and .mp4 metadata for fast-start streaming'],
-	vconcat: ['vconcat.sh', 'Concatenates videos'],
-	vdiff: ['vdiff.sh', 'Plays a video with the difference of two videos'],
-	vsplit: ['vsplit.js', 'Splits a video into multiple clips from CSV timestamps'],
-	vtrim: ['vtrim.js', 'Trims video from start to end time'],
-	prores: ['prores.js', 'Converts video to ProRes\n'],
-
-	flattendir: ['flattendir.sh', 'Moves all files to top dir and deletes dirs'],
-	qdir: ['qdir.js', 'Sequentially runs all *.sh files in a folder'],
-	seqcheck: ['seqcheck.js', 'Finds missing sequence number'],
-	random: ['random.js', 'Opens a random file (macOS only)'],
-	play: ['play.js', 'Plays filtered playlist with mpv\n'],
-
-	dlaudio: ['dlaudio.sh', 'yt-dlp best audio'],
-	dlvideo: ['dlvideo.sh', 'yt-dlp best video\n'],
-
-	unemoji: ['unemoji.sh', 'Removes emojis from filenames'],
-	rmcover: ['rmcover.sh', 'Removes cover art'],
+	avif: ['./avif.js', 'Converts images to AVIF'],
+	png: ['./png.sh', 'Optimizes PNG images with oxipng'],
+	sqcrop: ['./sqcrop.js', 'Square crops images\n'],
+
+	resize: ['./resize.js', 'Resizes videos or images'],
+	edgespic: ['./edgespic.js', 'Extracts first and last frames'],
+	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.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 on macOS Finder'],
+	moov2front: ['./moov2front.js', 'Rearranges .mov and .mp4 metadata for fast-start streaming'],
+	vconcat: ['./vconcat.sh', 'Concatenates videos'],
+	vdiff: ['./vdiff.sh', 'Plays a video with the difference of two videos'],
+	vsplit: ['./vsplit.js', 'Splits a video into multiple clips from CSV timestamps'],
+	vtrim: ['./vtrim.js', 'Trims video from start to end time'],
+	prores: ['./prores.js', 'Converts video to ProRes\n'],
+
+	flattendir: ['./flattendir.sh', 'Moves all files to top dir and deletes dirs'],
+	qdir: ['./qdir.js', 'Sequentially runs all *.sh files in a folder'],
+	seqcheck: ['./seqcheck.js', 'Finds missing sequence number'],
+	openrand: ['./openrand.js', 'Opens a random file (macOS only)'],
+	play: ['./play.js', 'Plays filtered playlist with mpv\n'],
+
+	dlaudio: ['./dlaudio.sh', 'yt-dlp best audio'],
+	dlvideo: ['./dlvideo.sh', 'yt-dlp best video\n'],
+
+	unemoji: ['./unemoji.sh', 'Removes emojis from filenames'],
+	rmcover: ['./rmcover.sh', 'Removes cover art'],
 }
 
 export function commandsSummary() {
@@ -57,7 +57,7 @@ ${commandsSummary().map(([cmd, desc]) =>
 `.trim()
 
 
-function main() {
+async function main() {
 	const [, , opt, ...args] = process.argv
 
 	if (opt === '-v' || opt === '--version') {
@@ -78,10 +78,16 @@ function main() {
 		process.exit(1)
 	}
 
-	const cmd = join(import.meta.dirname, COMMANDS[opt][0])
-	spawn(cmd, args, { stdio: 'inherit' })
-		.on('exit', process.exit)
+	const cmd = COMMANDS[opt][0]
+	if (cmd.endsWith('.js'))
+		(await import(cmd)).default()
+	else
+		spawn(join(import.meta.dirname, cmd), args, { stdio: 'inherit' })
+			.on('exit', process.exit)
 }
 
 if (import.meta.main)
-	main()
+	main().catch(err => {
+		console.error(err?.message || err)
+		process.exit(1)
+	})

package/src/countframes.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { parseOptions } from './utils/parseOptions.js'
 import { assertUserHasFFmpeg } from './utils/subprocess.js'
 import { videoAttrs } from './utils/videoAttrs.js'
@@ -24,7 +22,7 @@ EXAMPLES
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -40,16 +38,16 @@ async function main() {
 	}
 
 	const { fps, start, end } = values
-	const file = files[0]
-	if (!file) throw new Error('No video file specified')
+	const video = files[0]
+	if (!video) throw new Error('No video file specified')
 
-	const n = await countframes(file, fps, start, end)
+	const n = await countframes({ video, fps, start, end })
 	console.log(String(n))
 }
 
 
-export async function countframes(file, fps, start, end) {
-	const v = await videoAttrs(file)
+export async function countframes({ video, fps, start, end }) {
+	const v = await videoAttrs(video)
 	const videoDuration = parseFloat(v.duration || 0)
 	const startSecs = start ? parseTimecode(start) : 0
 	const endSecs = end ? parseTimecode(end) : videoDuration
@@ -57,10 +55,3 @@ export async function countframes(file, fps, start, end) {
 	const actualFps = fps ? Number(fps) : eval(v.r_frame_rate)
 	return Math.ceil(durationLimit * actualFps)
 }
-
-
-if (import.meta.main)
-	main().catch(err => {
-		console.error(err.message)
-		process.exit(1)
-	})

package/src/detectdups.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { parseOptions } from './utils/parseOptions.js'
 import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 import { videoAttrs } from './utils/videoAttrs.js'
@@ -31,7 +29,7 @@ SEE ALSO
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -45,13 +43,11 @@ async function main() {
 		return
 	}
 
-	if (files.length !== 1)
-		throw new Error('Invalid input file. One video file must be specified. See mediasnacks detectdups --help')
-
-	const v = await videoAttrs(files[0])
+	if (files.length !== 1) throw new Error('Invalid input file. One video file must be specified. See mediasnacks detectdups --help')
 
-	if (v.codec_type !== 'video')
-		throw new Error('Invalid input file. Must be a video.')
+	const video = files[0]
+	const v = await videoAttrs(video)
+	if (v.codec_type !== 'video') throw new Error('Invalid input file. Must be a video.')
 
 	const vDur = Number(v.duration)
 
@@ -67,7 +63,7 @@ async function main() {
 	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 dups = await detectdups(files[0], seek, duration)
+	const dups = await detectdups({ video: files[0], seek, duration })
 	const h = deltaHistogram(dups)
 	const report = {
 		n: maxFreqKey(h),
@@ -80,12 +76,12 @@ async function main() {
 	console.log(JSON.stringify(report, null, 2))
 }
 
-export async function detectdups(video, seek, duration) {
+export async function detectdups({ video, seek, duration }) {
 	const { stderr } = await ffmpeg([
 		'-v', 'info',
 		'-stats',
-		'-ss', seek,
-		'-t', duration,
+		seek ? ['-ss', seek] : [],
+		duration ? ['-t', duration] : [],
 		'-i', video,
 		'-vf', [
 			'tblend=all_mode=difference',
@@ -93,7 +89,7 @@ export async function detectdups(video, seek, duration) {
 			'showinfo',
 		].join(','),
 		'-f', 'null', '-',
-	])
+	].flat())
 
 	const reNearBlackFrames = /n:\s*(\d+).*?mean:\[0].*?stdev:\[([0-9.]+)]/
 	const dupFrames = []
@@ -133,10 +129,3 @@ function maxFreqKey(histogram) {
 		? Number(maxKey)
 		: null
 }
-
-
-if (import.meta.main)
-	main().catch(err => {
-		console.error(err.message || err)
-		process.exit(1)
-	})

package/src/dropdups.js

@@ -1,7 +1,4 @@
-#!/usr/bin/env node
-
 import { resolve, parse, format } from 'node:path'
-
 import { parseOptions } from './utils/parseOptions.js'
 import { ffmpeg, assertUserHasFFmpeg, run } from './utils/subprocess.js'
 import { ProresProfiles } from './prores.js'
@@ -30,7 +27,7 @@ EXAMPLES
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -55,7 +52,7 @@ async function main() {
 		await dropdups(resolve(file), dupFrameNum)
 }
 
-async function dropdups(video, dupFrameNum) {
+export async function dropdups(video, dupFrameNum) {
 	await run('ffmpeg', [
 		'-v', 'error',
 		'-stats',
@@ -77,8 +74,3 @@ function makeOutputPath(video) {
 		? format({ dir, name: `${name}.dedup`, ext: '.mov' })
 		: format({ dir, name, ext: '.mov' })
 }
-
-main().catch(err => {
-	console.error(err.message || err)
-	process.exit(1)
-})

package/src/edgespic.js

@@ -1,11 +1,9 @@
-#!/usr/bin/env node
-
 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, assertUserHasFFmpeg } from './utils/subprocess.js'
-import { videoAttrs } from './utils/videoAttrs.js'
 
 
 const HELP = `
@@ -24,7 +22,7 @@ EXAMPLES
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -38,14 +36,11 @@ async function main() {
 	}
 
 	const width = Number(values['width'])
-	if (width <= 0 || !Number.isInteger(width))
-		throw new Error('--width must be a positive number')
-
-	if (!files.length)
-		throw new Error('No video files specified')
+	if (width <= 0 || !Number.isInteger(width)) throw new Error('--width must be a positive number')
+	if (!files.length) throw new Error('No video files specified')
 
 	const outDir = join(parse(files[0]).dir, 'edgespic')
-	await mkDir(outDir) 
+	await mkDir(outDir)
 
 	console.log('Extracting edge frames…')
 	for (const file of files)
@@ -53,7 +48,7 @@ async function main() {
 }
 
 
-async function edgespic(video, width, outDir) {
+export async function edgespic(video, width, outDir) {
 	const { r_frame_rate } = await videoAttrs(video)
 	const name = basename(video, extname(video))
 
@@ -74,9 +69,3 @@ async function edgespic(video, width, outDir) {
 		join(outDir, `${name}_last.png`)
 	])
 }
-
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/frameseq.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { basename, extname, join, parse } from 'node:path'
 
 import { mkDir } from './utils/fs-utils.js'
@@ -29,13 +27,14 @@ EXAMPLES
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
-		fps: { type: 'string', default: '' },
+		fps: { short: 'f', type: 'string', default: '' },
 		start: { short: 's', type: 'string', default: '' },
 		end: { short: 'e', type: 'string', default: '' },
+		outdir: { type: 'string', default: '' },
 		help: { short: 'h', type: 'boolean' }
 	})
 
@@ -44,21 +43,21 @@ async function main() {
 		return
 	}
 
-	const { fps, start, end } = values
-	const file = files[0]
-	if (!file) throw new Error('No video files specified')
+	const { fps, start, end, outdir } = values
+	const video = files[0]
+	if (!video) throw new Error('No video files specified')
 	if (fps && isNaN(parseFloat(fps))) throw new Error('Invalid --fps')
 	if (start && isNaN(parseFloat(start))) throw new Error('Invalid --start')
 	if (end && isNaN(parseFloat(end))) throw new Error('Invalid --end')
 
-	const nFrames = await countframes(file, fps, start, end)
+	const nFrames = await countframes({ video, fps, start, end })
 	const pad = String(nFrames).length
-	await frameseq(file, fps, start, end, pad)
+	await frameseq({ video, fps, start, end, pad, outdir })
 }
 
-async function frameseq(video, fps, start, end, pad) {
+export async function frameseq({ video, fps, start, end, pad, outdir }) {
 	const name = basename(video, extname(video))
-	const outDir = join(parse(video).dir, name)
+	const outDir = outdir || join(parse(video).dir, name)
 	await mkDir(outDir)
 	await ffmpeg([
 		start ? ['-ss', start] : [],
@@ -68,8 +67,3 @@ async function frameseq(video, fps, start, end, pad) {
 		join(outDir, `${name}_%0${pad}d.png`)
 	].flat())
 }
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/hev1tohvc1.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { parseOptions } from './utils/parseOptions.js'
 import { uniqueFilenameFor, overwrite } from './utils/fs-utils.js'
 import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
@@ -17,7 +15,7 @@ DESCRIPTION
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -29,21 +27,22 @@ async function main() {
 		return
 	}
 
-	if (!files.length)
-		throw new Error(HELP)
+	if (!files.length) throw new Error('Missing input file(s)')
 
 	for (const file of files)
-		await hev1tohvc1(file)
+		try {
+			await hev1tohvc1(file)
+			console.log(file)
+		}
+		catch (err) {
+			console.error(err?.message || err)
+		}
 }
 
-async function hev1tohvc1(file) {
+export async function hev1tohvc1(file) {
 	const v = await videoAttrs(file)
-	if (v.codec_tag_string !== 'hev1') {
-		console.log('(skipped: non hev1)', file)
-		return
-	}
+	if (v.codec_tag_string !== 'hev1') throw new Error(`non hev1 ${file}`)
 
-	console.log(file)
 	const tmp = uniqueFilenameFor(file)
 	await ffmpeg([
 		'-i', file,
@@ -53,9 +52,3 @@ async function hev1tohvc1(file) {
 	])
 	await overwrite(tmp, file)
 }
-
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/moov2front.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 import { uniqueFilenameFor, overwrite } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
@@ -20,7 +19,7 @@ NOTES
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -32,25 +31,23 @@ async function main() {
 		return
 	}
 
-	if (!files.length)
-		throw new Error(HELP)
+	if (!files.length) throw new Error('Missing input file(s)')
 
 	console.log('Optimizing video for progressive download…')
 	for (const file of files)
-		await moov2front(file)
+		try {
+			await moov2front(file)
+			console.log(file)
+		}
+		catch (err) {
+			console.error(err?.message || err)
+		}
 }
 
-async function moov2front(file) {
-	if (!/\.(mp4|mov)$/i.test(file)) {
-		console.log('(skipped: not mp4/mov)', file)
-		return
-	}
-	if (await moovIsBeforeMdat(file)) {
-		console.log('(skipped: no changes needed)', file)
-		return
-	}
+export async function moov2front(file) {
+	if (!/\.(mp4|mov)$/i.test(file)) throw new Error(`not mp4/mov. ${file}`)
+	if (await moovIsBeforeMdat(file)) throw new Error(`no changes needed. ${file}`)
 
-	console.log(file)
 	const tmp = uniqueFilenameFor(file)
 	await ffmpeg([
 		'-hide_banner',
@@ -71,9 +68,3 @@ async function moovIsBeforeMdat(file) {
 	const firstMatchedAtom = stderr.match(/type:'(moov|mdat)'/)?.[1]
 	return firstMatchedAtom === 'moov'
 }
-
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/{random.js → openrand.js}

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { join } from 'node:path'
 import { spawn } from 'node:child_process'
 import { readdirSync } from 'node:fs'
@@ -7,13 +6,13 @@ import { parseOptions } from './utils/parseOptions.js'
 
 const HELP = `
 SYNOPSIS
-  mediasnacks random [-r | --recursive]
+  mediasnacks openrand [-r | --recursive]
 
 DESCRIPTION
   Opens a random file in the current working directory
 `.trim()
 
-async function main() {
+export default async function main() {
 	if (process.platform !== 'darwin')
 		throw new Error('Error: This command is only supported on macOS.')
 
@@ -27,17 +26,16 @@ async function main() {
 		return
 	}
 
-	spawn('open', [pickRandomFile('.', values.recursive)])
+	openrand('.', values.recursive)
 }
 
-function pickRandomFile(dir, recursive) {
+export function openrand(dir = '.', recursive = false) {
+	spawn('open', [pickRandomFile(dir, recursive)])
+}
+
+export function pickRandomFile(dir = '.', recursive = false) {
 	const files = readdirSync(dir, { withFileTypes: true, recursive })
 		.filter(entry => !entry.name.startsWith('.') && entry.isFile())
 		.map(entry => join(entry.parentPath, entry.name))
 	return files[Math.floor(Math.random() * files.length)]
 }
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/play.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { spawn } from 'node:child_process'
 import { parseOptions } from './utils/parseOptions.js'
 import { findFiles } from './utils/fs-utils.js'
@@ -17,7 +16,7 @@ EXAMPLE
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	const { values, positionals } = await parseOptions({
 		recursive: { short: 'r', type: 'boolean', default: true },
 		help: { short: 'h', type: 'boolean' }
@@ -41,7 +40,7 @@ async function main() {
 	play(files)
 }
 
-function play(files) {
+export function play(files) {
 	const mpv = spawn('mpv', ['--playlist=-'], {
 		detached: true,
 		stdio: ['pipe', 'ignore', 'ignore']
@@ -57,8 +56,3 @@ function play(files) {
 		process.exit(1)
 	})
 }
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/prores.js

@@ -1,10 +1,9 @@
-#!/usr/bin/env node
 import { resolve, parse, join } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
 import { assertUserHasFFmpeg, run } from './utils/subprocess.js'
 
 export const ProresProfiles = new class {
-  // https://github.com/oyvindln/vhs-decode/wiki/ProRes-The-Definitive-FFmpeg-Guide#profiles-can-be-the-following
+	// https://github.com/oyvindln/vhs-decode/wiki/ProRes-The-Definitive-FFmpeg-Guide#profiles-can-be-the-following
 	profiles = {
 		// 10-bit color depth
 		0: '422 Proxy',
@@ -50,7 +49,7 @@ EXAMPLES
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -75,10 +74,11 @@ async function main() {
 	const { name, dir } = parse(video)
 	const output = join(dir, `${name}.prores.mov`)
 
-	await prores(video, values.start, values.end, values.profile, output)
+	const { profile, start, end } = values
+	await prores({ video, profile, start, end, output })
 }
 
-async function prores(video, start, end, profile, output) {
+export async function prores({ video, profile, start, end, output }) {
 	await run('ffmpeg', [
 		'-v', 'error',
 		'-stats',
@@ -89,9 +89,3 @@ async function prores(video, start, end, profile, output) {
 		output
 	].flat())
 }
-
-if (import.meta.main)
-	main().catch(err => {
-		console.error(err.message || err)
-		process.exit(1)
-	})

package/src/qdir.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { join } from 'node:path'
 import { spawn } from 'node:child_process'
 import { readdir, writeFile, unlink, rename } from 'node:fs/promises'
@@ -30,7 +28,7 @@ function newExt(exitCode) {
 }
 
 
-async function main() {
+export default async function main() {
 	const { values, positionals } = await parseOptions({
 		help: { short: 'h', type: 'boolean' }
 	})
@@ -98,10 +96,3 @@ async function runShell(scriptPath) {
 function sleep(ms) {
 	return new Promise(resolve => setTimeout(resolve, ms))
 }
-
-
-if (import.meta.main)
-	main().catch(err => {
-		console.error(err.message || err)
-		process.exit(1)
-	})

package/src/resize.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { join } from 'node:path'
 import { rename } from 'node:fs/promises'
 
@@ -10,7 +9,7 @@ import { videoAttrs } from './utils/videoAttrs.js'
 
 const HELP = `
 SYNOPSIS
-  mediasnacks resize [--width=<num>] [--height=<num>] [-y | --overwrite] [--output-dir=<dir>] <files>
+  mediasnacks resize [--width=<num>] [--height=<num>] [-y | --overwrite] [--outdir=<dir>] <files>
 
 DESCRIPTION
   Resizes videos and images. The aspect ratio is preserved when only one dimension is specified.
@@ -20,7 +19,7 @@ EXAMPLES
     mediasnacks resize -y --width 480 'dir-a/**/*.png' 'dir-b/**/*.mp4'
 
   Output directory (-o)
-    mediasnacks resize --height 240 --output-dir /tmp/out video.mov
+    mediasnacks resize --height 240 --outdir /tmp/out video.mov
    
 OPTIONS
 	--width and --height are -2 by default:
@@ -29,13 +28,13 @@ OPTIONS
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
 		width: { type: 'string', default: '-2' },
 		height: { type: 'string', default: '-2' },
-		'output-dir': { type: 'string', default: '' },
+		outdir: { type: 'string', default: '' },
 		overwrite: { short: 'y', type: 'boolean' },
 		help: { short: 'h', type: 'boolean' },
 	})
@@ -57,31 +56,33 @@ async function main() {
 
 	console.log('Resizing…')
 	for (const file of files)
-		await resize({
-			file,
-			outFile: join(values['output-dir'], file), // TODO basename ?
-			overwrite: values.overwrite,
-			width,
-			height,
-		})
+		try {
+			await resize({
+				file,
+				outFile: join(values.outdir, file), // TODO basename ?
+				overwrite: values.overwrite,
+				width,
+				height,
+			})
+			console.log(file)
+		}
+		catch (err) {
+			console.error(err?.message || err)
+		}
 }
 
 
-async function resize({ file, outFile, overwrite, width, height }) {
+export async function resize({ file, outFile, overwrite, width, height }) {
 	const v = await videoAttrs(file)
 	if (width === v.width && height === v.height
 		|| width < 0 && height === v.height
-		|| height < 0 && width === v.width) {
-		console.log('(skipped: no changes needed)', file)
-		return
-	}
+		|| height < 0 && width === v.width
+	)
+		throw new Error(`no changes needed. ${file}`)
 
-	if (!overwrite && isFile(outFile)) {
-		console.log('(skipped: output file exists but --overwrite=false)', file)
-		return
-	}
+	if (!overwrite && isFile(outFile))
+		throw new Error(`output file exists but --overwrite=false. ${file}`)
 
-	console.log(file)
 	const tmp = uniqueFilenameFor(file)
 	await ffmpeg([
 		'-i', file,
@@ -91,9 +92,3 @@ async function resize({ file, outFile, overwrite, width, height }) {
 	])
 	await rename(tmp, outFile)
 }
-
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/seqcheck.js

@@ -1,7 +1,8 @@
-#!/usr/bin/env node
 import { parseArgs } from 'node:util'
 import { readdirSync } from 'node:fs'
 
+const LEFT_DELIM = '_'
+const RIGHT_DELIM = '.'
 
 const HELP = `
 SYNOPSIS
@@ -11,17 +12,17 @@ DESCRIPTION
   Find missing numbered files in a sequence.
 
 OPTIONS
-  -ld, --left-delimiter <str>   Delimiter before the number (default: "_")
-  -rd, --right-delimiter <str>  Delimiter after the number (default: ".")
+  -ld, --left-delimiter <str>   Delimiter before the number (default: "${LEFT_DELIM}")
+  -rd, --right-delimiter <str>  Delimiter after the number (default: "${RIGHT_DELIM}")
   -h,  --help
 `.trim()
 
 
-function main() {
+export default function main() {
 	const { values, positionals } = parseArgs({
 		options: {
-			'left-delimiter': { type: 'string', default: '_' },
-			'right-delimiter': { type: 'string', default: '.' },
+			'left-delimiter': { type: 'string', default: LEFT_DELIM },
+			'right-delimiter': { type: 'string', default: RIGHT_DELIM },
 			help: { short: 'h', type: 'boolean' },
 		},
 		allowPositionals: true,
@@ -32,18 +33,19 @@ function main() {
 		return
 	}
 
-	const seq = extractSeqNums(
-		readdirSync(positionals[0] || process.cwd()),
-		values['left-delimiter'],
-		values['right-delimiter'])
-
-	const missing = findMissingNumbers(seq)
+	const dir = positionals[0] || process.cwd()
+	const missing = seqcheck(dir, values['left-delimiter'], values['right-delimiter'])
 	if (missing.length)
 		console.log('Missing:', missing)
 }
 
-export function extractSeqNums(names, leftDelimiter, rightDelimiter) {
-	const pattern = new RegExp(escapeRegex(leftDelimiter) + '(\\d+)' + escapeRegex(rightDelimiter))
+export function seqcheck(dir, leftDelim = LEFT_DELIM, rightDelim = RIGHT_DELIM) {
+	const seq = extractSeqNums(readdirSync(dir), leftDelim, rightDelim)
+	return findMissingNumbers(seq)
+}
+
+export function extractSeqNums(names, leftDelim, rightDelim) {
+	const pattern = new RegExp(escapeRegex(leftDelim) + '(\\d+)' + escapeRegex(rightDelim))
 	const seq = []
 	for (const name of names) {
 		const match = name.match(pattern)
@@ -66,7 +68,3 @@ export function findMissingNumbers(seq) {
 function escapeRegex(str) {
 	return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
 }
-
-
-if (import.meta.main)
-	main()

package/src/sqcrop.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 import { join } from 'node:path'
 import { rename } from 'node:fs/promises'
 
@@ -10,18 +8,18 @@ import { parseOptions } from './utils/parseOptions.js'
 
 const HELP = `
 SYNOPSIS
-  mediasnacks sqcrop [-y | --overwrite] [--output-dir=<dir>] <images> 
+  mediasnacks sqcrop [-y | --overwrite] [--outdir=<dir>] <images> 
 
 DESCRIPTION
   Square crops images
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
-		'output-dir': { type: 'string', default: '' },
+		outdir: { type: 'string', default: '' },
 		overwrite: { short: 'y', type: 'boolean' },
 		help: { short: 'h', type: 'boolean' },
 	})
@@ -36,26 +34,25 @@ async function main() {
 
 	console.log('Cropping…')
 	for (const file of files)
-		await sqcrop({
-			file,
-			outFile: join(values['output-dir'], file),
-			overwrite: values.overwrite
-		})
+		try {
+			await sqcrop({
+				file,
+				outFile: join(values.outdir, file),
+				overwrite: values.overwrite
+			})
+			console.log(file)
+		}
+		catch (err) {
+			console.error(err?.message || err)
+		}
 }
 
-async function sqcrop({ file, outFile, overwrite }) {
+export async function sqcrop({ file, outFile, overwrite }) {
 	const stOut = lstat(outFile)
 
-	if (!overwrite && stOut?.isFile()) {
-		console.log('(skipped: output file exists but --overwrite=false)', file)
-		return
-	}
-	if (stOut?.mtimeMs > lstat(file)?.mtimeMs) {
-		console.log('(skipped: outputFile is newer)', file)
-		return
-	}
+	if (!overwrite && stOut?.isFile()) throw new Error(`output file exists but --overwrite=false. ${file}`)
+	if (stOut?.mtimeMs > lstat(file)?.mtimeMs) throw new Error(`outputFile is newer. ${file}`)
 
-	console.log(file)
 	const tmp = uniqueFilenameFor(file)
 	await ffmpeg([
 		'-v', 'error',
@@ -66,8 +63,3 @@ async function sqcrop({ file, outFile, overwrite }) {
 	])
 	await rename(tmp, outFile)
 }
-
-main().catch(err => {
-	console.error(err.message)
-	process.exit(1)
-})

package/src/ssim.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { ffmpeg } from './utils/subprocess.js'
 import { parseOptions } from './utils/parseOptions.js'
 
@@ -12,7 +11,7 @@ DESCRIPTION
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	const { values, positionals } = await parseOptions({
 		help: { short: 'h', type: 'boolean' }
 	})
@@ -41,10 +40,3 @@ export async function ssim(img1, img2) {
 		throw new Error(`Could not parse SSIM output:\n${stderr}`)
 	return parseFloat(match[1])
 }
-
-
-if (import.meta.main)
-	main().catch(err => {
-		console.error(err.message)
-		process.exit(1)
-	})

package/src/utils/parseOptions.js

@@ -6,6 +6,7 @@ const glob = promisify(_glob)
 
 export async function parseOptions(options = {}, config = {}) {
 	const { values, positionals, tokens } = parseArgs({
+		args: process.argv.slice(3),
 		allowPositionals: true,
 		options,
 		...config,

package/src/vsplit.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { readFileSync } from 'node:fs'
 import { resolve, parse, join } from 'node:path'
 
@@ -35,7 +34,7 @@ SEE ALSO
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -79,7 +78,7 @@ function parseCSV(csvPath) {
 	return clips
 }
 
-async function vsplit(videoPath, clips) {
+export async function vsplit(videoPath, clips) {
 	const { dir, name, ext } = parse(videoPath)
 	const seqLen = Math.log10(clips.length) + 1 | 0
 
@@ -97,8 +96,3 @@ async function vsplit(videoPath, clips) {
 		])
 	}
 }
-
-main().catch(err => {
-	console.error(err.message || err)
-	process.exit(1)
-})

package/src/vtrim.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { resolve, parse } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
 import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
@@ -14,14 +13,13 @@ DESCRIPTION
 OPTIONS
   -s, --start <time>   Start time (e.g. 10, 00:00:10, 1:23.5). Default: beginning.
   -e, --end <time>     End time (e.g. 30, 00:00:30, 2:45.0). Default: end of video.
-  -h, --help
   
 SEE ALSO
 	mediasnacks vsplit
 `.trim()
 
 
-async function main() {
+export default async function main() {
 	await assertUserHasFFmpeg()
 
 	const { values, files } = await parseOptions({
@@ -39,10 +37,14 @@ async function main() {
 		throw new Error('No video specified. See mediasnacks vtrim --help')
 
 	for (const file of files)
-		await vtrim(resolve(file), values.start, values.end)
+		await vtrim({
+			video: resolve(file),
+			start: values.start,
+			end: values.end
+		})
 }
 
-async function vtrim(video, start, end) {
+export async function vtrim({ video, start, end }) {
 	const { dir, name, ext } = parse(video)
 	await ffmpeg([
 		'-v', 'error',
@@ -54,8 +56,3 @@ async function vtrim(video, start, end) {
 		resolve(dir, `${name}.trim${ext}`)
 	].flat())
 }
-
-main().catch(err => {
-	console.error(err.message || err)
-	process.exit(1)
-})