editly下載 - editly源代碼下載

editly

其他資源

v0.14.2

下載

編輯是使用node.js和ffmpeg的聲明性NLE（非線性視頻編輯）的工具和框架。編輯允許您輕鬆，編程地從一組剪輯，圖像，音頻和標題中創建視頻，並具有平穩的過渡和音樂疊加。

編輯有一個簡單的CLI，可快速從一組剪輯或圖像中組裝視頻，或者您可以使用其更靈活的JavaScript API。

受FFMPEG-CONCAT的啟發，編輯速度更快，並且不需要太多存儲，因為它使用了流編輯。編輯的目的是非常可擴展，並具有富含可插入的接口，可添加新的動態內容。

此gif / youtube是使用此命令創建的：“ editly communfeatures.json5”。在此處查看更多示例。

特徵

用代碼編輯視頻！？
聲明性的API帶有有趣的默認
創建具有由美學上令人愉悅的調色板和隨機效果產生的隨機顏色的彩色視頻
支持任何輸入大小，例如4K視頻和數碼單反相機照片
可以輸出到任何維度和縱橫比，例如Instagram帖子（1：1）， Instagram故事（9:16）， YouTube （16：9）或您喜歡的任何其他維度。
即使輸入縱橫比不相同，並且將轉換內容，並且將自動縮放內容並自動箱。
自動加速 /放慢視頻，以使每個剪輯的duration匹配cutFrom / cutTo段長度
視頻，圖像或背景上的覆蓋文字和字幕
接受自定義html5 canvas / fabric.js javascript代碼的自定義屏幕或動態覆蓋
渲染自定義的GL著色器（例如Shadertoy的）
可以輸出GIF
覆蓋透明的圖像，甚至是Alpha頻道的視頻
顯示夾子持續時間（B卷）的不同子剪接
圖片中的圖片
小插圖
保存/混合多個音頻源
自動音頻交叉裝飾
自動音頻鴨子和歸一化

用例

從一組帶有文本覆蓋的圖片創建幻燈片
創建快節奏的預告片或促銷視頻
創建一個帶有幫助文本的教程視頻
創建新聞故事
創建動畫gif
將視頻大小調整到任何大小或幀速率，並帶有自動信箱/裁剪（例如，如果您需要在某處上傳視頻，但是網站抱怨Video must be 1337x1000 30fps ）
創建一個帶有多個混合曲目的播客

見示例

要求

Windows，MacOS或Linux
安裝了Node.js（建議使用最新的LTS版本，v12.16.2或MacOS上的較新。）
ffmpeg （和ffprobe ）已安裝並在PATH中可用
（Linux）可能需要一些額外的步驟。請參閱無頭GL。
現在僅編輯是ESM

安裝

npm i -g editly

用法：命令行視頻編輯器

editly --help使用

用音頻曲目從視頻，圖像和文本中創建一個簡單的隨機視頻編輯：

editly 
  title: ' My video ' 
  clip1.mov 
  clip2.mov 
  title: ' My slideshow ' 
  img1.jpg 
  img2.jpg 
  title: ' THE END ' 
  --fast 
  --audio-file-path /path/to/music.mp3

或從JSON或JSON5編輯規範創建MP4（或GIF） （JSON5只是一種更易於用戶友好的JSON格式） ：

editly my-spec.json5 --fast --keep-source-audio --out output.gif

有關如何製作JSON編輯規範的示例，請參見下文或示例。

沒有--fast ，它將默認使用第一個輸入視頻中使用寬度，高度和幀速率。所有其他剪輯將轉換為這些維度。您當然可以覆蓋任何或全部這些參數。

提示：將此工具與LosslessCut結合使用
提示：如果您需要吸引人的視頻音樂，請查看此YouTube或YouTube音頻庫。然後使用youtube-dl下載視頻，然後在視頻文件上指向--audio-file-path 。一定要尊重他們的許可證！

JavaScript庫

 import editly from 'editly' ;

// See editSpec documentation
await editly ( editSpec )

編輯規格

