mediasnacks 0.32.0 → 0.33.0

package/README.md

@@ -32,6 +32,7 @@ mediasnacks <command> <args>
 - `ssim` Computes similarity of two images
 - `gif`: Video to GIF
 - `info`: Prints video attributes
+- `tag`: Adds color tag for Finder
 
 
 - `detectdups` Detects sequentially duplicate frames in a video

package/package.json

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

package/src/cli.js

@@ -18,7 +18,8 @@ const COMMANDS = {
 	countframes: ['./countframes.js', 'Counts frames in a video'],
 	ssim: ['./ssim.js', 'Computes SSIM between two images'],
 	gif: ['./gif.js', 'Video to GIF'],
-	info: ['./info.js', 'Prints video stream attributes\n'],
+	info: ['./info.js', 'Prints video stream attributes'],
+	tag: ['./tag.osascript', 'Adds color tag for Finder\n'],
 
 	detectdups: ['./detectdups.js', 'Detects duplicate frames in a video'],
 	dropdups: ['./dropdups.js', 'Removes duplicate frames in a video'],
@@ -55,7 +56,7 @@ SYNOPSIS
 
 COMMANDS
 ${commandsSummary().map(([cmd, desc]) =>
-	`  ${styleText('bold', cmd.padEnd(12, ' '))}\t${desc}`).join('\n')}
+	`  ${styleText('bold', cmd.padEnd(12))}\t${desc}`).join('\n')}
 `.trim()
 
 
@@ -77,11 +78,11 @@ async function main() {
 	if (!opt) throw HELP
 	if (!Object.hasOwn(COMMANDS, opt)) throw `'${opt}' is not a command. See mediasnacks --help\n`
 
-	const cmd = COMMANDS[opt][0]
-	if (cmd.endsWith('.js'))
-		await (await import(cmd)).default()
+	const prog = COMMANDS[opt][0]
+	if (prog.endsWith('.js'))
+		await (await import(prog)).default()
 	else
-		spawn(join(import.meta.dirname, cmd), args, { stdio: 'inherit' })
+		spawn(join(import.meta.dirname, prog), args, { stdio: 'inherit' })
 			.on('exit', process.exit)
 }
 

package/src/dlaudio.js

@@ -1,6 +1,5 @@
 import { parseOptions } from './utils/parseOptions.js'
-import { runSilently } from './utils/subprocess.js'
-import { unemoji } from './unemoji.js'
+import { run } from './utils/subprocess.js'
 
 
 const HELP = `
@@ -17,18 +16,14 @@ export default async function main() {
 	if (!positionals[0])
 		throw usage('Missing URL')
 
-	const f = await dlaudio(positionals[0])
-	console.log(f)
+	await dlaudio(positionals[0])
 }
 
 export async function dlaudio(url) {
-	const f = (await runSilently('yt-dlp', [
-		'--print', 'filename',
+	await run('yt-dlp', [
 		'--no-simulate',
 		'-o', '%(title)s.%(ext)s',
 		'-f', 'bestaudio[ext=m4a]/bestaudio',
 		url
-	])).stdout.trim()
-
-	return await unemoji(f) || f
+	])
 }

package/src/info.js

