@marcuth/movie.js 0.1.2 → 0.2.0

package/README.md

@@ -0,0 +1,164 @@
+# Movie.js
+
+**Movie.js** is a library built on top of `fluent-ffmpeg` designed to create templates for generating standardized videos with data—which can be static or dynamic. It simplifies the process of sequencing video, image, and audio clips into a final composition.
+
+## 📦 Installation
+
+Installation is straightforward; just use your preferred package manager. Here is an example using NPM:
+
+```bash
+npm i @marcuth/movie.js
+```
+
+> **Note:** You must have FFMPEG installed on your system for this library to work.
+
+## 🚀 Usage
+
+<a href="https://www.buymeacoffee.com/marcuth">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="200">
+</a>
+
+### Template
+
+The foundation for creating videos in Movie.js is the `Template`. This is where you define your clips and configuration.
+
+```ts
+import movie from "@marcuth/movie.js"
+
+type RenderData = {
+    heroImage: string
+    backgroundVideo: string
+} 
+
+const template = movie.template<RenderData>({
+    config: {
+        format: "mp4",
+        fps: 30,
+        outputOptions: ["-preset ultrafast"] // optional ffmpeg output options
+    },
+    clips: [
+        // ... your clips here
+    ]
+})
+
+// Render the template with data
+const result = await template.render({
+    heroImage: "/path/to/image.png",
+    backgroundVideo: "/path/to/video.mp4"
+})
+
+// Save the result
+result.save("output.mp4")
+```
+
+---
+
+### Clips
+
+Clips are the building blocks of your video. They represent individual media segments like videos, images, or audio tracks.
+
+Most file paths in clips support dynamic resolution:
+```ts
+path: ({ data, index }) => data.myPath
+```
+
+#### VideoClip
+
+To insert a video segment:
+
+```ts
+movie.video({
+    path: "assets/intro.mp4",
+    fadeIn: 1, // seconds
+    fadeOut: 1, // seconds
+    subClip: [0, 5] // [start, duration] - Clip from 0s to 5s
+})
+```
+
+#### ImageClip
+
+To insert an image with optional scrolling/Ken Burns effect:
+
+```ts
+movie.image({
+    path: ({ data }) => data.heroImage,
+    duration: 5, // seconds
+    width: 1920, // force resize width
+    height: 1080, // force resize height
+    scroll: {
+        axis: "y", // "x", "y", or "auto"
+        direction: "forward",
+        easing: "easeInOut"
+    },
+    fadeIn: 0.5
+})
+```
+
+#### AudioClip
+
+To add audio (background music, sound effects):
+
+```ts
+movie.audio({
+    path: "assets/music.mp3",
+    volume: 0.5,
+    fadeIn: 2,
+    fadeOut: 2
+})
+```
+
+---
+
+### Structural Clips
+
+#### RepeatClip
+
+If you need to loop over an array of data to generate clips:
+
+```ts
+movie.repeat({
+    each: ({ data }) => data.items, // Array of items
+    clip: (item, index) => movie.video({
+        path: item.videoPath
+    })
+})
+```
+
+#### CompositionClip
+
+Group multiple clips together. Useful for organizing sequences:
+
+```ts
+movie.composition({
+    clips: [
+        movie.video({ ... }),
+        movie.video({ ... })
+    ]
+})
+```
+
+#### ConcatenationClip
+
+Explicitly concatenate a list of clips:
+
+```ts
+movie.concatenation({
+    clips: [ ... ]
+})
+```
+
+---
+
+## 🤝 Contributing
+
+Want to contribute? Follow these steps:
+
+1. Fork the repository.
+2. Create a new branch (`git checkout -b feature-new`).
+3. Commit your changes (`git commit -m 'Add new feature'`).
+4. Push to the branch (`git push origin feature-new`).
+5. Open a Pull Request.
+
+## 📝 License
+
+This project is licensed under the MIT License.

package/dist/clips/image-clip.d.ts

@@ -1,3 +1,4 @@
+import ffmpeg from "fluent-ffmpeg";
 import { Path } from "../utils/resolve-path";
 import { RenderContext } from "../render-context";
 import { FFmpegInput } from "../ffmpeg-input";
@@ -29,5 +30,6 @@ export declare class ImageClip<RenderData> extends Clip<RenderData> {
     };
     constructor({ duration, path, width, height, fadeIn, fadeOut, scroll }: ImageClipOptions<RenderData>);
     protected getInput(path: string, inputIndex: number, fps: number): FFmpegInput;
-    build(data: RenderData, context: RenderContext): void;
+    protected getMetadata(path: string): Promise<ffmpeg.FfprobeData>;
+    build(data: RenderData, context: RenderContext): Promise<void>;
 }

package/dist/clips/image-clip.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImageClip = void 0;
+const fluent_ffmpeg_1 = require("fluent-ffmpeg");
 const resolve_path_1 = require("../utils/resolve-path");
-const clip_1 = require("./clip");
 const easing_expr_1 = require("../utils/easing-expr");
+const clip_1 = require("./clip");
 class ImageClip extends clip_1.Clip {
     constructor({ duration, path, width, height, fadeIn, fadeOut, scroll }) {
         super();
@@ -31,11 +32,17 @@ class ImageClip extends clip_1.Clip {
             ]
         };
     }