編輯規格是JavaScript / JSON對象，描述了具有以下結構的整個編輯操作：

 {
  outPath ,
  width ,
  height ,
  fps ,
  allowRemoteRequests : false ,
  defaults : {
    duration : 4 ,
    transition : {
      duration : 0.5 ,
      name : 'random' ,
      audioOutCurve : 'tri' ,
      audioInCurve : 'tri' ,
    } ,
    layer : {
      fontPath ,
      // ...more layer defaults
    } ,
    layerType : {
      'fill-color' : {
        color : '#ff6666' ,
      }
      // ...more per-layer-type defaults
    } ,
  } ,
  clips : [
    {
      transition ,
      duration ,
      layers : [
        {
          type ,
          // ...more layer-specific options
        }
        // ...more layers
      ] ,
    }
    // ...more clips
  ] ,
  audioFilePath ,
  loopAudio : false ,
  keepSourceAudio : false ,
  clipsAudioVolume : 1 ,
  outputVolume : 1 ,
  audioTracks : [
    {
      path ,
      mixVolume : 1 ,
      cutFrom : 0 ,
      cutTo ,
      start : 0 ,
    } ,
    // ...more audio tracks
  ] ,
  audioNorm : {
    enable : false ,
    gaussSize : 5 ,
    maxGain : 30 ,
  }

  // Testing options:
  enableFfmpegLog : false ,
  verbose : false ,
  fast : false ,
}

參數

範圍	等效的CLI	描述	預設
`outPath`	`--out`	輸出路徑（MP4，MKV）也可以是`.gif`
`width`	`--width`	所有媒體將轉換為	`640`
`height`	`--height`	所有媒體將轉換為的高度	根據第一個視頻的`width`和縱橫比的自動
`fps`	`--fps`	FPS所有視頻將轉換為	第一個視頻FPS或`25`
`customOutputArgs`		為FFMPEG指定自定義輸出編解碼器/格式參數（請參閱示例）	自動（H264）
`allowRemoteRequests`	`--allow-remote-requests`	允許遠程URL作為路徑	`false`
`fast`	`--fast` ， `-f`	快速模式（低分辨率和FPS，可用於獲得快速預覽⏩）	`false`
`defaults.layer.fontPath`	`--font-path`	將默認字體設置為.ttf	系統字體
`defaults.layer.*`		設置所有圖層都將繼承的任何圖層參數
`defaults.duration`	`--clip-duration`	設置沒有自己持續時間的剪輯的默認剪輯持續時間	`4`	秒
`defaults.transition`		描述默認過渡的對象`{ name, duration }` 。設置為null以禁用過渡
`defaults.transition.duration`	`--transition-duration`	默認過渡持續時間	`0.5`	秒
`defaults.transition.name`	`--transition-name`	默認過渡類型。請參閱過渡類型	`random`
`defaults.transition.audioOutCurve`		音頻交叉中的默認淡出曲線淡出	`tri`
`defaults.transition.audioInCurve`		音頻交叉中曲線中的默認淡出淡出	`tri`
`clips[]`		將按順序播放的夾子對象列表。每個夾子可以具有一個或多個層。
`clips[].duration`		剪輯持續時間。請參閱`defaults.duration` 。如果尚不確定，則剪輯持續時間將是第一個視頻層的持續時間。	`defaults.duration`
`clips[].transition`		在此剪輯的末尾指定過渡。請參閱`defaults.transition`	`defaults.transition`
`clips[].layers[]`		當前夾中的層列表將以自然順序覆蓋（最終層）
`clips[].layers[].type`		圖層類型，見下文
`clips[].layers[].start`		該層的片段什麼時間開始		秒
`clips[].layers[].stop`		剪輯什麼時間應停止		秒
`audioTracks[]`		任意音軌列表。請參閱音軌。	`[]`
`audioFilePath`	`--audio-file-path`	為整個視頻設置音軌。另請參閱音軌
`loopAudio`	`--loop-audio`	循環音軌是否比視頻短？	`false`
`keepSourceAudio`	`--keep-source-audio`	保留`clips`的源音頻？	`false`
`clipsAudioVolume`		`clips`相對於`audioTracks`的音頻音量量。請參閱音軌。	`1`
`outputVolume`	`--output-volume`	調整輸出量（最終階段）。請參見示例	`1`	例如`0.5`或`10dB`
`audioNorm.enable`		啟用音頻歸一化？請參閱音頻歸一化。	`false`
`audioNorm.gaussSize`		音頻歸一化高斯尺寸。請參閱音頻歸一化。	`5`
`audioNorm.maxGain`		音頻歸一化最大增益。請參閱音頻歸一化。	`30`

