ffmpeg-framecraft 1.0.0

package/src/presets/presets.js

@@ -0,0 +1,105 @@
+/**
+ * Platform and workflow presets for video processing.
+ * Use these with FramecraftEngine for consistent output across YouTube Shorts, TikTok, etc.
+ *
+ * @example
+ * const { youtubeShortPreset } = require('./presets/presets');
+ * engine.slicesWithTransitions(input, output, {
+ *   slices: [...],
+ *   transition: youtubeShortPreset.transition
+ * });
+ */
+
+/** @constant {object} YouTube Shorts preset */
+const youtubeShortPreset = {
+  aspectRatio: '9:16',
+  resolution: '1080x1920',
+  width: 1080,
+  height: 1920,
+  subtitles: true,
+  watermark: true,
+  transition: 'fadeblack',
+  transitionDuration: 1,
+  videoCodec: 'libx264',
+  audioCodec: 'aac',
+  crf: 23,
+  audioBitrate: '128k',
+};
+
+/** @constant {object} TikTok preset */
+const tiktokPreset = {
+  aspectRatio: '9:16',
+  resolution: '1080x1920',
+  width: 1080,
+  height: 1920,
+  subtitles: true,
+  watermark: false,
+  transition: 'fade',
+  transitionDuration: 0.5,
+  videoCodec: 'libx264',
+  audioCodec: 'aac',
+  crf: 23,
+  audioBitrate: '128k',
+};
+
+/** @constant {object} Instagram Reels preset */
+const instagramReelsPreset = {
+  aspectRatio: '9:16',
+  resolution: '1080x1920',
+  width: 1080,
+  height: 1920,
+  subtitles: true,
+  watermark: false,
+  transition: 'dissolve',
+  transitionDuration: 0.5,
+  videoCodec: 'libx264',
+  audioCodec: 'aac',
+  crf: 23,
+  audioBitrate: '128k',
+};
+
+/** @constant {object} Generic vertical/shorts preset (720p, baseline compatibility) */
+const shortsPresetConfig = {
+  aspectRatio: '9:16',
+  resolution: '720x1280',
+  width: 720,
+  height: 1280,
+  subtitles: true,
+  watermark: false,
+  transition: 'fade',
+  transitionDuration: 0.5,
+  videoCodec: 'libx264',
+  profile: 'baseline',
+  level: '3.0',
+  audioCodec: 'aac',
+  crf: 23,
+  audioBitrate: '128k',
+};
+
+/** All platform presets keyed by name */
+const PLATFORM_PRESETS = {
+  youtubeShort: youtubeShortPreset,
+  tiktok: tiktokPreset,
+  instagramReels: instagramReelsPreset,
+  shorts: shortsPresetConfig,
+};
+
+/**
+ * Get a platform preset by name.
+ * @param {string} name - Preset name (youtubeShort, tiktok, instagramReels, shorts)
+ * @returns {object}
+ */
+function getPreset(name) {
+  const p = PLATFORM_PRESETS[name];
+  if (!p) throw new Error(`Unknown preset: ${name}. Use: ${Object.keys(PLATFORM_PRESETS).join(', ')}`);
+  return { ...p };
+}
+
+module.exports = {
+  youtubeShortPreset,
+  tiktokPreset,
+  instagramReelsPreset,
+  shortsPresetConfig,
+  PLATFORM_PRESETS,
+  getPreset,
+};

package/src/presets/shorts.js

@@ -0,0 +1,28 @@
+/**
+ * Shorts preset: 720x1280, H.264 baseline, AAC.
+ * Optimized for YouTube Shorts / TikTok / vertical video platforms.
+ */
+function outputOptions() {
+  return [
+    '-c:v',
+    'libx264',
+    '-preset',
+    'medium',
+    '-crf',
+    '23',
+    '-profile:v',
+    'baseline',
+    '-level',
+    '3.0',
+    '-movflags',
+    '+faststart',
+    '-c:a',
+    'aac',
+    '-b:a',
+    '128k',
+  ];
+}
+
+module.exports = {
+  outputOptions,
+};

package/src/presets/transitions.js

@@ -0,0 +1,49 @@
+/**
+ * Transition presets for use with slicesWithTransitions.
+ * Maps preset names to FFmpeg xfade transition types and default duration.
+ *
+ * @see https://ffmpeg.org/ffmpeg-filters.html#xfade
+ */
+const PRESETS = {
+  fade: { type: 'fade', duration: 0.5 },
+  fadeLong: { type: 'fade', duration: 1 },
+  wipeleft: { type: 'wipeleft', duration: 0.5 },
+  wiperight: { type: 'wiperight', duration: 0.5 },
+  wipeup: { type: 'wipeup', duration: 0.5 },
+  wipedown: { type: 'wipedown', duration: 0.5 },
+  slideleft: { type: 'slideleft', duration: 0.5 },
+  slideright: { type: 'slideright', duration: 0.5 },
+  slideup: { type: 'slideup', duration: 0.5 },
+  slidedown: { type: 'slidedown', duration: 0.5 },
+  circleopen: { type: 'circleopen', duration: 0.5 },
+  circleclose: { type: 'circleclose', duration: 0.5 },
+  rectcrop: { type: 'rectcrop', duration: 0.5 },
+  distance: { type: 'distance', duration: 0.5 },
+  fadeblack: { type: 'fadeblack', duration: 0.5 },
+  fadewhite: { type: 'fadewhite', duration: 0.5 },
+  radial: { type: 'radial', duration: 0.5 },
+  dissolve: { type: 'dissolve', duration: 0.5 },
+  pixelize: { type: 'pixelize', duration: 0.5 },
+  zoomin: { type: 'zoomin', duration: 0.5 },
+  zoomout: { type: 'zoomout', duration: 0.5 },
+};
+
+function getTransition(presetOrObject) {
+  if (typeof presetOrObject === 'string') {
+    const p = PRESETS[presetOrObject];
+    if (!p) throw new Error(`Unknown transition preset: ${presetOrObject}`);
+    return { ...p };
+  }
+  if (presetOrObject && typeof presetOrObject.type === 'string') {
+    return {
+      type: presetOrObject.type,
+      duration: presetOrObject.duration ?? 0.5,
+    };
+  }
+  return { type: 'fade', duration: 0.5 };
+}
+
+module.exports = {
+  PRESETS,
+  getTransition,
+};

package/src/utils.js

@@ -0,0 +1,16 @@
+const timeStringToSeconds = (timeString) => {
+  const [hours, minutes, seconds] = timeString.split(':').map(Number).map(num => num.toString().padStart(2, '0'));
+  return parseInt(hours) * 3600 + parseInt(minutes) * 60 + parseInt(seconds);
+};
+
+const secondsToTimeString = (seconds) => {
+  const hours = Math.floor(seconds / 3600);
+  const minutes = Math.floor((seconds % 3600) / 60);
+  const remainingSeconds = seconds % 60;
+  return `${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}:${remainingSeconds.toString().padStart(2, '0')}`;
+};
+
+module.exports = {
+  timeStringToSeconds,
+  secondsToTimeString,
+};