-    build(data, context) {
+    getMetadata(path) {
+        return new Promise((resolve, reject) => {
+            (0, fluent_ffmpeg_1.ffprobe)(path, (err, data) => err ? reject(err) : resolve(data));
+        });
+    }
+    async build(data, context) {
         const path = (0, resolve_path_1.resolvePath)({ path: this.path, data: data, index: context.clipIndex });
         const input = this.getInput(path, context.inputIndex, context.fps);
         let currentVideoOutput = input.aliases.video;
         const currentAudioOutput = input.aliases.audio;
+        const metadata = await this.getMetadata(path);
         context.command
             .input(input.path)
             .inputOptions(input.options);
@@ -54,9 +61,12 @@ class ImageClip extends clip_1.Clip {
         const hasCanvas = this.width !== -1 || this.height !== -1;
         if (hasCanvas && this.scroll) {
             const scaleOutput = `scale${context.inputIndex}`;
-            const { axis = "auto" } = this.scroll;
+            let { axis = "auto" } = this.scroll;
             let scaleOptions = null;
-            if (axis === "y" || axis === "auto") {
+            if (axis === "auto") {
+                axis = metadata.format.width > metadata.format.height ? "x" : "y";
+            }
+            if (axis === "y") {
                 scaleOptions = {
                     w: this.width,
                     h: -1,
@@ -69,7 +79,7 @@ class ImageClip extends clip_1.Clip {
                 };
             }
             if (!scaleOptions) {
-                throw new Error("Invalid scale options");
+                throw new Error("Invalid scroll axis");
             }
             context.filters.push({
                 filter: "scale",
@@ -77,7 +87,14 @@ class ImageClip extends clip_1.Clip {
                 inputs: currentVideoOutput,
                 outputs: scaleOutput,
             });
-            currentVideoOutput = scaleOutput;
+            const setsarOutput = `setsar${context.inputIndex}`;
+            context.filters.push({
+                filter: "setsar",
+                options: { sar: "1/1" },
+                inputs: scaleOutput,
+                outputs: setsarOutput,
+            });
+            currentVideoOutput = setsarOutput;
         }
         else if (hasCanvas && !this.scroll) {
             const scaleOutput = `scale${context.inputIndex}`;

package/dist/clips/video-clip.d.ts

@@ -6,12 +6,14 @@ export type VideoClipOptions<RenderData> = {
     path: Path<RenderData>;
     fadeIn?: number;
     fadeOut?: number;
+    subClip?: [number, number];
 };
 export declare class VideoClip<RenderData> extends Clip<RenderData> {
     readonly path: Path<RenderData>;
     readonly fadeIn?: number;
     readonly fadeOut?: number;
-    constructor({ path, fadeIn, fadeOut }: VideoClipOptions<RenderData>);
+    readonly subClip?: [number, number];
+    constructor({ path, fadeIn, fadeOut, subClip }: VideoClipOptions<RenderData>);
     protected getInput(path: string, inputIndex: number): FFmpegInput;
     getDuration(path: string): Promise<number>;
     build(data: RenderData, context: RenderContext): Promise<void>;

package/dist/clips/video-clip.js

@@ -5,11 +5,12 @@ const fluent_ffmpeg_1 = require("fluent-ffmpeg");
 const resolve_path_1 = require("../utils/resolve-path");
 const clip_1 = require("./clip");
 class VideoClip extends clip_1.Clip {
-    constructor({ path, fadeIn, fadeOut }) {
+    constructor({ path, fadeIn, fadeOut, subClip }) {
         super();
         this.path = path;
         this.fadeIn = fadeIn;
         this.fadeOut = fadeOut;
+        this.subClip = subClip;
     }
     getInput(path, inputIndex) {
         return {
@@ -37,8 +38,13 @@ class VideoClip extends clip_1.Clip {
         const input = this.getInput(path, context.inputIndex);
         let currentVideoOutput = input.aliases.video;
         let currentAudioOutput = input.aliases.audio;
-        const duration = await this.getDuration(path);
+        let duration = await this.getDuration(path);
         context.command.input(path);
+        if (this.subClip) {
+            const [start, subDuration] = this.subClip;
+            context.command.inputOptions([`-ss ${start}`, `-t ${subDuration}`]);
+            duration = subDuration;
+        }
         if (this.fadeIn !== undefined && this.fadeIn > 0) {
             const fadeInOutput = `[fadeIn${context.inputIndex}]`;
             const fadeInAudioOutput = `[fadeInAudio${context.inputIndex}]`;

package/dist/template.js

@@ -53,18 +53,6 @@ class Template {
             mixFilter,
             finalAudioFilter
         ].filter((filter) => filter !== null);
-        // console.dir({
-        //     concatFilter,
-        //     finalAudioFilter,
-        //     mixFilter,
-        //     filterComplex,
-        //     context: {
-        //         ...context,
-        //         command: "<command>"
-        //     }
-        // }, {
-        //     depth: null
-        // })
         command.complexFilter(filterComplex);
         command.outputOptions([
             "-map [outv]",

package/dist/utils/easing-expr.js

@@ -4,13 +4,13 @@ exports.easingExpr = easingExpr;
 function easingExpr(easing, t) {
     switch (easing) {
         case "linear":
-            return `(${t})`; // Adicionar parênteses para garantir que a expressão seja avaliada
+            return `(${t})`;
         case "easeIn":
             return `pow(${t},2)`;
         case "easeOut":
-            return `1-pow(1-(${t}),2)`; // Adicionar parênteses extras
+            return `1-pow(1-(${t}),2)`;
         case "easeInOut":
-            return `if(lt(${t},0.5),2*pow(${t},2),1-2*pow(1-(${t}),2))`; // Adicionar parênteses extras
+            return `if(lt(${t},0.5),2*pow(${t},2),1-2*pow(1-(${t}),2))`;
         default:
             return `(${t})`;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marcuth/movie.js",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Video template builder",
   "main": "./dist/index.js",
   "module": "./dist/index.js",