ffmpeg-progress 1.5.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
@@ -98,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>
 

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;

package/core.js

@@ -5,6 +5,7 @@ exports.secondsToString = secondsToString;
 exports.parseVideoMetadata = parseVideoMetadata;
 exports.scanVideo = scanVideo;
 exports.convertFile = convertFile;
+exports.rotateVideo = rotateVideo;
 exports.attachChildProcess = attachChildProcess;
 exports.estimateOutSize = estimateOutSize;
 exports.getVideoResolution = getVideoResolution;
@@ -136,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;

package/package.json

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