Renchin

Renchin is a convenient cli wrapper library to convert movie to image/movie/gif or convert image to image/movie/gif with imagemagick, ffmpeg and gifsicle.

Renchin is tested in Ruby version >= 2.0.0

• FFmpeg
• Imagemagick
• gifsicle

In default, Renchin use $PATH.

gem 'renchin'

And then execute:

$ bundle

Or install it yourself as:

$ gem install renchin

Each methods have client version and cli version.

• command_path
  • set command line path

Renchin.options[:command_path] = '/usr/bin'

renchin = Renchin::Client.new
renchin.tlapse( "/tmp/zOx3LRvtz22XIfhE.mp4" , "/tmp/output.mp4")

renchin tlapse  -i MOVIE_FILE_PATH -o OUTPUT_MOVIE_FILE_PATH

Options

• --ofps
  • set output movie fps(default: 30)
• --iex
  • set temporary image file extension(default: png)

example)

renchin tlapse  -i /tmp/example.mp4 -o /tmp/renchin_output_tlapse.mp4

It creates a single sprite image from movie.

The image is useful to create gif like animation with javascript in this library.

renchin = Renchin::Client.new
renchin.sprite( "/tmp/zOx3LRvtz22XIfhE.mp4" , "/tmp/output.jpg")

renchin sprite  -i MOVIE_FILE_PATH -o OUTPUT_FILE_PATH

Options

• --cfps
  • captured frame per second

example)

renchin sprite  -i /tmp/example.mp4 -o /tmp/renchin_output_sprite.jpg

renchin = Renchin::Client.new
renchin.reverse( "/tmp/zOx3LRvtz22XIfhE.mp4" , "/tmp/output.mp4", {start: 0, end_sec: 10})

• start
  • start time
• _end
  • end time

renchin reverse  -i MOVIE_FILE_PATH -o OUTPUT_FILE_PATH -s START_TIME -e END_TIME

example)

renchin reverse  -i /tmp/example.mp4 -o /tmp/renchin_output_reverse.mp4 -s 0 -e 40

The example, output movie starts from 40 second and finishes to 0 second.

Create cinemagraph gif from gif animation

renchin = Renchin::Client.new
renchin.cgraph( "/tmp/zOx3LRvtz22XIfhE.gif" , "/tmp/output.gif", {overlay_x: 320, overlay_y: 150, overlay_w: 411, overlay_h: 315, viewport_w: 411, viewport_h: 315})

• overlay_x
  • animated part x
• overlay_y
  • animated part y
• overlay_w
  • animated part width
• overlay_h
  • animated part height
• viewport_w
  • final output width
• viewport_h
  • final output height

renchin cgraph -i GIF_FILE -o OUTPUT_GIF_FILE -x ANIMATED_POSITION_X -y ANIMATED_POSITION_Y -w ANIMATED_PART_WIDTH -h ANIMATED_PART_HEIGHT

example)

renchin  cgraph  -i /tmp/example.gif  -o /tmp/output_gif_file.gif -x 250 -y 100 -w 50 -h 100

Reduces gif animation frames by a given rate.

# If the number of frames of input.gif is 100,
# output.gif frames are 50 because reduction_rate is 50%.
@renchin = Renchin::Client.new
@renchin.frame_reduction( "input.gif", {reduction_rate: 0.5}) # /tmp/output.gif

• reduction_rate
  • reduction rate of gif frames

renchin frame_reduction -i GIF_FILE -r REDUCTION_RATE

example)

# return /tmp/output.gif
$ renchin frame_reduction -i input.gif -r 0.5

# make output gif to custom directory
$ renchin frame_reduction -i input.gif -o /mydir/output.gif -r 0.5

After checking out the repo, run bin/setup to install dependencies. Then, run rake rspec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/YuheiNakasaka/renchin.

The gem is available as open source under the terms of the MIT License.