videoshow

一个简单的 node.js 工具，用于基于图像创建直观的视频幻灯片，使用 ffmpeg，并具有额外功能，如音频、字幕和幻灯片之间的淡入淡出过渡。

入门可以查看示例、编程 API 和命令行界面。

videoshow 在生产环境中使用，每月渲染数千个视频。

点击图片查看由 videoshow 生成的示例视频：

要求

ffmpeg 带有额外的编译标志 --enable-libass --enable-libmp3lame

您可以从这里下载 ffmpeg 的静态构建版本。

如果您想在 Heroku 上使用 videoshow，可以使用 ffmpeg2 buildpack。

安装

npm install videoshow

对于命令行使用，将其作为全局包安装：

npm install -g videoshow

使用

注意：所有图像必须具有相同的尺寸。

以下是一个基于图像和音频生成视频的示例脚本。

查看编程 API和示例以获取更多使用详情。

var videoshow = require('videoshow')

var images = [
  'step1.jpg',
  'step2.jpg',
  'step3.jpg',
  'step4.jpg'
]

var videoOptions = {
  fps: 25,
  loop: 5, // 秒
  transition: true,
  transitionDuration: 1, // 秒
  videoBitrate: 1024,
  videoCodec: 'libx264',
  size: '640x?',
  audioBitrate: '128k',
  audioChannels: 2,
  format: 'mp4',
  pixelFormat: 'yuv420p'
}

videoshow(images, videoOptions)
  .audio('song.mp3')
  .save('video.mp4')
  .on('start', function (command) {
    console.log('ffmpeg 进程已启动:', command)
  })
  .on('error', function (err, stdout, stderr) {
    console.error('错误:', err)
    console.error('ffmpeg stderr:', stderr)
  })
  .on('end', function (output) {
    console.error('视频已创建于:', output)
  })

命令行界面

$ videoshow --help

轻松从图像创建视频幻灯片
用法: bin/videoshow [选项]

选项:
  --help, -h       显示帮助
  --config, -c     JSON 配置文件路径 [必需]
  --audio, -a      可选音频文件路径
  --subtitles, -s  .srt 字幕文件路径
  --input, -i      向视频添加额外输入
  --output, -o     输出视频文件路径
  --size, -x       视频尺寸分辨率
  --logo, -l       logo 图像路径
  --debug, -d      在错误情况下启用调试模式

示例:
  bin/videoshow -c config.json video.mp4
  bin/videoshow -c config.json --audio song.mp3 video.mp4
  bin/videoshow -c config.json --audio song.mp3 --logo logo.png video.mp4

示例 config.json 文件：

{
  "output": "video.mp4",
  "options": {
    "fps": 25,
    "loop": 5,
    "transition": true,
    "transitionDuration": 1,
    "videoBitrate": 1024,
    "videoCodec": "libx264",
    "size": "640x?",
    "audioBitrate": "128k",
    "audioChannels": 2,
    "format": "mp4",
    "subtitleStyles": {
      "Fontname": "Verdana",
      "Fontsize": "26",
      "PrimaryColour": "11861244",
      "SecondaryColour": "11861244",
      "TertiaryColour": "11861244",
      "BackColour": "-2147483640",
      "Bold": "2",
      "Italic": "0",
      "BorderStyle": "2",
      "Outline": "2",
      "Shadow": "3",
      "Alignment": "1",
      "MarginL": "40",
      "MarginR": "60",
      "MarginV": "40"
    }
  },
  "images": [
    "./test/fixtures/step_1.png",
    "./test/fixtures/step_2.png",
    "./test/fixtures/step_3.png",
    "./test/fixtures/step_4.png",
    "./test/fixtures/step_5.png"
  ]
}

API

`videoshow(images, [ options ])`

返回：Videoshow

Videoshow 构造函数。您应该传入一个 array<string> 或 array<object> 或 array<ReadableStream> 包含所需的图像，并可选地为每个图像传入视频渲染 options 对象。

支持的图像格式有：jpg、png 或 bmp。

videoshow([ 'image1.jpg', 'image2.jpg', 'image3.jpg'])
  .save('video.mp4')
  .on('error', function () {})
  .on('end', function () {})

images 参数也可以是一个集合：

videoshow([{
    path: 'image1.jpg',
    caption: '作为视频字幕的 Hello world'
  }, {
    path: 'image2.jpg',
    caption: '这是一个示例字幕',
    loop: 10 // 长字幕
  }])
  .save('video.mp4')
  .on('error', function () {})
  .on('end', function () {})

视频选项

您可以将任何 fluent-ffmpeg 允许的方法名称定义为选项

默认选项为：

{
  fps: 25,
  loop: 5, // 秒
  transition: true,
  transitionDuration: 1,
  captionDelay: 1000,
  useSubRipSubtitles: false,
  subtitleStyle: null,
  videoBitrate: 1024,
  videoCodec: 'libx264',
  size: '640x?',
  audioBitrate: '128k',
  audioChannels: 2,
  format: 'mp4'
}