https://github.com/mslinn/video_operations
Provides commands for rotating and stabilizing a video
https://github.com/mslinn/video_operations
ffmpeg ffmpeg-command video
Last synced: 2 months ago
JSON representation
Provides commands for rotating and stabilizing a video
- Host: GitHub
- URL: https://github.com/mslinn/video_operations
- Owner: mslinn
- License: mit
- Created: 2023-12-25T22:12:34.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-12-26T18:58:21.000Z (over 1 year ago)
- Last Synced: 2025-01-09T01:12:00.350Z (4 months ago)
- Topics: ffmpeg, ffmpeg-command, video
- Language: Ruby
- Homepage:
- Size: 27.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# `Video_operations` [](https://badge.fury.io/rb/video_operations)
`Video_operations` provides the `stabilize` command, which uses `FFmpeg` to improve shakey videos,
and the `rotate` command, which uses FFmpeg to rotate a video.
Provided as a Ruby Gem, `video_operations` exposes APIs that can be invoked from other programs.
## Installation
To use the `rotate` and `stabilize` commands from a console, type:
```shell
$ gem install video_operations
```
### For a Ruby Program
If you would like to use the APIs from your Ruby program,
add the following line to your application’s `Gemfile`:
```ruby
gem 'video_operations'
```
And then execute:
```shell
$ bundle
```
### For a Ruby Gem
If you would like to use the APIs from your Ruby gem,
add the following to your gem’s `.gemspec`:
```ruby
spec.add_dependency 'video_operations'
```
And then execute:
```shell
$ bundle
```
## Usage
This are the help messages:
```shell
$ rotate -h
rotate: Rotates a video using FFmpeg.
Syntax: rotate PATH_TO_VIDEO DEGREES
Options:
-f Overwrite output file if present
-h Show this help message
-v Verbosity; one of: trace, debug, verbose, info, warning, error, fatal, panic, quiet
```
```shell
$ stabilize -h
stabilize: Stabilizes a video using FFmpeg's vidstabdetect and vidstabtransform filters.
Syntax: stabilize [Options] PATH_TO_VIDEO
Options:
-f Overwrite output file if present
-h Show this help_stabilize message
-s Shakiness compensation 1..10 (default 5)
-v Verbosity; one of: trace, debug, verbose, info, warning, error, fatal, panic, quiet
-z Zoom percentage (computed if not specified)
See:
https://www.ffmpeg.org/ffmpeg-filters.html#vidstabdetect-1
https://www.ffmpeg.org/ffmpeg-filters.html#toc-vidstabtransform-1
```
## Development
After checking out this git repository, install dependencies by typing:
```shell
$ bin/setup
```
You should do the above before running Visual Studio Code.
### Run the Tests
```shell
$ bundle exec rake test
```
### Interactive Session
The following will allow you to experiment:
```shell
$ bin/console
```
### Local Installation
To install this gem onto your local machine, type:
```shell
$ 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:
```shell
$ bundle exec rake release
```
## Contributing
Bug reports and pull requests are welcome at https://github.com/mslinn/stabilize_video.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).