Project

media_trim

0.0
The project is in a healthy, maintained state
Trim an audio or video file using ffmpeg - Works with all formats supported by ffmpeg, including mp3, mp4, mkv, and many more. - Seeks to the nearest frame positions by re-encoding the media. - Reduces file size procduced by OBS Studio by over 80 percent. - Can be used as a Ruby gem. - Installs the 'trim' command. When run as a command, output files are named by adding a 'trim.' prefix to the media file name, e.g. 'dir/trim.file.ext'. By default, the trim command does not overwrite pre-existing output files. When trimming is complete, the trim command displays the trimmed file, unless the -q option is specified Command-line Usage: trim [OPTIONS] dir/file.ext start [[to|for] end] - The start and end timecodes have the format [HH:[MM:]]SS[.XXX] Note that decimal seconds may be specified, bug frames may not; this is consistent with how ffmpeg parses timecodes. - end defaults to end of the audio/video file OPTIONS are: -d Enable debug output. -f Overwrite output file if present. -h Display help information. -v Verbose output. -V Do not @view the trimmed file when complete. Examples: # Crop dir/file.mp4 from 15.0 seconds to the end of the video, save to demo/trim.demo.mp4: trim demo/demo.mp4 15 # Crop dir/file.mkv from 3 minutes, 25 seconds to 9 minutes, 35 seconds, save to demo/trim.demo.mp4: trim demo/demo.mp4 3:25 9:35 # Same as the previous example, using optional 'to' syntax: trim demo/demo.mp4 3:25 to 9:35 # Save as the previous example, but specify the duration instead of the end time by using the for keyword: trim demo/demo.mp4 3:25 for 6:10
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

media_trim Gem Version

Trims an audio or video file using ffmpeg.

  • Works with all formats supported by ffmpeg, including mp3, mp4, mkv, and many more.
  • Seeks to the nearest frame positions by re-encoding the media.
  • Reduces file size produced by OBS Studio by over 80 percent.
  • Can be used as a Ruby gem.
  • Installs the trim command.

Installation

You need a working Ruby environment to install this program. I describe how to set that up here.

Standalone

The trim command is provided by the media_trim Ruby gem. Install it like this:

$ gem install media_trim

As a Dependency of a Ruby Program

Add this line to your application’s Gemfile:

gem 'media_trim'

Then execute:

$ bundle

As a Dependency of a Ruby Gem

Add the following to your application’s .gemspec:

spec.add_dependency 'media_trim'

Then execute:

$ bundle

Usage

Command-line Usage

trim [OPTIONS] dir/file.ext start [[to|for] end]
  • The start and end timecodes have the format [HH:[MM:]]SS[.XXX]. Note that decimal seconds may be specified, but frames may not; this is consistent with how ffmpeg parses timecodes.
  • end defaults to the end of the audio/video file

When run as a command, output files are named by adding a trim. prefix to the media file name, e.g. dir/trim.file.ext. By default, the trim command does not overwrite pre-existing output files. When trimming is complete, the trim command displays the trimmed file, unless the -q option is specified.

OPTIONS are:

  • -d Enable debug output.
  • -h Display help information.
  • -f Overwrite output file if present.
  • -v Verbose output.
  • -V Do not view the trimmed file when complete.

Examples

Crop dir/file.mp4 from 15.0 seconds to the end of the video, save to demo/trim.demo.mp4:

$ trim demo/demo.mp4 15

Crop dir/file.mkv from 3 minutes, 25 seconds to 9 minutes, 35 seconds, save to demo/trim.demo.mp4:

$ trim demo/demo.mp4 3:25 9:35

Same as the previous example, using optional to syntax:

$ trim demo/demo.mp4 3:25 to 9:35

Save as the previous example, but specify the duration instead of the end time by using the for keyword:

$ trim demo/demo.mp4 3:25 for 6:10

Figuring Out Start and Stop Times

Need a way to figure out the start and stop times to trim a video? DJV is an excellent video viewer.

  • Allows frame-by-frame stepping
  • Displays the current time reliabily
  • F/OSS
  • Mac, Windows, Linux
  • High quality

Development

After checking out this git repository, install dependencies by typing:

$ bin/setup

You should do the above before running Visual Studio Code.

Run the Tests

$ bundle exec rake test

Interactive Session

The following will allow you to experiment:

$ bin/console

Local Installation

To install this gem onto your local machine, type:

$ bundle exec rake install

To Release A New Version

To create a git tag for the new version, push git commits and tags, and push the new version of the gem to https://rubygems.org, type:

$ bundle exec rake release

Contributing

Bug reports and pull requests are welcome at https://github.com/mslinn/trim.

License

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