ffmprb 0.11.3 → 0.12.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: c1011479d8fbce69f1f6db17284beb628e4763e8
-  data.tar.gz: 2792b5f95252bb47b19da1754fb5a24ad5ae5593
+SHA256:
+  metadata.gz: 9dfd9dfa0902b6fa0f7e18655e385c11f968dfc73c51bc86a0828befffcdd039
+  data.tar.gz: 5c4721cbc6003848150dd8600939bf973dbd165b23177faeb38f1e7ed6444425
 SHA512:
-  metadata.gz: 71d990e9da83fabb642394b4bec672869acdd77fcf8be4dfb9453bfa84e0b9f053bac9f1b90178929416f124fcb184f7e3ecf2c561977585c8688d63f1f946ab
-  data.tar.gz: 49ba4dd23a6cd8e98484599414967e5a428e983bcbd5169fde989691507cc91cfea5bead3579f0c1e73affdac2c50707f230052552211791271385a0123f2b69
+  metadata.gz: 2317d3d31ea09d3eae1dcd999a141431cf6fd8394c322dc407c1f5088763d1e566863fe6d012b0b92d1920fb25ff8bb9bcace1b508ac3f2b13ab5454c380b3e8
+  data.tar.gz: 2e40d1a392823480757fe7e045a6ca1412f05f4af09ab5cf2d1e8133e066efb96a2d538dc67f2bf6747a1313917ca287554800c02ce97f92041d206a0febf7c4

data/Dockerfile

@@ -0,0 +1,18 @@
+FROM debian:bullseye
+
+RUN bash -ec 'apt update; apt -y install ruby-all-dev=1:2.7+2 ffmpeg=7:4.3.5-0+deb11u1 sox=14.4.2+git20190427-2 build-essential=12.9 libmagickwand-dev=8:6.9.11.60+dfsg-1.3 git=1:2.30.2-1 pkg-config=0.29.2-1'
+RUN gem install bundler -v '~> 2.0'
+
+WORKDIR /ffmprb
+
+COPY Gemfile Gemfile.lock ffmprb.gemspec ./
+COPY lib/ffmprb/version.rb ./lib/ffmprb/version.rb
+RUN bundle install
+COPY . .
+RUN gem build ffmprb.gemspec
+RUN gem install *.gem
+
+# TODO you know, whatever...
+WORKDIR /
+
+ENTRYPOINT ["ffmprb"]

data/Gemfile

@@ -3,4 +3,11 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in ffmprb.gemspec
 gemspec
 
-gem 'rspec_junit_formatter'  # for circleCI https://circleci.com/docs/test-metadata#automatic-test-metadata-collection
+gem 'byebug'
+gem 'simplecov'
+gem 'guard-rspec'
+gem 'guard-bundler'
+gem 'rake'
+gem 'rmagick', '~> 4.1'
+gem 'ruby-sox', '~> 0.0.3'
+gem 'firebase', '~> 0.2.8'

data/Gemfile.lock