@@ -5,13 +5,38 @@ import { formatSeconds, cleanDecimals } from './utils/formatSeconds.js'
 
 const HELP = `
 SYNOPSIS
-  mediasnacks info [-a | --all] <file>
+  mediasnacks info [-a | --all] <files>
 
 DESCRIPTION
-  Prints all available attributes for the primary video stream from ffprobe.
+  Prints video or image attributes using ffprobe. By default, it’s similar to 
+  \`ls\` but prints the: width, height, fps, duration, codec, and filename.
 
 OPTIONS
-  -a, --all    Prints all attributes as JSON
+  -a, --all    Prints everything as JSON
+
+EXAMPLES
+  Short summary of each match:	
+    mediasnacks info *.mp4
+  
+  Sort by fps:
+    mediasnacks info *.* | sort -k3,3n
+
+  Move 60fps videos into 60fps/ subdir: 
+    FPS=60
+    DIR=\${FPS}fps
+    mkdir -p \$DIR
+    mediasnacks info *.* |
+      awk "\\$3==\\"\${FPS}fps\\" { print \\$NF }" |
+      while read -r f; do
+        mv -- "$f" \$DIR/
+      done  
+   
+  Tag with "red" (in macOS Finder) 1080 videos:
+    COLOR=red
+    HEIGHT=1080
+    mediasnacks info *.mov |
+      awk "\\$2==\$HEIGHT { print \\$NF }" |
+    	xargs -I{} mediasnacks tag $COLOR "{}" 
 `
 
 export default async function main() {
@@ -19,45 +44,28 @@ export default async function main() {
 		all: { short: 'a', type: 'boolean' }
 	})
 
-	const video = files[0]
-	if (!video) throw usage('No video file specified')
+	if (!files[0]) throw usage('No video file specified')
 
