carrierwave-video-thumbnailer

KO | EN

gitlite — search

#ai #go #golang #linux #docker #java #windows #awesome #kubernetes #pytorch #security #ios #openai #open-source

carrierwave-video-thumbnailer

(★ 93)

A thumbnailer plugin for Carrierwave that makes easy thumbnailing of your uploaded videos

파일 탐색기

최종 버전 다운로드 (.zip)

- - demo.png
- - ffmpegthumbnailer_spec.rb
  - thumbnailer_spec.rb
- spec_helper.rb
.document
.gitignore
.rvmrc.sample
.travis.yml
.yardopts
carrierwave-video-thumbnailer.gemspec
CHANGELOG.md
CODE-OF-CONDUCT.md
CONTRIBUTING.md
Gemfile
gemspec.yml
LICENSE
Rakefile
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# carrierwave-video-thumbnailer

[![Build Status](https://travis-ci.org/evrone/carrierwave-video-thumbnailer.png)](https://travis-ci.org/evrone/carrierwave-video-thumbnailer) 
[![Maintainability](https://api.codeclimate.com/v1/badges/a99a88d28ad37a79dbf6/maintainability)](https://codeclimate.com/github/evrone/carrierwave-video-thumbnailer/maintainability)
[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)

A thumbnailer plugin for Carrierwave. It mixes into your uploader setup and
makes easy thumbnailing of your uploaded videos. This software is quite an
alpha right now so any kind of OpenSource collaboration is welcome.

### Demo

![demo image](https://raw.githubusercontent.com/evrone/carrierwave-video-thumbnailer/master/readme_content/image/demo.png)

## Getting Started
### Prerequisites

`ffmpegthumbnailer` binary should be present on the PATH.

[ffmpegthumbnailer git repository](https://github.com/dirkvdb/ffmpegthumbnailer)

### Installation

gem install carrierwave-video-thumbnailer

Or add to your Gemfile:

```ruby
gem 'carrierwave-video-thumbnailer'
```

If you need resize thumbnail add 
[RMagick](https://github.com/rmagick/rmagick) or 
[MiniMagic](https://github.com/minimagick/minimagick)

### Usage

0. Install ffmpegthumbnailer

linux
    
        sudo apt install ffmpegthumbnailer
    
    MacOS
    
        brew install ffmpegthumbnailer

1. Create migration for your model:

rails g migration add_video_to_your_model video:string
    
2. Generate uploader

rails generate uploader Video
    
3. Mount uploader in model

class YourModel < ApplicationRecord
          mount_uploader :video, VideoUploader
        end

4. Update your uploader

In your Rails `app/uploaders/video_uploader.rb`:

```ruby
    class VideoUploader < CarrierWave::Uploader::Base
        include CarrierWave::Video  # for your video processing
        include CarrierWave::Video::Thumbnailer
        
        storage :file
        
        def store_dir
          "uploads/#{model.class.to_s.underscore}/#{mounted_as}/#{model.id}"
        end
        
        version :thumb do
          process thumbnail: [{format: 'png', quality: 10, size: 192, strip: true, logger: Rails.logger}]
        
          def full_filename for_file
            png_name for_file, version_name
          end
        end
        
        def png_name for_file, version_name
          %Q{#{version_name}_#{for_file.chomp(File.extname(for_file))}.png}
        end
    end
    ```
    
    For resize thumbnail add version:
    
    ```ruby
        class VideoUploader < CarrierWave::Uploader::Base
           include CarrierWave::MiniMagick
        
           ...
        
           version :small_thumb, from_version: :thumb do
             process resize_to_fill: [20, 200]
           end
     
        end
    ```

5. Don't forget add parameter in controller 
    
    ```ruby
      def post_params
        params.require(:post).permit(:title, :body, :video)
      end
    ```

6. Add image_tag to your view

###### erb example
        <%= image_tag(@post.video.thumb.url, alt: 'Video') if @post.video? %>

Runs `ffmpegthumbnailer` with CLI keys provided by your configuration or just
uses quite a reasonable ffmpegthumbnailer's defaults.

##### Thumbnailer Options

The options are passed as a hash to the `thumbnail` processing callback as
shown in the example. The options may be, according to ffmpegthumbnailer's
manual:

* format: 'jpg' or 'png' ('jpg' is the default).
  * quality: image quality (0 = bad, 10 = best) (default: 8) only applies to jpeg output
  * size: size of the generated thumbnail in pixels (use 0 for original size) 
    (default value: 128 and keep initial aspect ratio).
  * strip: movie film strip decoration (defaults to `false`).
  * seek: time to seek to (`percentage` or absolute time `hh:mm:ss`) (default: 10)
  * square: if set to `true` ignore aspect ratio and generate square thumbnail.
  * workaround: if set to `true` runs ffmpegthumbnailer in some safe mode
    (read `man ffmpegthumbnailer` for further explanations).
  * logger: an object behaving like Rails.logger (may be omitted).

##### film stripes
  
For disable film stripes in thumbnail check strip to false

process thumbnail: [{format: 'png', quality: 10, size: 192, strip: false, logger: Rails.logger}]

## Contributing

Please read [Code of Conduct](CODE-OF-CONDUCT.md) and [Contributing Guidelines](CONTRIBUTING.md) for submitting pull requests to us.

## Versioning

We use [SemVer](http://semver.org/) for versioning. For the versions available, 
see the [tags on this repository](https://github.com/evrone/carrierwave-video-thumbnailer/tags).

## Changelog

The changelog is [here](CHANGELOG.md).

## Authors

* [Pavel Argentov](https://github.com/argent-smith) - *Initial work*

See also the list of [contributors](https://github.com/evrone/carrierwave-video-thumbnailer/contributors) who participated in this project.

## License

This project is licensed under the [MIT License](LICENSE).

## Acknowledgments

Huge Thanks to **Rachel Heaton** (<https://github.com/rheaton>) whose
`carrierwave-video` gem has inspired me (and where I've borrowed some code as
well).

carrierwave-video-thumbnailer

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

carrierwave-video-thumbnailer

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README