mediasnacks 0.20.1 → 0.22.1

package/README.md

@@ -13,7 +13,7 @@ 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
+$(npm root -g)/mediasnacks/install-zsh-completions.js
 ```
 
 
@@ -50,6 +50,8 @@ 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
+- `play` Plays filtered playlist with mpv
 
 
 - `dlaudio`: yt-dlp best audio
@@ -60,8 +62,6 @@ mediasnacks <command> <args>
 - `rmcover`: Removes cover art
 
 
-- `curltime`: Measures request response timings
-
 ### Globs
 Glob patterns are expanded by Node.js.
 
@@ -76,57 +76,6 @@ mediasnacks avif -- file[234].png
 ```
 
 
----
-
-## Commands
-
-### Converting Images to AVIF
-```shell
-mediasnacks avif [-y | --overwrite] [--output-dir=<dir>] <images> 
-```
-
-<br/>
-
-### Resizing Images or Videos
-Resizes videos and images. The aspect ratio is preserved when only one dimension is specified.
-
-`--width` and `--height` are `-2` by default:
-- `-1` auto-compute while preserving the aspect ratio (may result in an odd number)
-- `-2` same as `-1` but rounds to the nearest even number
-
-```shell
-mediasnacks resize [--width=<num>] [--height=<num>] [-y | --overwrite] [--output-dir=<dir>] <files>
-```
-
-Example: Overwrites the input file (-y)
-```shell
-mediasnacks resize -y --width 480 'dir-a/**/*.png' 'dir-b/**/*.mp4'
-```
-
-Example: Output directory (-o)
-```shell
-mediasnacks resize --height 240 --output-dir /tmp/out video.mov
-```
-
-<br/>
-
-### Fast-Start Streaming Video
-Rearranges .mov and .mp4 metadata to the start of the file for fast-start streaming.
-
-**Files are overwritten**
-
-```shell
-mediasnacks moov2front <videos>
-```
-What is Fast Start?
-- https://wiki.avblocks.com/avblocks-for-cpp/muxer-parameters/mp4
-- https://trac.ffmpeg.org/wiki/HowToCheckIfFaststartIsEnabledForPlayback
-
-
-<br/>
-
----
-
 ## Adding a macOS Quick Action
 
 

package/install-zsh-completions.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+import { join } from 'node:path'
+import { execSync } from 'node:child_process'
+import { writeFileSync } from 'node:fs'
+import { commandsSummary } from './src/cli.js'
+
+let zshFuncDefsDirs
+try {
+	zshFuncDefsDirs = execSync('zsh -c "print -l \\$fpath"', { encoding: 'utf-8' })
+}
+catch {
+	process.exit(0) // Exit on systems without ZSH
+}
+
+for (const dir of zshFuncDefsDirs.split('\n'))
+	try {
+		writeFileSync(join(dir, '_mediasnacks'), makeScript(), { mode: 0o755 })
+		break
+	}
+	catch {}
+
+
+function makeScript() {
+	return `#compdef mediasnacks
+
+_mediasnacks_commands=(
+${commandsSummary().map(([cmd, desc]) => `'${cmd}:${desc}'`).join('\n')}
+)
+
+if (( CURRENT == 2 )); then
+	_describe -t commands 'mediasnacks commands' _mediasnacks_commands
+	return
+fi
+
+local cmd="$words[2]"
+case "$cmd" in
+	qdir)
+		_files -/
+		;;
+	*)
+		_files
+		;;
+esac
+`
+}
+
+

package/package.json

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

package/src/avif.js

@@ -4,10 +4,10 @@ import { join, basename, dirname } from 'node:path'
 
 import { parseOptions } from './utils/parseOptions.js'
 import { replaceExt, lstat } from './utils/fs-utils.js'