過渡類型

transition.name可以是任何GL-過渡中的任何一個，也可以是以下任何一個： directional-left ， directional-right ， directional-up ， directional-down ， random或dummy 。

層類型

請參閱示例和commonFeatures.json5

圖層類型“視頻”

對於視頻層，如果指定了parent clip.duration ，則視頻將放慢/加速以匹配clip.duration 。如果設置了cutFrom / cutTo ，則將結果段（ cutTo cutFrom ）放慢 /加速以擬合clip.duration 。如果圖層具有音頻，則將保留（並與其他音頻層混合。）

範圍	描述	預設
`path`	視頻文件的路徑
`resizeMode`	請參閱調整大小模式
`cutFrom`	縮短的時間價值	`0`	秒
`cutTo`	剪切的時間價值	視頻的結尾	秒
`width`	相對於屏幕寬度的寬度	`1`	`0`到`1`
`height`	高度相對於屏幕高度	`1`	`0`到`1`
`left`	X位相對於屏幕寬度	`0`	`0`到`1`
`top`	Y位置相對於屏幕高度	`0`	`0`到`1`
`originX`	X錨	`left`	`left`
`originY`	y錨	`top`	`top`或`bottom`
`mixVolume`	將該視頻的音軌與他人混合時相對量	`1`

層類型“音頻”

音頻層將混合在一起。如果設置了cutFrom / cutTo ，則將結果段（ cutTo cutFrom ）放慢 /加速以擬合clip.duration 。減速/加速操作限於0.5x至100x之間的值。

範圍	描述	預設
`path`	音頻文件的路徑
`cutFrom`	縮短的時間價值	`0`	秒
`cutTo`	剪切的時間價值	`clip.duration`	秒
`mixVolume`	將此音軌與他人混合時相對體積	`1`

層類型的“分離aaudio”

這是audioTracks的一種特殊情況，可以使啟動音頻相對於clips的啟動時間變得更加容易，而無需計算全球啟動時間。

detached-audio具有與Audiotracks完全相同的屬性，除了start時間相對於剪輯的開始。

獨立音軌的示例

圖層類型“圖像”

全屏圖像

範圍	描述	預設
`path`	圖像文件的路徑
`resizeMode`	請參閱調整大小模式

另請參見Ken Burns參數。

圖層類型“圖像反射”

在屏幕上具有自定義位置和大小的圖像覆蓋層。注意：如果要使用動畫gifs，請改用video 。

範圍	描述	預設
`path`	圖像文件的路徑
`position`	請參閱位置參數
`width`	寬度（從0到1）其中1是屏幕寬度
`height`	高度（從0到1），其中1是屏幕高度

另請參見Ken Burns參數。

圖層類型“標題”

fontPath請參閱defaults.layer.fontPath
text - 標題文本要顯示，簡短
textColor默認#ffffff
position - 請參閱位置參數

另請參閱Ken Burns參數

圖層類型的“字幕”

fontPath請參閱defaults.layer.fontPath
text - 要顯示的字幕文字
textColor默認#ffffff

層類型的“標題 - 背景”

帶有背景的標題

text - 請參閱類型title
textColor請參閱類型title
background - { type, ... } - 請參閱類型radial-gradient ， linear-gradient或fill-color
fontPath請參閱類型title

層類型的“新聞標題”

fontPath請參閱defaults.layer.fontPath
text
textColor默認#ffffff
backgroundColor - 默認#d02a42
position - 請參閱位置參數