@@ -0,0 +1,121 @@
+PATH
+  remote: .
+  specs:
+    ffmprb (0.12.1)
+      mkfifo (~> 0.1.1)
+      thor (~> 0.19.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.1)
+      public_suffix (>= 2.0.2, < 6.0)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    faraday (2.7.2)
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-net_http (3.0.2)
+    ffi (1.15.5)
+    firebase (0.2.8)
+      googleauth
+      httpclient (>= 2.5.3)
+      json
+    formatador (1.1.0)
+    googleauth (1.3.0)
+      faraday (>= 0.17.3, < 3.a)
+      jwt (>= 1.4, < 3.0)
+      memoist (~> 0.16)
+      multi_json (~> 1.11)
+      os (>= 0.9, < 2.0)
+      signet (>= 0.16, < 2.a)
+    guard (2.18.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.13.0)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-bundler (3.0.0)
+      bundler (>= 2.1, < 3)
+      guard (~> 2.2)
+      guard-compat (~> 1.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    httpclient (2.8.3)
+    json (2.6.3)
+    jwt (2.6.0)
+    listen (3.7.1)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    lumberjack (1.2.8)
+    memoist (0.16.2)
+    method_source (1.0.0)
+    mkfifo (0.1.1)
+    multi_json (1.15.0)
+    nenv (0.3.0)
+    notiffany (0.1.3)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    os (1.1.4)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (5.0.1)
+    rake (13.0.6)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rmagick (4.3.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.0)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    ruby-sox (0.0.3)
+    ruby2_keywords (0.0.5)
+    shellany (0.0.1)
+    signet (0.17.0)
+      addressable (~> 2.8)
+      faraday (>= 0.17.5, < 3.a)
+      jwt (>= 1.5, < 3.0)
+      multi_json (~> 1.10)
+    simplecov (0.21.2)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    thor (0.19.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  byebug
+  ffmprb!
+  firebase (~> 0.2.8)
+  guard-bundler
+  guard-rspec
+  rake
+  rmagick (~> 4.1)
+  ruby-sox (~> 0.0.3)
+  simplecov
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -1,13 +1,15 @@
 # ffmprb
 [![Gem Version](https://badge.fury.io/rb/ffmprb.svg)](http://badge.fury.io/rb/ffmprb)
-[![Circle CI](https://circleci.com/gh/showbox-oss/ffmprb.svg?style=svg)](https://circleci.com/gh/showbox-oss/ffmprb)
-## your audio/video montage pal, based on [ffmpeg](https://ffmpeg.org)
+## your audio/video manipulation pal, based on [ffmpeg](https://ffmpeg.org)
 
 A video and audio composing DSL (Damn-Simple Language) and a micro-engine for ffmpeg and ffriends (with CLI)
 
-If you're neither a video technologist, nor a video artist, you neither need cumbersome low level tools (like ffmpeg), nor heavy and costly high level tools (like Premiere).
+Any script-able person can manipulate video/audio media -- or automate such processing -- with ffmprb.
 
-Any script-able person can manipulate video/audio media -- or automate processing thereof -- with ffmprb.
+_ATTENTION_
+
+The actual usage currently depends on having ffmpeg v3.x installed in the system
+(ffmpeg v4.x has broken some of this gem's features), see the sample `./Dockerfile` for working containerisation.
 
 Allows for scripts like
 ```ruby
@@ -24,8 +26,28 @@ ffmpeg -y -noautorotate -i flick.mp4 -i track.mp3 -filter_complex "[0:v] fps=fps
 ```
 ...that's the idea, but there's much more to it.
 
-The docs, as well as any other part of this gem, are a work in progress.
-So you're very welcome to look around the [specs](https://github.com/showbox-oss/ffmprb/tree/master/spec) for the actual functionality coverage.
+The docs, more than other parts of this gem, are a work in progress.
+So, if you're really curious about using `ffmprb`, you have to check the [specs](https://github.com/costa/ffmprb/tree/master/spec) for the actual functionality coverage.
+A hint on the ideas you might find there: you can use constructs like
+```
+Ffmprb::File.temp_fifo('.flv') do |av_pipe|
+  thr = Thread.new do
+    Ffmprb.process(..., av_pipe) do |..., stream_output|
+      output(stream_output) do
+        ...
+      end
+    end
+  end
+  begin
+    Ffmprb.process(av_pipe, ...) do |stream_input, ...|
+      ...
+    end
+  ensure
+    thr.join
+  end
+end
+```
+in order to implement process pipelines.
 
 
 ## Installation
@@ -120,10 +142,12 @@ The `ffmprb` command-line utility expects a script on its standard input:
 ```ruby
 # episode_01.ffmprb
 
-# Play your _episode_ teaser snippet:
-lay input('episode_01.mov').cut(to: 60), transition: {blend: 3}
+output 'episode_01_tease.mpg' do
+  # Play your _episode_ teaser snippet:
+  lay input('episode_01.mov').cut(to: 60), transition: {blend: 3}
 
 ...
+end
 ```
 
     $ ffmprb < episode_01.ffmprb
@@ -133,20 +157,28 @@ And it can take parameters for the sake of automation convenience:
 
 ```ruby
 # episode_make.ffmprb
-|episode, logo, intro, badge, title, promo, credits, outro|
-
-# Play your _episode_ teaser snippet:
-lay input(episode).cut(to: 60), transition: {blend: 3}
+|episode, logo, intro, badge, title, promo, credits, outro, final|
 
-...
+output final do
+  # Play your _episode_ teaser snippet:
+  lay input(episode).cut(to: 60), transition: {blend: 1}
+  overlay input(logo).loop.cut(to: 24), after: 3, transition: {blend: 1}
+  lay input(intro).cut(to: 30), transition: {blend: 3}
+  lay input(title), transition: {blend: 1}
+  overlay input(badge), transition: {blend: 1}
+  lay input(episode).cut(from: 60), transition: {blend: 1}
+  lay input(promo).cut(from: 60), transition: {blend: 1}
+  lay input(credits), transition: {blend: 3}
+  lay input(outro), transition: {blend: 3}
+end
 ```
 
-    $ ffmprb ep01raw.mov logo.png intro.avi new_new.gif ep01tit.mov showbox_promo.mp4 ep01creds.avi ep01out.mov < episode_make.ffmprb
+    $ ffmprb ep01raw.mov logo.png intro.avi new_new.gif ep01tit.mov promo.mp4 ep01creds.avi ep01out.mov ep01.mpg < episode_make.ffmprb
 
 
 ### The defaults
 
-The defaults [defaults](https://github.com/showbox-oss/ffmprb/tree/master/lib/defaults.rb) are provided for every possible configuration option (optional options' defaults for the methods below in particular), you're welcome to config anything in your ffmprb scripts.
+The defaults [defaults](https://github.com/costa/ffmprb/tree/master/lib/defaults.rb) are provided for every possible configuration option (optional options' defaults for the methods below in particular), you're welcome to config anything in your ffmprb scripts.
 
 
 ### Advanced usage
@@ -167,7 +199,7 @@ naturally, the latter use the former:
 Ffmprb.process do
 
   in_main = input(av_input1)
-  output(av_output1, video: {resolution: Ffmprb::HD_720p, fps: 25}) do
+  output(av_output1, video: {resolution: HD_720p, fps: 25}) do
     lay in_main.crop(0.05), transition: {blend: 1}
   end
 
@@ -192,6 +224,10 @@ end
 
 ### Available reel modifier (filter) methods
 
+`audio`
+
+`audio` channels just the audio from the reel.
+
 `crop`({_ratio_ | {[top: _ratio_][, left: _ratio_][, bottom: _ratio_][, right: _ratio_][, width: _ratio_][, height: _ratio_]}})
 
 `crop` crops the reel frames (e.g. `in1.crop(0.1)` will remove 1/10th of the frame from each side)
@@ -206,6 +242,18 @@ end
 
 `mute`
 
+`pace`(_factor_)
+
+`pace` changes the reel speed by the given factor
+
+`pp`
+
+`pp` activates (some very simple) image postprocessing
+
+`reverse`
+
+`reverse` reverses the reel (works efficiently with small fragments only)
+
 `volume`(_ratio_)
 
 `volume` changes the volume proportionally to the source. `mute` mutes.
@@ -214,10 +262,6 @@ end
 
 `video` channels just the video from the reel.
 
-`audio`
-
-`audio` channels just the audio from the reel.
-
 `copy`(_reel_)
 
 `copy` copies the reel's modifier chain _onto_ the given reel.
@@ -269,7 +313,7 @@ follow these simple principles:
 
 ## Contributing
 
-1. Fork it ( https://github.com/showbox-oss/ffmprb/fork )
+1. Fork it ( https://github.com/costa/ffmprb/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)

data/bin/dev

@@ -0,0 +1,12 @@
+#!/bin/bash -e
+test "$#" -ne 0 && echo "Unsupported args: $@" >&2 && exit 145
+cd "$( dirname "${BASH_SOURCE[0]}" )"/..
+
+export COMPOSE_FILE=spec/docker-compose.yml
+export COMPOSE_PROJECT_NAME=ffmprb_dev
+
+docker-compose rm -svf
+
+docker-compose build --force-rm
+
+DEBUG=y docker-compose run --entrypoint bundle tester exec guard -p -y 3 -l 3 && docker-compose rm -svf || ( docker-compose logs && exit 1 )

data/bin/test

@@ -0,0 +1,13 @@
+#!/bin/bash -e
+cd "$( dirname "${BASH_SOURCE[0]}" )"/..
+
+test_to_run="$*"
+
+export COMPOSE_FILE=spec/docker-compose.yml
+export COMPOSE_PROJECT_NAME=ffmprb_dev
+
+docker-compose rm -svf
+
+docker-compose build --force-rm
+
+docker-compose run tester $test_to_run && docker-compose rm -svf || ( docker-compose logs && exit 1 )