ffmpeg-progress 1.4.0 → 1.6.0

package/README.md

@@ -42,6 +42,54 @@ await convertFile({
 timer.end()
 ```
 
+**Convert video with custom FFmpeg arguments**:
+
+```typescript
+import { convertFile } from 'ffmpeg-progress'
+
+// H.264 codec with YUV420p pixel format and 2000k bitrate
+await convertFile({
+  inFile: 'input.mp4',
+  outFile: 'output.mp4',
+  ffmpegArgs: ['-c:v', 'libx264', '-pix_fmt', 'yuv420p', '-b:v', '2000k'],
+})
+
+// Resize video - Scale to 720p
+await convertFile({
+  inFile: 'input.mp4',
+  outFile: 'output.mp4',
+  ffmpegArgs: ['-vf', 'scale=1280:720'],
+})
+
+// Extract audio - Convert video to MP3
+await convertFile({
+  inFile: 'input.mp4',
+  outFile: 'output.mp3',
+  ffmpegArgs: ['-vn', '-acodec', 'libmp3lame', '-ab', '192k'],
+})
+
+// Quality preset - Use H.264 with slow preset and CRF quality
+await convertFile({
+  inFile: 'input.mp4',
+  outFile: 'output.mp4',
+  ffmpegArgs: ['-c:v', 'libx264', '-preset', 'slow', '-crf', '23'],
+})
+```
+
+**Rotate video**:
+
+```typescript
+import { rotateVideo } from 'ffmpeg-progress'
+
+await rotateVideo({
+  inFile: 'test/in.mp4',
+  outFile: 'test/rotated.mp4',
+  angle: 90, // Rotate 90° clockwise (or 180, 270)
+})
+```
+
+Progress monitoring is also available similar to `convertFile` using `onDuration`, `onProgress`, etc.
+
 **Get video resolution**:
 
 ```typescript
@@ -51,6 +99,15 @@ console.log(await getVideoResolution('test/rotate.mp4'))
 // { width: 3024, height: 4032 }
 ```
 
+**Get video duration in seconds**:
+
+```typescript
+import { getVideoDuration } from 'ffmpeg-progress'
+
+console.log(await getVideoDuration('test/in.mp4'))
+// 15.04 (duration in seconds)
+```
+
 ## Typescript Types
 
 ```typescript
@@ -89,6 +146,16 @@ export function convertFile(
   args: {
     inFile: string
     outFile: string
+    ffmpegArgs?: string[]
+  } & ProgressArgs,
+): Promise<void>
+
+export function rotateVideo(
+  args: {
+    inFile: string
+    outFile: string
+    /** degrees to rotate in clockwise direction */
+    angle: 90 | 180 | 270
   } & ProgressArgs,
 ): Promise<void>
 
@@ -107,6 +174,9 @@ export function getVideoResolution(video_file: string): Promise<{
   width: number
   height: number
 }>
+
+/** @description get video duration in seconds, e.g. `15.04` */
+export async function getVideoDuration(video_file: string): Promise<number>
 ```
 
 ## License

package/core.d.ts

@@ -43,6 +43,14 @@ export type OnProgressArgs = {
 export declare function convertFile(args: {
     inFile: string;
     outFile: string;
+    /** e.g. ['-c:v', 'libx264', '-pix_fmt', 'yuv420p', '-b:v', '2000k'] */
+    ffmpegArgs?: string[];
+} & ProgressArgs): Promise<void>;
+export declare function rotateVideo(args: {
+    inFile: string;
+    outFile: string;
+    /** degrees to rotate in clockwise direction */
+    angle: 90 | 180 | 270;
 } & ProgressArgs): Promise<void>;
 export declare function attachChildProcess(args: {
     childProcess: ChildProcessWithoutNullStreams;
@@ -62,3 +70,5 @@ export declare function getVideoResolution(video_file: string): Promise<{
     width: number;
     height: number;
 }>;
+/** @description get video duration in seconds, e.g. `15.04` */
+export declare function getVideoDuration(video_file: string): Promise<number>;

package/core.js

@@ -5,9 +5,11 @@ exports.secondsToString = secondsToString;
 exports.parseVideoMetadata = parseVideoMetadata;
 exports.scanVideo = scanVideo;
 exports.convertFile = convertFile;
+exports.rotateVideo = rotateVideo;
 exports.attachChildProcess = attachChildProcess;
 exports.estimateOutSize = estimateOutSize;
 exports.getVideoResolution = getVideoResolution;
+exports.getVideoDuration = getVideoDuration;
 const child_process_1 = require("child_process");
 const promises_1 = require("fs/promises");
 const path_1 = require("path");
@@ -135,9 +137,37 @@ function scanVideo(file) {
     });
 }
 async function convertFile(args) {
-    let childProcess = (0, child_process_1.spawn)('ffmpeg', ['-y', '-i', args.inFile, args.outFile]);
+    let ffmpegCommand = ['-y', '-i', args.inFile];
+    if (args.ffmpegArgs) {
+        ffmpegCommand.push(...args.ffmpegArgs);
+    }
+    ffmpegCommand.push(args.outFile);
+    let childProcess = (0, child_process_1.spawn)('ffmpeg', ffmpegCommand);
     return attachChildProcess({ childProcess, ...args });
 }
+async function rotateVideo(args) {
+    let filter;
+    switch (args.angle) {
+        case 90:
+            // 90° clockwise
+            filter = 'transpose=1';
+            break;
+        case 180:
+            // 180° rotation
+            filter = 'transpose=1,transpose=1';
+            break;
+        case 270:
+            // 270° clockwise (or 90° counterclockwise)
+            filter = 'transpose=2';
+            break;
+        default:
+            throw new Error(`Unsupported rotation angle: ${args.angle}. Supported angles are 90, 180, or 270 degrees.`);
+    }
+    return convertFile({
+        ...args,
+        ffmpegArgs: ['-vf', filter, '-c:a', 'copy'],
+    });
+}
 async function attachChildProcess(args) {
     let { code, signal } = await new Promise((resolve, reject) => {
         let { childProcess } = args;
@@ -232,6 +262,27 @@ async function getVideoResolution(video_file) {
     await (0, promises_1.unlink)(image_file);
     return resolution;
 }
+/** @description get video duration in seconds, e.g. `15.04` */
+async function getVideoDuration(video_file) {
+    let childProcess = (0, child_process_1.spawn)('ffprobe', [
+        '-v',
+        'error',
+        '-show_entries',
+        'format=duration',
+        '-of',
+        'default=noprint_wrappers=1:nokey=1',
+        video_file,
+    ]);
+    var { stdout, stderr, code, signal } = await waitChildProcess(childProcess);
+    if (code != 0) {
+        throw new Error(`ffprobe exit abnormally, exit code: ${code}, signal: ${signal}, stdout: ${stdout}, stderr: ${stderr}`);
+    }
+    let duration = +stdout;
+    if (!duration) {
+        throw new Error('failed to parse video duration: ' + JSON.stringify(stdout));
+    }
+    return duration;
+}
 function waitChildProcess(childProcess) {
     return new Promise((resolve, reject) => {
         let stdout = '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ffmpeg-progress",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Extract progress from ffmpeg child_process",
   "keywords": [
     "ffmpeg",