mediasnacks 0.16.5 → 0.18.0

package/.zsh/completions/_mediasnacks

@@ -16,6 +16,7 @@ _mediasnacks_commands=(
   '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'
@@ -37,7 +38,7 @@ fi
 
 local cmd="$words[2]"
 case "$cmd" in
-	avif|resize|sqcrop|moov2front|dropdups|edgespic|seqcheck|hev1tohvc1|framediff|vdiff|vconcat|vsplit|vtrim|dlaudio|dlvideo|unemoji|rmcover|curltime|gif|flattendir)
+	avif|resize|sqcrop|moov2front|dropdups|edgespic|seqcheck|hev1tohvc1|framediff|vdiff|vconcat|vsplit|vtrim|dlaudio|dlvideo|unemoji|rmcover|curltime|gif|flattendir|prores)
 		_files
 		;;
 	qdir)

package/README.md

@@ -28,6 +28,7 @@ npx mediasnacks <command> <args>
 - `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

package/package.json

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

package/src/cli.js

@@ -21,7 +21,8 @@ const COMMANDS = {
 	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.sh', 'Trims video from start to end time\n'],
+	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'],

package/src/prores.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+import { resolve, parse, join } from 'node:path'
+
+import { parseOptions } from './utils/parseOptions.js'
+import { assertUserHasFFmpeg, run } from './utils/ffmpeg.js'
+
+const PRORES_PROFILES = {
+	'proxy': 0,
+	'lt': 1,
+	'standard': 2,
+	'hq': 3,
+	'4444': 4,
+	'4444xq': 5,
+}
+
+const USAGE = `
+Usage: mediasnacks prores [options] <video>
+
+Converts a video to ProRes format.
+
+Arguments:
+  <video>  Video file to convert
+
+Options:
+  --profile <n>  ProRes profile (default: 3 (HQ))
+  -h, --help      Show this help message
+
+Example:
+  npx mediasnacks prores video.mov
+  npx mediasnacks prores --profile 2 video.mov
+
+  Outputs: video.prores.mov
+`.trim()
+
+
+async function main() {
+	await assertUserHasFFmpeg()
+
+	const { values, files } = await parseOptions({
+		help: { short: 'h', type: 'boolean' },
+		profile: { short: 'p', type: 'string', default: String(PRORES_PROFILES.hq) },
+	})
+
+	if (values.help) {
+		console.log(USAGE)
+		process.exit(0)
+	}
+
+	if (files.length !== 1)
+		throw new Error('Expected 1 argument: video file. See npx mediasnacks prores --help')
+
+	const videoPath = resolve(files[0])
+
+	const { name, dir } = parse(videoPath)
+	const outputPath = join(dir, `${name}.prores.mov`)
+
+	console.log(`Converting to ProRes…`)
+	await run('ffmpeg', [
+		'-v', 'error',
+		'-stats',
+		'-i', videoPath,
+		'-c:v', 'prores_ks',
+		'-profile:v', values.profile,
+		'-pix_fmt', 'yuv422p10le',
+		outputPath
+	])
+}
+
+main().catch(err => {
+	console.error(err.message || err)
+	process.exit(1)
+})

package/src/vtrim.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+import { resolve, parse } from 'node:path'
+import { parseOptions } from './utils/parseOptions.js'
+import { ffmpeg, assertUserHasFFmpeg } from './utils/ffmpeg.js'
+
+
+const USAGE = `
+Usage: mediasnacks vtrim [--start <time>] [--end <time>] <video>
+
+Trims a video without re-encoding (fast, but approximate cuts).
+
+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
+`.trim()
+
+
+async function main() {
+	await assertUserHasFFmpeg()
+
+	const { values, files } = await parseOptions({
+		start: { short: 's', type: 'string', default: '' },
+		end: { short: 'e', type: 'string', default: '' },
+		help: { short: 'h', type: 'boolean' }
+	})
+
+	if (values.help) {
+		console.log(USAGE)
+		process.exit(0)
+	}
+
+	if (!files.length)
+		throw new Error('No video specified. See npx mediasnacks vtrim --help')
+
+	for (const file of files)
+		await trim(resolve(file), values.start, values.end)
+}
+
+async function trim(video, start, end) {
+	const { dir, name, ext } = parse(video)
+	await ffmpeg([
+		'-v', 'error',
+		'-y',
+		start ? ['-ss', start] : [],
+		end ? ['-to', end] : [],
+		'-i', video,
+		'-c', 'copy',
+		resolve(dir, `${name}.trim${ext}`)
+	].flat())
+}
+
+main().catch(err => {
+	console.error(err.message || err)
+	process.exit(1)
+})

package/src/vtrim.test.js

@@ -1,7 +1,7 @@
 import { ok } from 'node:assert/strict'
 import { join } from 'node:path'
-import { test } from 'node:test'
 import { cpSync } from 'node:fs'
+import { describe, test } from 'node:test'
 
 import { videoAttrs } from './utils/ffmpeg.js'
 import { mkTempDir, cli } from './utils/test-utils.js'
@@ -9,14 +9,32 @@ import { mkTempDir, cli } from './utils/test-utils.js'
 const rel = f => join(import.meta.dirname, f)
 
 
-test('vtrim trims video from start to end time', async () => {
-	const tmp = mkTempDir('vtrim')
+describe('vtrim', () => {
+	function almostEqual(actual, expected) {
+		const EPSILON = 0.05
+		ok(Math.abs(parseFloat(actual) - expected) < EPSILON,
+			`Duration should be around ${expected}s, got ${actual}s`)
+	}
 
+	const tmp = mkTempDir('vtrim')
 	const inputFile = join(tmp, '60fps.mp4')
 	cpSync(rel('fixtures/60fps.mp4'), inputFile)
-	cli('vtrim', 5, 10, inputFile)
 
-	const { duration } = await videoAttrs(join(tmp, '60fps.trim.mp4'))
-	const EPSILON = 0.05
-	ok(Math.abs(parseFloat(duration) - 5) < EPSILON, `Duration should be 5s, got ${duration}s`)
+	test('from start to end time', async () => {
+		cli('vtrim', '--start', 5, '--end', 11, inputFile)
+		const { duration } = await videoAttrs(join(tmp, '60fps.trim.mp4'))
+		almostEqual(duration, 6)
+	})
+
+	test('start time only', async () => {
+		cli('vtrim', '--start', 5, inputFile)
+		const { duration } = await videoAttrs(join(tmp, '60fps.trim.mp4'))
+		almostEqual(duration, 25)
+	})
+
+	test('end time only', async () => {
+		cli('vtrim', '--end', 11, inputFile)
+		const { duration } = await videoAttrs(join(tmp, '60fps.trim.mp4'))
+		almostEqual(duration, 11)
+	})
 })

package/src/vtrim.sh

@@ -1,36 +0,0 @@
-#!/bin/sh
-
-if [ "$#" -ne 3 ]; then
-	cat << EOF
-Usage:
-    $(basename $0) <start-time> <end-time> <video-file>
-
-Examples:
-    $(basename $0) 10 30 input.mp4
-    $(basename $0) 00:00:10 00:00:30 input.mkv
-    $(basename $0) 1:23.5 2:45.0 video.mov
-EOF
-	exit 1
-fi
-
-START="$1"
-END="$2"
-VIDEO="$3"
-
-if [ ! -f "$VIDEO" ]; then
-	echo "Error: file not found: $VIDEO"
-	exit 1
-fi
-
-BASENAME=$(basename "$VIDEO")
-DIRNAME=$(dirname "$VIDEO")
-EXT="${BASENAME##*.}"
-NAME="${BASENAME%.*}"
-
-# For speed, we copy without re-encoding (with -ss before -i), but 
-# that means that the output isn’t going to be exact
-ffmpeg -v error -y \
-  -ss "$START" \
-	-to "$END" \
-  -i "$VIDEO" \
-	-c copy "$DIRNAME/${NAME}.trim.$EXT"