-	if (values.all)
-		console.log(JSON.stringify(await videoAttrs(video), '', 2))
-	else
-		console.log(await infoSummary(video))
+	for (const video of files)
+		if (values.all)
+			console.log(JSON.stringify(await videoAttrs(video), '', 2))
+		else
+			console.log(`${await infoSummary(video)}\t${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('  ')
+		String(v.width).padStart(4),
+		String(v.height).padStart(4),
+		`${fps(v.r_frame_rate)}fps`.padStart(7),
+		formatSeconds(v.duration, 0).padStart(8),
+		v.codec_name
+	].join('\t')
 }
 
 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/seqcheck.js

@@ -35,7 +35,7 @@ export function seqcheck(dir, leftDelim = LEFT_DELIM, rightDelim = RIGHT_DELIM)
 }
 
 export function extractSeqNums(names, leftDelim, rightDelim) {
-	const pattern = new RegExp(escapeRegex(leftDelim) + '(\\d+)' + escapeRegex(rightDelim))
+	const pattern = new RegExp(RegExp.escape(leftDelim) + '(\\d+)' + RegExp.escape(rightDelim))
 	const seq = []
 	for (const name of names) {
 		const match = name.match(pattern)
@@ -54,7 +54,3 @@ export function findMissingNumbers(seq) {
 			missing.push(i)
 	return missing
 }
-
-function escapeRegex(str) {
-	return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-}

package/src/tag.osascript

@@ -0,0 +1,42 @@
+#!/usr/bin/osascript
+
+property colorNames : {"none", "orange", "red", "yellow", "blue", "purple", "green", "gray"}
+
+on usage()
+    log "USAGE: mediasnacks tag <color> <file>"
+    set AppleScript's text item delimiters to " "
+    set colorList to colorNames as text
+    set AppleScript's text item delimiters to ""
+    log "COLORS: " & colorList
+end usage
+
+on labelNumForColor(theItem)
+    repeat with i from 1 to count of colorNames
+        if item i of colorNames as text is theItem as text then
+            return i - 1
+        end if
+    end repeat
+    return -1
+end labelNumForColor
+
+on run argv
+    if (count of argv) < 2 then
+        usage()
+        return
+    end if
+    set tagColor to item 1 of argv
+    set filePath to item 2 of argv
+
+    set labelNum to labelNumForColor(tagColor)
+    if labelNum is -1 then
+        log "invalid color: " & tagColor
+        usage()
+        return
+    end if
+
+    set theFile to POSIX file filePath as alias
+    tell application "Finder"
+        set label index of theFile to labelNum
+    end tell
+    return
+end run

package/src/unemoji.js

@@ -44,7 +44,7 @@ export default async function main() {
 
 	for (const file of files) {
 		const newpath = await unemoji(file)
-		if (newpath)
+		if (newpath !== file)
 			console.log(`Renaming: ${file} -> ${newpath}`)
 	}
 }
@@ -57,10 +57,11 @@ export async function unemoji(file) {
 		.replace(/\s+/g, ' ')
 		.replace(/\s+\./g, '.')
 		.trim()
+	const newpath = join(dir, newbase)
+
 	if (base === newbase)
-		return null
+		return newpath
 
-	const newpath = join(dir, newbase)
 	if (existsSync(newpath))
 		throw `Skipping (exists): ${file} -> ${newpath}`
 

package/src/utils/ffmpeg.js

@@ -1,5 +1,6 @@
+import os from 'node:os'
 import { spawn } from 'node:child_process'
-import { printProgress } from './printProgress.js'
+import { printProgress, showCursor } from './printProgress.js'
 import { videoAttrs } from './videoAttrs.js'
 import { runSilently } from './subprocess.js'
 
@@ -32,16 +33,26 @@ export async function ffmpegWithProgress(input, args, onProgress = printProgress
 		...args
 	], { stdio: ['inherit', 'pipe', 'pipe'] })
 
-	p.stderr.pipe(process.stderr)
+	const startTime = performance.now()
 	p.stdout.on('data', chunk => {
 		const text = chunk.toString()
-		if (text.includes('progress=end'))
-			onProgress(1)
-		else {
+		const msElapsed = performance.now() - startTime
+		if (text.includes('progress=continue')) {
 			const m = text.match(/out_time_us=(\d+)/)
-			onProgress(Number(m[1]) / µsVideoDuration)
+			const progress = Number(m[1]) / µsVideoDuration
+			const msETA = msElapsed * (1 - progress) / progress
+			onProgress(progress, msElapsed, msETA)
 		}
+		else
+			onProgress(1, msElapsed, 0)
+	})
+	process.on('SIGINT', () => {
+		p?.kill('SIGINT')
+		showCursor()
+		console.log('\nAborted')
+		process.exit(128 + os.constants.signals.SIGINT)
 	})
+	p.stderr.pipe(process.stderr)
 
 	await new Promise((resolve, reject) => {
 		p.on('error', reject)

package/src/utils/formatSeconds.js

@@ -1,3 +1,12 @@
+/**
+ * Removes trailing zeros and a trailing decimal point.
+ *
+ * Examples:
+ *   cleanDecimals(3.1400) -> "3.14"
+ *   cleanDecimals(5.0) -> "5"
+ */
+export const cleanDecimals = Number
+
 /**
  * Converts seconds to a string like "9h9m9s".
  *
@@ -8,26 +17,16 @@
  *   formatSeconds(3661.25, 2) -> "1h1m1.25s"
  */
 export function formatSeconds(seconds, maxDecimals = 2) {
+	if (!Number.isFinite(+seconds))
+		return ''
 	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`
+	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

@@ -10,48 +10,41 @@ const glob = promisify(_glob)
  * @param {Partial<import('node:util').ParseArgsConfig>} [config]
  */
 export async function parseOptions(helpText, options = {}, config = {}) {
+	helpText = helpText.trim()
 	options.help = { short: 'h', type: 'boolean' }
 
-	const { values, positionals, tokens } = parseArgs({
+	const { values, positionals } = parseArgs({
 		args: process.argv.slice(3),
 		allowPositionals: true,
 		options,
-		...config,
-		tokens: true
+		...config
 	})
 
 	if (values.help) {
-		console.log(helpText.trim())
+		console.log(helpText)
 		process.exit(0)
 	}
 
 	return {
 		values,
 		positionals,
-		files: await resolveGlobs(positionals, tokens),
+		files: await resolveGlobs(positionals),
 		usage: err => err
-			? styleText('redBright', '' + err + '\n') + helpText
+			? styleText('redBright', err + '\n') + helpText
 			: helpText
 	}
 }
 
-async function resolveGlobs(arr, tokens = []) {
-	const terminatorIndex = tokens.find(t => t.kind === 'option-terminator')?.index ?? -1
+async function resolveGlobs(arr) {
 	const set = new Set()
-
-	const globable = terminatorIndex === -1
-		? arr
-		: arr.slice(0, terminatorIndex)
-
-	for (const g of globable)
-		for (const file of await glob(g))
-			set.add(file)
-
-
-	if (terminatorIndex !== -1)
-		for (const literal of arr.slice(terminatorIndex))
-			set.add(literal)
-
+	for (const arg of arr) {
+		const matches = await glob(arg)
+		if (matches.length)
+			for (const file of matches)
+				set.add(file)
+		else
+			set.add(arg)
+	}
 	return Array.from(set)
 }
 

package/src/utils/parseTimecode.js

@@ -6,11 +6,11 @@ export function parseTimecode(time) {
 	if (parts.some(isNaN) || parts.length > 3)
 		throw new Error(`Invalid time: ${time}`)
 
-	// HH:MM:SS or HH:MM:SS.mmm
-	if (parts.length === 3) return parts[0] * 3600 + parts[1] * 60 + parts[2]
+	if (parts.length === 3) // HH:MM:SS or HH:MM:SS.mmm
+		return (3600 * parts[0]) + (60 * parts[1]) + parts[2]
 
-	// MM:SS or MM:SS.mmm
-	if (parts.length === 2) return parts[0] * 60 + parts[1]
+	if (parts.length === 2) // MM:SS or MM:SS.mmm
+		return (60 * parts[0]) + parts[1]
 
 	return parts[0]
 }

package/src/utils/printProgress.js

@@ -1,14 +1,34 @@
-export function printProgress(progress) {
-	process.stdout.write(`\r${progressBar(progress)} ${(progress * 100).toFixed(1)}%`)
+import { formatSeconds } from './formatSeconds.js'
+
+const HIDE_CURSOR = '\x1b[?25l'
+const SHOW_CURSOR = '\x1b[?25h'
+const ERASE_TO_END = '\x1b[K'
+
+export const showCursor = () => process.stdout.write(SHOW_CURSOR)
+
+export function printProgress(progress, msElapsed, msETA) {
+	const elapsed = msElapsed
+		? ` • ${formatSeconds(msElapsed / 1000, 0)}`
+		: ''
+	const eta = msETA
+		? ` • ETA ${formatSeconds(msETA / 1000, 0)}`
+		: ''
+	const percent = progress === 1
+		? '100%'
+		: `${(progress * 100).toFixed(1)}%`
+	process.stdout.write(HIDE_CURSOR)
+	process.stdout.write(`\r${progressBar(progress)} ${percent}${eta}${elapsed}${ERASE_TO_END}`)
 	if (progress === 1)
-		process.stdout.write('\n')
+		process.stdout.write('\n' + SHOW_CURSOR)
 }
 
-function progressBar(progress, width = 42) {
+function progressBar(progress, width = 44) {
+	width-- // for partial char
 	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)
+	const partial = partials.at(partials.length * fPartial)
+	return '█'.repeat(nFull) + partial + '•'.repeat(nRemaining)
 }

package/src/utils/test-utils.js

@@ -5,19 +5,10 @@ import { mkdtempSync, mkdirSync, writeFileSync } from 'node:fs'
 
 const rel = f => join(import.meta.dirname, f)
 
-export function mkTempDir(prefix = 'test-') {
-	return mkdtempSync(join(tmpdir(), prefix))
-}
+export const cli = (...args) => spawnSync(rel('../cli.js'), args)
 
-export function cli(...args) {
-	return spawnSync(rel('../cli.js'), args)
-}
+export const dir = (...args) => mkdirSync(join(...args), { recursive: true })
+export const touch = (...args) => writeFileSync(join(...args), '')
 
-export function dir(...args) {
-	return mkdirSync(join(...args), { recursive: true })
-}
-
-export function touch(...args) {
-	return writeFileSync(join(...args), '')
-}
+export const mkTempDir = (prefix = 'test-') => mkdtempSync(join(tmpdir(), prefix))