圖層類型“文本幻燈片”

fontPath請參閱defaults.layer.fontPath
text
fontSize
charSpacing
color
position - 請參閱位置參數

層類型的“填充色”，“暫停”

color - 填充背景的顏色，默認值：隨機化

層類型“徑向梯度”

colors - 兩種顏色的數組，默認值：隨機化

層類型“線性梯度”

colors - 兩種顏色的數組，默認值：隨機化

層類型的“彩虹色”

???

層類型的“畫布”

請參閱CustomCanvas.js

func自定義JavaScript功能

層類型的“織物”

請參閱CustomFabric.js

func自定義JavaScript功能

層類型“ GL”

加載GLSL著色器。請參閱GL.JSON5和Rainbow-Colors.Frag

fragmentPath
vertexPath （可選）

任意音軌

audioTracks屬性可以選擇包含一個對象列表，這些對象指定音頻軌道可以在最終視頻中的任意時間啟動。這些軌道將混合在一起（ mixVolume指定每個曲目與其他軌道的相對數字）。由於clips的音頻將與audioTracks分開混合，因此clipsAudioVolume指定了clips中的組合音頻相對於audioTracks的每個音軌的音量的組合音量。

範圍	描述	預設
`audioTracks[].path`	此軌道的文件路徑
`audioTracks[].mixVolume`	此曲目的相對體積	`1`
`audioTracks[].cutFrom`	從剪切源文件從	`0`	秒
`audioTracks[].cutTo`	將源文件剪切到的時間值		秒
`audioTracks[].start`	啟動此音軌的視頻有多少秒	`0`	秒

audioTracks和層類型“音頻”之間的區別在於， audioTracks將繼續跨多個clips播放，並且可以在需要時開始和停止。

請參閱audioTracks示例

另請參見層類型的“分離audio” 。

音頻歸一化

您可以啟用最終輸出音頻的音頻歸一化。如果您想實現音頻鴨子（例如，當畫外音時，所有其他曲目的體積會自動降低）。

此處記錄了audioNorm參數。

音頻鴨子的示例

調整大小模式

resizeMode如何將圖像擬合到屏幕。可以是：

contain - 所有視頻將包含在框架內和信箱中
contain-blur喜歡contain ，但具有模糊的副本作為信箱
cover - 視頻裁剪以覆蓋整個屏幕（保留縱橫比）
stretch - 視頻將被拉伸以覆蓋整個屏幕（忽略寬高比）。

默認contain-blur 。

看：

image.json5
videos.json5

位置參數

某些層支持位置參數

position可以是：

top ， bottom center ， top-left ， top-right ， center-left ， center-right ， bottom-left ， bottom-right
一個對象{ x, y, originX = 'left', originY = 'top' } ，其中{ x: 0, y: 0 }是屏幕的左上角， { x: 1, y: 1 }是右下角， x是相對於視頻寬度， y到視頻高度。 originX和originY是可選的，並指定對象的位置的原點（錨定位）。

請參閱位置。 JSON5

肯·伯恩斯參數

範圍	描述	預設
`zoomDirection`	縮放方向的肯`left`伯恩斯效應： `in` ， `out` ， `right`或`null`以禁用
`zoomAmount`	ken burns效果的縮放金額	`0.1`

Docker

這應該可以幫助您編輯用作容器化的CLI，而不必擔心將所有正確版本的依賴項都帶到系統上。

$ git clone https://github.com/mifi/editly.git
$ cd editly/examples
$ git clone https://github.com/mifi/editly-assets.git assets
$ cd ..
$ docker-compose up
$ docker-compose run editly bash -c " cd examples && editly audio1.json5 --out /outputs/audio1.mp4 "
$ docker cp editly:/outputs/audio1.mp4 .

故障排除

如果收到Error: The specified module could not be found. ，嘗試： npm un -g editly && npm i -g --build-from-source editly （請參閱＃15）
如果您遇到有關GL返回空的錯誤，請參見要求。
如果您遇到錯誤/bin/sh: pkg-config: command not found ，請嘗試使用最新的node.js lts版本