-import { ffmpeg, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks avif [-y | --overwrite] [--output-dir=<dir>] <images> 
 
@@ -26,7 +26,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
@@ -35,14 +35,14 @@ async function main() {
 
 	console.log('AVIF…')
 	for (const file of files)
-		await toAvif({
+		await avif({
 			file,
 			outFile: join(values['output-dir'] || dirname(file), replaceExt(basename(file), 'avif')),
 			overwrite: values.overwrite
 		})
 }
 
-async function toAvif({ file, outFile, overwrite }) {
+async function avif({ file, outFile, overwrite }) {
 	const stAvif = lstat(outFile)
 
 	if (!overwrite && stAvif?.isFile()) {

package/src/cli.js

@@ -18,7 +18,7 @@ const COMMANDS = {
 	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 '],
+	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'],
@@ -28,47 +28,57 @@ const COMMANDS = {
 
 	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\n'],
+	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\n'],
+	rmcover: ['rmcover.sh', 'Removes cover art'],
+}
 
-	curltime: ['curltime.sh', 'Measures request response timings'],
+export function commandsSummary() {
+	return Object.entries(COMMANDS)
+		.map(([cmd, [, desc]]) => [cmd, desc])
 }
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks <command> <args>
 
 COMMANDS
-${Object.entries(COMMANDS).map(([cmd, [, title]]) =>
-	`  ${styleText('bold', cmd.padEnd(12, ' '))}\t${title}`).join('\n')}
+${commandsSummary().map(([cmd, desc]) =>
+	`  ${styleText('bold', cmd.padEnd(12, ' '))}\t${desc}`).join('\n')}
 `.trim()
 
 
-const [, , opt, ...args] = process.argv
-
-if (opt === '-v' || opt === '--version') {
-	console.log(pkgJSON.version)
-	process.exit(0)
-}
-if (opt === '-h' || opt === '--help') {
-	console.log(MAN)
-	process.exit(0)
-}
-
-if (!opt) {
-	console.log(MAN)
-	process.exit(1)
-}
-if (!Object.hasOwn(COMMANDS, opt)) {
-	console.error(`'${opt}' is not a command. See mediasnacks --help\n`)
-	process.exit(1)
+function main() {
+	const [, , opt, ...args] = process.argv
+
+	if (opt === '-v' || opt === '--version') {
+		console.log(pkgJSON.version)
+		process.exit(0)
+	}
+	if (opt === '-h' || opt === '--help') {
+		console.log(HELP)
+		process.exit(0)
+	}
+
+	if (!opt) {
+		console.log(HELP)
+		process.exit(1)
+	}
+	if (!Object.hasOwn(COMMANDS, opt)) {
+		console.error(`'${opt}' is not a command. See mediasnacks --help\n`)
+		process.exit(1)
+	}
+
+	const cmd = join(import.meta.dirname, COMMANDS[opt][0])
+	spawn(cmd, args, { stdio: 'inherit' })
+		.on('exit', process.exit)
 }
 
-const cmd = join(import.meta.dirname, COMMANDS[opt][0])
-spawn(cmd, args, { stdio: 'inherit' })
-	.on('exit', process.exit)
+if (import.meta.main)
+	main()

package/src/detectdups.js

@@ -1,14 +1,16 @@
 #!/usr/bin/env node
 
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg, assertUserHasFFmpeg, videoAttrs } from './utils/ffmpeg.js'
+import { ffmpeg, assertUserHasFFmpeg, videoAttrs } from './utils/subprocess.js'
 
 const STDEV_THRESHOLD = 0.2
 
-const MAN = `
-Usage: mediasnacks detectdups [options] <video>
+const HELP = `
+SYNOPSIS
+  mediasnacks detectdups [options] <video>
 
-Detects sequentially duplicate frames in a video and prints a histogram of their distance.
+DESCRIPTION
+  Detects sequentially duplicate frames in a video and prints a histogram of their distance.
 
 EXAMPLES
   Peak at N=2, means that every other frame is repeated, such as in a 
@@ -38,7 +40,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
@@ -70,11 +72,20 @@ async function main() {
 		throw new Error(`Invalid analysis range. Exceeds video duration: ${vDur}`)
 
 
-	const dups = await detectDuplicateFramesNums(files[0], seek, duration)
-	analyze(dups, seek, duration)
+	const dups = await detectdups(files[0], seek, duration)
+	const h = deltaHistogram(dups)
+	const report = {
+		n: maxFreqKey(h),
+		histogram: h,
+		analyzed_region: {
+			start_sec: seek,
+			end_sec: seek + duration
+		},
+	}
+	console.log(JSON.stringify(report, null, 2))
 }
 
-export async function detectDuplicateFramesNums(video, seek, duration) {
+export async function detectdups(video, seek, duration) {
 	const { stderr } = await ffmpeg([
 		'-v', 'info',
 		'-stats',
@@ -106,29 +117,22 @@ export async function detectDuplicateFramesNums(video, seek, duration) {
 
 // This is only good for when there's one repeated frame in a cycle.
 // i.e. it's the wrong approach for e.g. 25 to 60, in which N=2 and N=3
-function analyze(dup_frames, seek, duration) {
+function deltaHistogram(dups) {
 	const histogram = {}
-	for (let i = 1; i < dup_frames.length; i++) {
-		const diff = dup_frames[i] - dup_frames[i - 1]
+	for (let i = 1; i < dups.length; i++) {
+		const diff = dups[i] - dups[i - 1]
 		histogram[diff] = (histogram[diff] || 0) + 1
 	}
-	console.log(JSON.stringify({
-		analyzed_region: {
-			start_sec: seek,
-			end_sec: seek + duration
-		},
-		histogram,
-		n: maxFreqKey(histogram)
-	}, null, 2))
+	return histogram
 }
 
-function maxFreqKey(hist) {
+function maxFreqKey(histogram) {
 	let maxKey = null
 	let maxVal = -1
-	for (const [key, val] of Object.entries(hist))
-		if (val > maxVal) {
-			maxVal = val
-			maxKey = key
+	for (const [k, v] of Object.entries(histogram))
+		if (v > maxVal) {
+			maxVal = v
+			maxKey = k
 		}
 	return maxKey !== null
 		? Number(maxKey)
@@ -136,7 +140,6 @@ function maxFreqKey(hist) {
 }
 
 
-
 if (import.meta.main)
 	main().catch(err => {
 		console.error(err.message || err)

package/src/detectdups.test.js

@@ -6,31 +6,19 @@ import { cli } from './utils/test-utils.js'
 const rel = f => join(import.meta.dirname, f)
 
 function detect(video) {
-	const { stdout } = cli('detectdups', rel(video), 0, 7)
+	const { stdout } = cli('detectdups', rel(video))
 	return JSON.parse(stdout).n
 }
 
-
-test('no dups', () =>
-	equal(detect('fixtures/big-buck-bunny/bbb_24fps_no_dups.mp4'), null))
-
+test('no dups', () => equal(detect('fixtures/big-buck-bunny/bbb_24fps_no_dups.mp4'), null))
 
 // These fixtures are badly retimed (non-interpolated, just duplicating a frame)
 
-test('24 to 48 (has dup at n=2)', () =>
-	equal(detect('fixtures/big-buck-bunny/bbb_24_to_48fps_dup.mp4'), 2))
-
-test('25 to 50 (has dup at n=2)', () =>
-	equal(detect('fixtures/big-buck-bunny/bbb_25_to_50fps_dup.mp4'), 2))
-
-
-test('24 to 30 (has dup at n=5)', () =>
-	equal(detect('fixtures/big-buck-bunny/bbb_24_to_30fps_dup.mp4'), 5))
-
-test('25 to 30 (has dup at n=6)', () =>
-	equal(detect('fixtures/big-buck-bunny/bbb_25_to_30fps_dup.mp4'), 6))
+test('24 to 48 (has dup at n=2)', () => equal(detect('fixtures/big-buck-bunny/bbb_24_to_48fps_dup.mp4'), 2))
+test('25 to 50 (has dup at n=2)', () => equal(detect('fixtures/big-buck-bunny/bbb_25_to_50fps_dup.mp4'), 2))
 
+test('24 to 30 (has dup at n=5)', () => equal(detect('fixtures/big-buck-bunny/bbb_24_to_30fps_dup.mp4'), 5))
+test('25 to 30 (has dup at n=6)', () => equal(detect('fixtures/big-buck-bunny/bbb_25_to_30fps_dup.mp4'), 6))
 
-test('24 to 25 (has dup at n=25)', () =>
-	equal(detect('fixtures/big-buck-bunny/bbb_24_to_25fps_dup.mp4'), 25))
+test('24 to 25 (has dup at n=25)', () => equal(detect('fixtures/big-buck-bunny/bbb_24_to_25fps_dup.mp4'), 25))
 

package/src/dropdups.js

@@ -3,21 +3,13 @@
 import { resolve, parse, format } from 'node:path'
 
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg, assertUserHasFFmpeg, run } from './utils/ffmpeg.js'
+import { ffmpeg, assertUserHasFFmpeg, run } from './utils/subprocess.js'
+import { PRORES_PROFILES } from './prores.js'
 
 
-const PRORES_PROFILES = {
-	'proxy': 0,
-	'lt': 1,
-	'standard': 2,
-	'hq': 3,
-	'4444': 4,
-	'4444xq': 5,
-}
 const PROFILE = PRORES_PROFILES.hq
 
-
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks dropdups [-n <bad-frame-number>] <video>
 
@@ -42,7 +34,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
@@ -55,10 +47,10 @@ async function main() {
 
 	console.log('Dropping Duplicate Frames…')
 	for (const file of files)
-		await drop(resolve(file), nBadFrame)
+		await dropdups(resolve(file), nBadFrame)
 }
 
-async function drop(video, nBadFrame) {
+async function dropdups(video, nBadFrame) {
 	await run('ffmpeg', [
 		'-v', 'error',
 		'-stats',

package/src/edgespic.js

@@ -4,10 +4,10 @@ import { basename, extname, join, parse } from 'node:path'
 
 import { mkDir } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg, videoAttrs, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { ffmpeg, videoAttrs, assertUserHasFFmpeg } from './utils/subprocess.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks edgespic [--width=<num>] <files>
 
@@ -30,7 +30,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
@@ -46,11 +46,11 @@ async function main() {
 
 	console.log('Extracting edge frames…')
 	for (const file of files)
-		await extractEdgeFrames(file, width, outDir)
+		await edgespic(file, width, outDir)
 }
 
 
-async function extractEdgeFrames(video, width, outDir) {
+async function edgespic(video, width, outDir) {
 	const { r_frame_rate } = await videoAttrs(video)
 	const name = basename(video, extname(video))
 

package/src/hev1tohvc1.js

@@ -2,10 +2,10 @@
 
 import { parseOptions } from './utils/parseOptions.js'
 import { uniqueFilenameFor, overwrite } from './utils/fs-utils.js'
-import { videoAttrs, ffmpeg, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { videoAttrs, ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks hev1tohvc1 <videos>
 
@@ -22,14 +22,14 @@ async function main() {
 	const { files } = await parseOptions()
 
 	if (!files.length)
-		throw new Error(MAN)
+		throw new Error(HELP)
 
 	console.log('HEV1 to HVC1…')
 	for (const file of files)
-		await toHvc1(file)
+		await hev1tohvc1(file)
 }
 
-async function toHvc1(file) {
+async function hev1tohvc1(file) {
 	const v = await videoAttrs(file)
 	if (v.codec_tag_string !== 'hev1') {
 		console.log('(skipped: non hev1)', file)

package/src/moov2front.js

@@ -1,16 +1,20 @@
 #!/usr/bin/env node
 
-import { ffmpeg, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 import { uniqueFilenameFor, overwrite } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks moov2front <videos>
 
 DESCRIPTION
   Rearranges .mov and .mp4 metadata to the start of the file for fast-start streaming.
+  
+  What is Fast Start?
+	  - https://wiki.avblocks.com/avblocks-for-cpp/muxer-parameters/mp4
+	  - https://trac.ffmpeg.org/wiki/HowToCheckIfFaststartIsEnabledForPlayback
  
 NOTES
   Files are overwritten.
@@ -22,7 +26,7 @@ async function main() {
 	const { files } = await parseOptions()
 
 	if (!files.length)
-		throw new Error(MAN)
+		throw new Error(HELP)
 
 	console.log('Optimizing video for progressive download…')
 	for (const file of files)

package/src/play.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { join } from 'node:path'
+import { spawn } from 'node:child_process'
+import { readdirSync } from 'node:fs'
+import { parseOptions } from './utils/parseOptions.js'
+
+
+const HELP = `
+SYNOPSIS
+  mediasnacks play [--no-recursive] [-h | --help] [query ...]
+
+DESCRIPTION
+  Plays a filtered playlist with mpv.
+ 
+EXAMPLE
+  cd Music
+  mediasnacks play artistX artistY
+`.trim()
+
+
+async function main() {
+	const { values, positionals } = await parseOptions({
+		recursive: { short: 'r', type: 'boolean', default: true },
+		help: { short: 'h', type: 'boolean' }
+	}, { allowNegative: true })
+
+	if (values.help) {
+		console.log(HELP)
+		process.exit(0)
+	}
+
+	const pattern = positionals.length
+		? positionals.join('|')
+		: ''
+	const files = findFiles('.', new RegExp(pattern, 'i'), values.recursive)
+
+	if (!files.length) {
+		console.error('No matching files found.')
+		process.exit(0)
+	}
+
+	const child = spawn('mpv', ['--playlist=-'], {
+		detached: true,
+		stdio: ['pipe', 'ignore', 'ignore']
+	})
+	child.stdin.end(files.join('\n'))
+	child.unref()
+}
+
+function findFiles(dir, regex, recursive = true) {
+	const IGNORED_DIRS = ['.fcpbundle/']
+	return readdirSync(dir, { withFileTypes: true, recursive })
+		.filter(entry =>
+			entry.isFile()
+			&& !entry.name.startsWith('.')
+			&& !IGNORED_DIRS.some(d => entry.parentPath.includes(d))
+			&& regex.test(entry.name))
+		.map(entry => join(entry.parentPath, entry.name))
+}
+
+main().catch(err => {
+	console.error(err.message)
+	process.exit(1)
+})

package/src/prores.js

@@ -3,9 +3,9 @@
 import { resolve, parse, join } from 'node:path'
 
 import { parseOptions } from './utils/parseOptions.js'
-import { assertUserHasFFmpeg, run } from './utils/ffmpeg.js'
+import { assertUserHasFFmpeg, run } from './utils/subprocess.js'
 
-const PRORES_PROFILES = {
+export const PRORES_PROFILES = {
 	'proxy': 0,
 	'lt': 1,
 	'standard': 2,
@@ -14,7 +14,7 @@ const PRORES_PROFILES = {
 	'4444xq': 5,
 }
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks prores [options] <video>
 
@@ -42,31 +42,35 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
 	if (files.length !== 1)
 		throw new Error('Expected 1 argument: video file. See mediasnacks prores --help')
 
-	const videoPath = resolve(files[0])
-
-	const { name, dir } = parse(videoPath)
-	const outputPath = join(dir, `${name}.prores.mov`)
+	const video = resolve(files[0])
+	const { name, dir } = parse(video)
+	const output = join(dir, `${name}.prores.mov`)
 
 	console.log(`Converting to ProRes…`)
+	await prores(video, values.profile, output)
+}
+
+async function prores(video, profile, output) {
 	await run('ffmpeg', [
 		'-v', 'error',
 		'-stats',
-		'-i', videoPath,
+		'-i', video,
 		'-c:v', 'prores_ks',
-		'-profile:v', values.profile,
+		'-profile:v', profile,
 		'-pix_fmt', 'yuv422p10le',
-		outputPath
+		output
 	])
 }
 
-main().catch(err => {
-	console.error(err.message || err)
-	process.exit(1)
-})
+if (import.meta.main)
+	main().catch(err => {
+		console.error(err.message || err)
+		process.exit(1)
+	})

package/src/qdir.js

@@ -8,7 +8,7 @@ import { readdir, writeFile, unlink, rename } from 'node:fs/promises'
 import { isFile } from './utils/fs-utils.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks qdir [folder]
 
@@ -26,7 +26,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 

package/src/random.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { join } from 'node:path'
+import { spawn } from 'node:child_process'
+import { readdirSync } from 'node:fs'
+import { parseOptions } from './utils/parseOptions.js'
+
+
+const HELP = `
+SYNOPSIS
+  mediasnacks random [-r | --recursive] [-h | --help]
+
+DESCRIPTION
+  Opens a random file in the current working directory
+`.trim()
+
+async function main() {
+	if (process.platform !== 'darwin') {
+		console.error('Error: This command is only supported on macOS.')
+		process.exit(1)
+	}
+
+	const { values } = await parseOptions({
+		recursive: { short: 'r', type: 'boolean' },
+		help: { short: 'h', type: 'boolean' }
+	})
+
+	if (values.help) {
+		console.log(HELP)
+		process.exit(0)
+	}
+
+	spawn('open', [pickRandomFile('.', values.recursive)])
+}
+
+function pickRandomFile(dir, recursive) {
+	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/resize.js

@@ -5,10 +5,10 @@ import { rename } from 'node:fs/promises'
 
 import { parseOptions } from './utils/parseOptions.js'
 import { isFile, uniqueFilenameFor } from './utils/fs-utils.js'
-import { ffmpeg, videoAttrs, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { ffmpeg, videoAttrs, assertUserHasFFmpeg } from './utils/subprocess.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks resize [--width=<num>] [--height=<num>] [-y | --overwrite] [--output-dir=<dir>] <files>
 
@@ -41,7 +41,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 

package/src/seqcheck.js

@@ -4,7 +4,7 @@ import { parseArgs } from 'node:util'
 import { readdirSync } from 'node:fs'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks seqcheck [options] [folder]
 
@@ -29,7 +29,7 @@ function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 

package/src/sqcrop.js

@@ -3,12 +3,12 @@
 import { join } from 'node:path'
 import { rename } from 'node:fs/promises'
 
-import { ffmpeg, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 import { lstat, uniqueFilenameFor } from './utils/fs-utils.js'
 import { parseOptions } from './utils/parseOptions.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks sqcrop [-y | --overwrite] [--output-dir=<dir>] <images> 
 
@@ -27,7 +27,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 

package/src/ssim.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-import { ffmpeg } from './utils/ffmpeg.js'
+import { ffmpeg } from './utils/subprocess.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks ssim <img1> <img2>
 
@@ -15,7 +15,7 @@ DESCRIPTION
 async function main() {
 	const [img1, img2] = process.argv.slice(2)
 	if (!img1 || !img2) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(1)
 	}
 

package/src/utils/parseOptions.js

@@ -13,6 +13,7 @@ export async function parseOptions(options = {}, config = {}) {
 	})
 	return {
 		values,
+		positionals,
 		files: await resolveGlobs(positionals, tokens)
 	}
 }

package/src/utils/parseOptions.test.js

@@ -21,12 +21,13 @@ describe('parseOptions', () => {
 	after(() => rm(testDir, { recursive: true }))
 
 	test('parses args and globs files', async () => {
-		const { values, files } = await parseOptions({
+		const { values, positionals, files } = await parseOptions({
 			'output-dir': { type: 'string' }
 		}, {
 			args: ['--output-dir', '/tmp', inTmpDir('file[12].png')],
 		})
 		equal(values['output-dir'], '/tmp')
+		deepEqual(positionals, [inTmpDir('file[12].png')])
 		deepEqual(files, [
 			inTmpDir('file1.png'),
 			inTmpDir('file2.png')

package/src/vconcat.test.js

@@ -3,7 +3,7 @@ import { join } from 'node:path'
 import { test } from 'node:test'
 import { cpSync } from 'node:fs'
 
-import { videoAttrs } from './utils/ffmpeg.js'
+import { videoAttrs } from './utils/subprocess.js'
 import { mkTempDir, cli } from './utils/test-utils.js'
 
 const rel = f => join(import.meta.dirname, f)

package/src/vsplit.js

@@ -4,12 +4,12 @@ import { readFileSync } from 'node:fs'
 import { resolve, parse, join } from 'node:path'
 
 import { parseOptions } from './utils/parseOptions.js'
-import { assertUserHasFFmpeg, run } from './utils/ffmpeg.js'
+import { assertUserHasFFmpeg, run } from './utils/subprocess.js'
 
 
 // TODO looks like it's missing a frame (perhaps becaue of -c copy)
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks vsplit <csv> <video>
 
@@ -41,7 +41,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
@@ -55,7 +55,7 @@ async function main() {
 		throw new Error('CSV file contains no clips')
 
 	console.log(`Splitting video into ${clips.length} clip${clips.length === 1 ? '' : 's'}…`)
-	await splitVideo(videoPath, clips)
+	await vsplit(videoPath, clips)
 }
 
 function parseCSV(csvPath) {
@@ -77,7 +77,7 @@ function parseCSV(csvPath) {
 	return clips
 }
 
-async function splitVideo(videoPath, clips) {
+async function vsplit(videoPath, clips) {
 	const { dir, name, ext } = parse(videoPath)
 	const seqLen = Math.log10(clips.length) + 1 | 0
 

package/src/vsplit.test.js

@@ -3,7 +3,7 @@ import { join } from 'node:path'
 import { describe, test } from 'node:test'
 import { cpSync, readdirSync } from 'node:fs'
 
-import { videoAttrs } from './utils/ffmpeg.js'
+import { videoAttrs } from './utils/subprocess.js'
 import { mkTempDir, cli } from './utils/test-utils.js'
 
 

package/src/vtrim.js

@@ -2,10 +2,10 @@
 
 import { resolve, parse } from 'node:path'
 import { parseOptions } from './utils/parseOptions.js'
-import { ffmpeg, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+import { ffmpeg, assertUserHasFFmpeg } from './utils/subprocess.js'
 
 
-const MAN = `
+const HELP = `
 SYNOPSIS
   mediasnacks vtrim [--start <time>] [--end <time>] <video>
 
@@ -29,7 +29,7 @@ async function main() {
 	})
 
 	if (values.help) {
-		console.log(MAN)
+		console.log(HELP)
 		process.exit(0)
 	}
 
@@ -37,10 +37,10 @@ async function main() {
 		throw new Error('No video specified. See mediasnacks vtrim --help')
 
 	for (const file of files)
-		await trim(resolve(file), values.start, values.end)
+		await vtrim(resolve(file), values.start, values.end)
 }
 
-async function trim(video, start, end) {
+async function vtrim(video, start, end) {
 	const { dir, name, ext } = parse(video)
 	await ffmpeg([
 		'-v', 'error',

package/src/vtrim.test.js

@@ -3,7 +3,7 @@ import { join } from 'node:path'
 import { cpSync } from 'node:fs'
 import { describe, test } from 'node:test'
 
-import { videoAttrs } from './utils/ffmpeg.js'
+import { videoAttrs } from './utils/subprocess.js'
 import { mkTempDir, cli } from './utils/test-utils.js'
 
 const rel = f => join(import.meta.dirname, f)

package/.zsh/completions/_mediasnacks

@@ -1,49 +0,0 @@
-#compdef mediasnacks
-
-_mediasnacks_commands=(
-  'avif:Converts images to AVIF'
-  'sqcrop:Square crops images'
-  
-  'resize:Resizes videos or images'
-  'edgespic:Extracts first and last frames'
-  'ssim:Computes similarity of two images'
-  'gif:Video to GIF'
-  
-  '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'
-  'vconcat:Concatenates videos'
-  'vdiff:Plays a video with the difference of two videos'
-  'vsplit:Splits a video into multiple clips from CSV timestamps'
-  'vtrim:Trims video from start to end time'
-  'prores:Converts video to Apple ProRes'
-  
-  'flattendir:Moves unique files to the top dir and deletes empty dirs'
-  'seqcheck:Finds missing sequence number'
-  'qdir:Sequentially runs all *.sh files in a folder'
-  
-  'dlaudio: yt-dlp best audio'
-  'dlvideo: yt-dlp best video'
-  
-  'unemoji:Removes emojis from filenames'
-  'rmcover:Removes cover art'
-  
-  'curltime:Measures request response timings'
-)
-
-if (( CURRENT == 2 )); then
-	_describe -t commands 'mediasnacks commands' _mediasnacks_commands
-	return
-fi
-
-local cmd="$words[2]"
-case "$cmd" in
-	avif|resize|sqcrop|moov2front|detectdups|dropdups|edgespic|seqcheck|hev1tohvc1|framediff|vdiff|vconcat|vsplit|vtrim|dlaudio|dlvideo|unemoji|rmcover|curltime|gif|flattendir|prores|ssim)
-		_files
-		;;
-	qdir)
-		_files -/
-		;;
-esac

package/install-zsh-completions.sh

@@ -1,23 +0,0 @@
-#!/bin/sh
-set -eu
-
-# Exit on systems without ZSH
-zsh=$(command -v zsh) || exit 0
-
-src="$(cd "$(dirname "$0")" && pwd)/.zsh/completions/_mediasnacks"
-[ -f "$src" ] || exit 0
-
-exec "$zsh" -s "$src" << 'ZSH_EOF'
-src="$1"
-for dir in "${fpath[@]}"; do
-  if [ -w "$dir" ]; then
-    dst="$dir/_mediasnacks"
-    ln -sf "$src" "$dst"
-    echo "linked zsh completions: $dst -> $src"
-    exit 0
-  fi
-done
-echo "zsh completions: no writable fpath directory found, skipping." >&2
-exit 0
-ZSH_EOF
-

package/src/curltime.sh

@@ -1,14 +0,0 @@
-#!/bin/sh
-
-# https://stackoverflow.com/a/47944496
-
-curl -so /dev/null -w "\
-   DNS Lookup  %{time_namelookup}
-TCP Handshake  %{time_connect}
-TLS Handshake  %{time_appconnect}
-         Wait  %{time_pretransfer}
-     Redirect  %{time_redirect}
-   First Byte  %{time_starttransfer}
-───────────────────────   
-        TOTAL  %{time_total}
-" "$@"