comfyclips 1.1.0 → 1.2.0

package/README.md

@@ -5,11 +5,12 @@ Interactive CLI to download video or audio from social media links (YouTube, Ins
 ## Requirements
 
 - Node.js >= 18
-- [ffmpeg](https://ffmpeg.org/) on your PATH — required to merge separate video/audio streams and to extract/convert audio formats. Without it, downloads may fail or fall back to lower quality.
-  - Debian/Ubuntu: `sudo apt-get install ffmpeg`
-  - macOS: `brew install ffmpeg`
-  - Windows: `choco install ffmpeg` (or download from ffmpeg.org and add it to PATH)
-- `yt-dlp` — not required ahead of time. If it isn't found on your PATH, ComfyClips downloads a copy automatically on first run into `~/.comfyclips/bin`.
+
+That's it — everything else is provisioned automatically:
+
+- **ffmpeg** — used to merge separate video/audio streams and to extract/convert audio formats. If it's not on your PATH, `npm install` fetches a static build for your platform (via `ffmpeg-static`).
+- **yt-dlp** — if it isn't found on your PATH, ComfyClips downloads a copy on first run into `~/.comfyclips/bin`.
+- **Deno** — YouTube requires a JS runtime to solve its signature challenge. If it isn't found on your PATH, ComfyClips downloads it on first run into `~/.comfyclips/bin`.
 
 ## Install
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "comfyclips",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Interactive CLI to download video or audio from social media platforms (YouTube, Instagram, TikTok, Facebook, X/Twitter) via yt-dlp.",
   "type": "module",
   "bin": {
@@ -35,6 +35,7 @@
     "chalk": "^5.3.0",
     "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
+    "ffmpeg-static": "^5.3.0",
     "figlet": "^1.11.4",
     "inquirer": "^14.1.0",
     "ora": "^8.1.0",

package/src/binaries.js

@@ -1,4 +1,5 @@
 import AdmZip from 'adm-zip';
+import ffmpegStaticPath from 'ffmpeg-static';
 import { spawnSync } from 'node:child_process';
 import { chmodSync, existsSync, mkdirSync, rmSync } from 'node:fs';
 import os from 'node:os';
@@ -19,9 +20,18 @@ function commandExists(cmd, versionFlag = '--version') {
   return !result.error && result.status === 0;
 }
 
-export function isFfmpegAvailable() {
+// Prefer a system ffmpeg if the user already has one on PATH; otherwise fall
+// back to the static binary `ffmpeg-static` already fetched via its own npm
+// postinstall step, so no separate download step is needed here.
+export function resolveFfmpeg() {
   // ffmpeg uses single-dash flags (-version), unlike most CLIs.
-  return commandExists('ffmpeg', '-version');
+  if (commandExists('ffmpeg', '-version')) {
+    return { available: true, locationArgs: [] };
+  }
+  if (ffmpegStaticPath && existsSync(ffmpegStaticPath)) {
+    return { available: true, locationArgs: ['--ffmpeg-location', ffmpegStaticPath] };
+  }
+  return { available: false, locationArgs: [] };
 }
 
 function denoAssetName() {

package/src/downloader.js

@@ -34,9 +34,18 @@ export function buildArgs({
   outputDir,
   ffmpegAvailable,
   jsRuntimeArgs = [],
+  ffmpegLocationArgs = [],
 }) {
   const outputTemplate = path.join(outputDir, '%(title)s.%(ext)s');
-  const args = [url, '-o', outputTemplate, '--no-playlist', '--newline', ...jsRuntimeArgs];
+  const args = [
+    url,
+    '-o',
+    outputTemplate,
+    '--no-playlist',
+    '--newline',
+    ...jsRuntimeArgs,
+    ...ffmpegLocationArgs,
+  ];
   const warnings = [];
 
   if (mode === 'audio') {
@@ -70,6 +79,7 @@ export async function downloadMedia({
   outputDir,
   ffmpegAvailable,
   jsRuntimeArgs,
+  ffmpegLocationArgs,
 }) {
   mkdirSync(outputDir, { recursive: true });
 
@@ -82,6 +92,7 @@ export async function downloadMedia({
     outputDir,
     ffmpegAvailable,
     jsRuntimeArgs,
+    ffmpegLocationArgs,
   });
   warnings.forEach(printWarning);
 

package/src/index.js

@@ -3,7 +3,7 @@ import { readFileSync, statSync } from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
-import { isFfmpegAvailable, resolveJsRuntimeArgs, resolveYtDlpBinaryPath } from './binaries.js';
+import { resolveFfmpeg, resolveJsRuntimeArgs, resolveYtDlpBinaryPath } from './binaries.js';
 import { downloadMedia } from './downloader.js';
 import { PLATFORMS, hostMatchesPlatform } from './platforms.js';
 import boxedSelect from './prompts/boxedSelect.js';
@@ -137,7 +137,7 @@ async function main() {
 
   try {
     const binaryPath = await resolveYtDlpBinaryPath();
-    const ffmpegAvailable = isFfmpegAvailable();
+    const { available: ffmpegAvailable, locationArgs: ffmpegLocationArgs } = resolveFfmpeg();
     const jsRuntimeArgs = await resolveJsRuntimeArgs();
 
     const { outputFile, elapsedSeconds } = await downloadMedia({
@@ -149,6 +149,7 @@ async function main() {
       outputDir,
       ffmpegAvailable,
       jsRuntimeArgs,
+      ffmpegLocationArgs,
     });
 
     let fileSize = 'Unknown';