jr-paperclip 7.3.1 → 8.0.0.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86576949abbf8e615767bf012d920eeaccbfadcea328de29ee13f0122954c0c1
-  data.tar.gz: aed22295a457aa08cf1b51abc27ac49d9025c9680102296461f8f94021f2231f
+  metadata.gz: '08e0a02cb6a9a3a1b126b744de6afe4654e9db7bf841bb710ac29b3cb702f5a2'
+  data.tar.gz: 5c3c603853869aa41d56026de0d71788f87f7b98ec4d8382adc811e23bc9eb42
 SHA512:
-  metadata.gz: 53ed359d186530b8d3622a2fc20e07d7e6e41929760c17e104ddac82e3f5a2b88fd3c55ea9389d4c23a3412791c8691d01807652a065119b8e07fbba6e1fc972
-  data.tar.gz: a5fe5b686f5b15bf5ade65038623bbfc275fc62a77dc366f871bd96ebd8db4a843b209bb8a9195a5b00169c057d7e5f817bba8cbdc0a918db17688d12f50eb68
+  metadata.gz: 9b71eb967b7cb2b0980e665c4886bbb5754bac409677b0af4e13578101dde22d710ab2bc11e31287dac3e99520f53f9e9b44fe79f5285f5fd5aa2cfe070edf43
+  data.tar.gz: ab955ec831d70c792bcaccbb41b5e2b6754fe0badddc1a52735d5a974f0982e3cdda316e5db9a274da73132482515ebf5b74775780d8e179e6d2493154370610

data/.github/workflows/tests.yml

@@ -28,6 +28,8 @@ jobs:
             gemfile: gemfiles/8.0.gemfile
           - ruby: '3.4'
             gemfile: gemfiles/8.1.gemfile
+          - ruby: '4.0'
+            gemfile: gemfiles/8.1.gemfile
 
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
@@ -44,7 +46,7 @@ jobs:
       - name: Install dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y ghostscript imagemagick
+          sudo apt-get install -y ghostscript imagemagick libvips
           sudo rm -f /etc/ImageMagick-6/policy.xml
 
       - name: Run tests

data/CONTRIBUTING.md

@@ -13,7 +13,7 @@ Here's a quick guide for contributing:
 1. Make sure you have ImageMagick and Ghostscript installed. See [this section](./README.md#image-processor) of the README.
 
 1. Run the tests. We only take pull requests with passing tests, and it's great
-to know that you have a clean slate: `bundle && bundle exec rake`
+to know that you have a clean slate: `bundle && bundle exec appraisal rake`
 
 1. Add a test for your change. Only refactoring and documentation changes
 require no new tests. If you are adding functionality or fixing a bug, we need

data/Gemfile

@@ -10,6 +10,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/NEWS

@@ -1,3 +1,16 @@
+8.0.0.beta.1 (2026-01-09)
+
+* Feature: Add libvips backend alongside ImageMagick via the image_processing gem
+* Feature: Per-attachment and per-style backend selection (`:backend` option)
+* Feature: ImageMagick 7 detection (uses `magick` command when available)
+* Feature: Add `ALLOWED_IMAGEMAGICK_OPTIONS` security whitelist (GHSA-r4mg-4433-c7g3)
+* Feature: Cross-platform convert_options support (-strip, -quality, -rotate, etc.)
+* Documentation: Add VIPS_MIGRATION_GUIDE.md with step-by-step migration instructions
+* Documentation: Expand README with backend configuration examples
+* Chores: Add image_processing ~> 1.14 as runtime dependency
+* Chores: CI now installs libvips for testing both backends
+* Tests: Comprehensive test coverage for both backends, geometry modifiers, and convert options
+
 7.3.1 (2025-12-17)
 * Improvement: Relax Ruby requirement to 3.0 and optimize CI matrix
 

data/README.md

@@ -6,7 +6,7 @@ Paperclip
 [![Tests](https://github.com/jukra/jr-paperclip/actions/workflows/tests.yml/badge.svg)](https://github.com/jukra/jr-paperclip/actions/workflows/tests.yml)
 [![reviewdog](https://github.com/jukra/jr-paperclip/actions/workflows/reviewdog.yml/badge.svg)](https://github.com/jukra/jr-paperclip/actions/workflows/reviewdog.yml)
 
-**Revived fork with active maintenance and support for Rails 7.0, 7.1, 8.0, and 8.1 on Ruby 3.2 and newer.**
+**Revived fork with active maintenance and support for Rails 7.0, 7.1, 8.0, and 8.1 on Ruby 3.0 and newer.**
 
 If you are looking for older versions, please check the [original fork](https://github.com/kreeti/kt-paperclip).
 
@@ -58,6 +58,7 @@ Please feel free to contribute Issues and pull requests.
   - [Understanding Storage](#understanding-storage)
 - [IO Adapters](#io-adapters)
 - [Post Processing](#post-processing)
+- [Image Processing Backends](#image-processing-backends)
 - [Custom Attachment Processors](#custom-attachment-processors)
 - [Events](#events)
 - [URI Obfuscation](#uri-obfuscation)
@@ -104,6 +105,10 @@ Paperclip now requires Ruby version **>= 2.3** and Rails version **>= 4.2**
 
 ### Image Processor
 
+Paperclip supports two main image processing backends: **ImageMagick** (default) and **libvips** (recommended for performance).
+
+#### ImageMagick
+
 [ImageMagick](http://www.imagemagick.org) must be installed and Paperclip must have access to it. To ensure
 that it does, on your command line, run `which convert` (one of the ImageMagick
 utilities). This will give you the path where that utility is installed. For
@@ -132,6 +137,32 @@ the following with apt-get:
 
     sudo apt-get install imagemagick -y
 
+#### libvips (Recommended for Performance)
+
+[libvips](https://www.libvips.org/) is significantly faster and uses less memory than ImageMagick. 
+
+To use libvips, install the system library:
+
+```bash
+# macOS
+brew install vips
+
+# Ubuntu/Debian
+sudo apt install libvips
+```
+
+Then configure Paperclip to use it as the default backend in `config/initializers/paperclip.rb` (or in your environment configuration):
+
+```ruby
+config.paperclip_defaults = {
+  backend: :vips
+}
+```
+
+You can also specify the backend per-attachment (see [Image Processing Backends](#image-processing-backends)).
+
+**Note on Geometry Detection:** When `vips` is the active backend, Paperclip uses the ruby-vips gem to determine image dimensions instead of ImageMagick's `identify` command.
+
 ### `file`
 
 The Unix [`file` command](https://en.wikipedia.org/wiki/File_(command)) is required for content-type checking.
@@ -691,11 +722,11 @@ has_attached_file :avatar, styles: { thumb: ["32x32#", :png] }
 
 This will convert the "thumb" style to a 32x32 square in PNG format, regardless
 of what was uploaded. If the format is not specified, it is kept the same (e.g.
-JPGs will remain JPGs). `Paperclip::Thumbnail` uses ImageMagick to process
-images; [ImageMagick's geometry documentation](http://www.imagemagick.org/script/command-line-processing.php#geometry)
-has more information on the accepted style formats.
+JPGs will remain JPGs). `Paperclip::Thumbnail` uses the [image_processing](https://github.com/janko/image_processing) gem to process images. This allows support for both ImageMagick (via MiniMagick) and libvips backends.
+[ImageMagick's geometry documentation](http://www.imagemagick.org/script/command-line-processing.php#geometry)
+has more information on the accepted style formats, which are generally supported by both backends in Paperclip.
 
-For more fine-grained control of the conversion process, `source_file_options` and `convert_options` can be used to pass flags and settings directly to ImageMagick's powerful Convert tool, [documented here](https://www.imagemagick.org/script/convert.php). For example:
+For more fine-grained control of the conversion process, `source_file_options` and `convert_options` can be used. These options are parsed and applied to the `image_processing` pipeline.
 
 ```ruby
 has_attached_file :image, styles: { regular: ['800x800>', :png]},
@@ -703,6 +734,42 @@ has_attached_file :image, styles: { regular: ['800x800>', :png]},
     convert_options: { regular: "-posterize 3"}
 ```
 
+Since Paperclip now delegates to the `image_processing` gem, you should refer to its documentation for available methods/operations for your chosen backend:
+
+*   **ImageMagick:** [ImageProcessing::MiniMagick documentation](https://github.com/janko/image_processing/blob/master/doc/minimagick.md)
+*   **libvips:** [ImageProcessing::Vips documentation](https://github.com/janko/image_processing/blob/master/doc/vips.md)
+
+Common options like `-strip`, `-quality`, `-rotate`, `-blur` are supported on both backends, but backend-specific options (like `-density` for ImageMagick) might not be available or behave differently on libvips.
+
+### Cross-Platform Convert Options
+
+Many common `convert_options` now work with **both** ImageMagick and libvips backends:
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `-strip` | Remove metadata/EXIF | `convert_options: "-strip"` |
+| `-quality N` | Output quality (1-100) | `convert_options: "-quality 80"` |
+| `-rotate N` | Rotate by degrees | `convert_options: "-rotate 90"` |
+| `-flip` | Vertical flip | `convert_options: "-flip"` |
+| `-flop` | Horizontal flip | `convert_options: "-flop"` |
+| `-blur 0xN` | Gaussian blur | `convert_options: "-blur 0x2"` |
+| `-sharpen 0xN` | Sharpen image | `convert_options: "-sharpen 0x1"` |
+| `-colorspace X` | Color space (Gray, sRGB, CMYK) | `convert_options: "-colorspace Gray"` |
+| `-negate` | Invert colors | `convert_options: "-negate"` |
+| `-flatten` | Flatten transparency | `convert_options: "-flatten"` |
+| `-auto-orient` | Auto-rotate via EXIF | `convert_options: "-auto-orient"` |
+| `-interlace X` | Progressive output | `convert_options: "-interlace Plane"` |
+
+Example:
+
+```ruby
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" },
+  convert_options: { all: "-strip -quality 80" }
+```
+
+**Note:** Some options only work with ImageMagick (e.g., `-density`, `-depth`, `-gravity`, `-crop`, `-trim`). When using the vips backend, these will be skipped with a warning logged.
+
 ImageMagick supports a number of environment variables for controlling its resource limits. For example, you can enforce memory or execution time limits by setting the following variables in your application's process environment:
 
 * `MAGICK_MEMORY_LIMIT=128MiB`
@@ -713,6 +780,48 @@ For a full list of variables and description, see [ImageMagick's resources docum
 
 ---
 
+Image Processing Backends
+-------------------------
+
+jr-paperclip supports two image processing backends:
+
+### ImageMagick (Default)
+
+The traditional backend, using ImageMagick via shell commands.
+
+```ruby
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" }
+```
+
+### libvips (Recommended for Performance)
+
+libvips is significantly faster and uses less memory than ImageMagick.
+
+**Usage:**
+
+```ruby
+# Global default (in config/initializers/paperclip.rb or environment config)
+config.paperclip_defaults = {
+  backend: :vips
+}
+
+# Or per-attachment
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" },
+  backend: :vips,
+  convert_options: { all: "-strip -quality 75" }
+
+# Per-style backend selection (mix backends in one attachment)
+has_attached_file :document,
+  styles: {
+    preview: { geometry: "800x800>", backend: :vips },
+    thumb: { geometry: "100x100#", backend: :image_magick }
+  }
+```
+
+---
+
 Custom Attachment Processors
 -------
 
@@ -1079,6 +1188,7 @@ Thank you to all [the contributors](https://github.com/jukra/jr-paperclip/graphs
 License
 -------
 
-Copyright © 2020-2021 Kreeti Technologies Pvt. Ltd.
+Copyright (c) 2025- Jukka Rautanen
+Copyright © 2020-2025 Kreeti Technologies Pvt. Ltd.
 Copyright © 2008-2017 thoughtbot, inc.
 It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

data/UPGRADING

@@ -0,0 +1,5 @@
+jr-paperclip – HEADS UP (major changes)
+
+This version adds libvips support as a high-performance alternative to ImageMagick.
+It also introduces ImageMagick 7 compatibility and updates geometry detection behavior.
+For migration instructions and details, see README.md and VIPS_MIGRATION_GUIDE.md.

data/VIPS_MIGRATION_GUIDE.md

@@ -0,0 +1,131 @@
+# Migrating to the libvips Backend
+
+Paperclip now supports [libvips](https://www.libvips.org/) via the `image_processing` gem. libvips is significantly faster and uses much less memory than ImageMagick, making it highly recommended for production environments.
+
+This guide explains how to migrate your application to use libvips, either globally or gradually.
+
+## Prerequisites
+
+You must install the libvips system library on your server or development machine:
+
+```bash
+# macOS
+brew install vips
+
+# Ubuntu/Debian
+sudo apt install libvips
+```
+
+## Step 1: Update your Gemfile
+
+`jr-paperclip` already includes the `image_processing` gem, which automatically provides the `ruby-vips` and `mini_magick` bindings. You do **not** need to add these gems explicitly to your `Gemfile`.
+
+Ensure you are using the latest version of the gem:
+
+```ruby
+gem "jr-paperclip", "~> 8.0.0.beta"
+```
+
+## Step 2: Gradual Migration (Per-Attachment)
+
+The safest way to migrate is one attachment at a time. This allows you to verify that the output remains consistent and doesn't interfere with existing custom processors.
+
+Simply add the `backend: :vips` option to a specific attachment:
+
+```ruby
+class User < ActiveRecord::Base
+  has_attached_file :avatar,
+    styles: { medium: "300x300>", thumb: "100x100#" },
+    backend: :vips
+end
+```
+
+Other attachments in your application will continue to use ImageMagick by default.
+
+## Step 3: Cross-Platform Convert Options
+
+Good news! Many common `convert_options` now work with **both** ImageMagick and libvips backends. You can keep using them as-is:
+
+### Options That Work on Both Backends
+
+| Option | Description |
+|--------|-------------|
+| `-strip` | Remove metadata/EXIF data |
+| `-quality N` | Output quality (1-100) |
+| `-rotate N` | Rotate by degrees |
+| `-flip` | Vertical flip |
+| `-flop` | Horizontal flip |
+| `-blur 0xN` | Gaussian blur |
+| `-sharpen 0xN` | Sharpen image |
+| `-colorspace X` | Color space (Gray, sRGB, CMYK) |
+| `-negate` | Invert colors |
+| `-flatten` | Flatten transparency |
+| `-auto-orient` | Auto-rotate via EXIF |
+| `-interlace X` | Progressive/interlaced output |
+
+**Example:**
+```ruby
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" },
+  backend: :vips,
+  convert_options: { all: "-strip -quality 80" }
+```
+
+### ImageMagick-Only Options
+
+The following options only work with ImageMagick. When used with the vips backend, they will be skipped and a warning will be logged:
+
+`-density`, `-depth`, `-gravity`, `-crop`, `-extent`, `-alpha`, `-background`, `-type`, `-posterize`, `-dither`, `-colors`, `-channel`, `-transpose`, `-transverse`, `-normalize`, `-equalize`, `-trim`, `-monochrome`
+
+If you rely heavily on these options, consider keeping those specific attachments on the ImageMagick backend.
+
+## Step 4: Handling Custom Processors
+
+If you have custom processors defined in `lib/paperclip`, they will continue to work even if you switch the primary backend to `:vips`, as long as they are still calling the `convert` or `identify` helper methods.
+
+However, if you want to migrate a custom processor to libvips, you can now use the `vips`, `vips_image` and `vipsheader` helpers:
+
+```ruby
+module Paperclip
+  class MyVipsProcessor < Processor
+    def make
+      # Use the new vips helper instead of convert
+      vips("thumbnail :src :dst 100",
+           src: File.expand_path(file.path),
+           dst: File.expand_path(dst.path)
+      )
+      dst
+    end
+  end
+end
+```
+
+## Step 5: Global Migration
+
+Once you have verified that your attachments and processors work correctly with libvips, you can switch the entire application over by updating your global configuration:
+
+```ruby
+# config/initializers/paperclip.rb or config/environments/production.rb
+config.paperclip_defaults = {
+  backend: :vips,
+  convert_options: { all: "-strip -quality 85" }
+}
+```
+
+You can also use per-style backend selection to mix backends within a single attachment:
+
+```ruby
+has_attached_file :document,
+  styles: {
+    # Use vips for large previews (faster)
+    preview: { geometry: "800x800>", backend: :vips },
+    # Use ImageMagick for thumbnails needing specific options
+    thumb: { geometry: "100x100#", backend: :image_magick }
+  }
+```
+
+## Important Considerations
+
+1.  **Output Parity**: While libvips aims for high quality, its resizing algorithms (Lanczos) may produce slightly different visual results than ImageMagick.
+2.  **PDF/SVG Support**: libvips requires additional libraries (like `poppler` or `librsvg`) to process these formats. If you process complex vector formats, ensure the appropriate libraries are installed on your system.
+3.  **Exotic Formats**: If you rely on very specific ImageMagick features (like specialized filters or complex layer manipulation), test those attachments thoroughly before switching.

data/features/basic_integration.feature

@@ -83,3 +83,30 @@ Feature: Rails integration
     Then I should see "Name: something"
     And I should see an image with a path of "//s3.amazonaws.com/paperclip/attachments/original/5k.png"
     And the file at "//s3.amazonaws.com/paperclip/attachments/original/5k.png" should be uploaded to S3
+
+  Scenario: libvips integration test
+    Given I add this snippet to config/application.rb:
+      """
+      config.paperclip_defaults = {
+        :backend => :vips
+      }
+      """
+    And I attach :attachment with:
+      """
+      url: "/system/:attachment/:style/:filename",
+      styles: { thumb: "100x100#" }
+      """
+    And I start the rails application
+    And I overwrite "app/views/users/show.html.erb" with:
+      """
+      <p>Name: <%= @user.name %></p>
+      <p>Original: <%= image_tag @user.attachment.url(:original) %></p>
+      <p>Thumb: <%= image_tag @user.attachment.url(:thumb) %></p>
+      """
+    When I go to the new user page
+    And I fill in "Name" with "vips user"
+    And I attach the file "spec/support/fixtures/5k.png" to "Attachment"
+    And I press "Submit"
+    Then I should see "Name: vips user"
+    And the file at "/system/attachments/original/5k.png" should have dimensions "434x66"
+    And the file at "/system/attachments/thumb/5k.png" should have dimensions "100x100"

data/features/step_definitions/attachment_steps.rb

@@ -86,6 +86,23 @@ Then /^the attachment file "([^"]*)" should (not )?exist$/ do |filename, not_exi
   end
 end
 
+Then /^the file at "([^"]*)" should have dimensions "([^"]*)"$/ do |web_path, dimension|
+  cd(".") do
+    local_path = "public#{web_path}"
+    # Try identify first, then vipsheader
+    require "shellwords"
+    escaped_path = Shellwords.escape(local_path)
+    geometry = `identify -format "%wx%h" #{escaped_path} 2>/dev/null`.strip
+    if geometry.empty?
+      width = `vipsheader -f width #{escaped_path} 2>/dev/null`.strip
+      height = `vipsheader -f height #{escaped_path} 2>/dev/null`.strip
+      geometry = "#{width}x#{height}"
+    end
+    raise "Could not determine dimensions for #{local_path}" if geometry == "x" || geometry.empty?
+    expect(geometry).to eq(dimension)
+  end
+end
+
 Then /^I should have attachment columns for "([^"]*)"$/ do |attachment_name|
   cd(".") do
     columns = eval(`bundle exec rails runner "puts User.columns.map{ |column| [column.name, column.sql_type] }.inspect"`.strip)

data/gemfiles/7.0.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/7.1.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/7.2.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/8.0.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/8.1.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/lib/paperclip/attachment.rb

@@ -34,7 +34,8 @@ module Paperclip
         validate_media_type:               true,
         adapter_options:                   { hash_digest: Digest::MD5 },
         check_validity_before_processing:  true,
-        return_file_attributes_on_destroy: false
+        return_file_attributes_on_destroy: false,
+        backend:                           Paperclip.options[:backend]
       }
     end
 
@@ -537,7 +538,7 @@ module Paperclip
                                 for(@queued_for_write[name], @options[:adapter_options])
       unadapted_file.close if unadapted_file.respond_to?(:close)
       @queued_for_write[name]
-    rescue Paperclip::Errors::NotIdentifiedByImageMagickError => e
+    rescue Paperclip::Errors::NotIdentifiedByBackendError => e
       log("An error was received while processing: #{e.inspect}")
       (@errors[:processing] ||= []) << e.message if @options[:whiny]
     ensure

data/lib/paperclip/errors.rb

@@ -18,12 +18,11 @@ module Paperclip
     class MissingRequiredValidatorError < Paperclip::Error
     end
 
-    # Will be thrown when ImageMagic cannot determine the uploaded file's
-    # metadata, usually this would mean the file is not an image. If you are
-    # consistently receiving this error on PDFs make sure that you have
-    # installed Ghostscript.
-    class NotIdentifiedByImageMagickError < Paperclip::Error
+    # Will be thrown when the backend cannot determine the uploaded file's
+    # metadata, usually this would mean the file is not an image.
+    class NotIdentifiedByBackendError < Paperclip::Error
     end
+    NotIdentifiedByImageMagickError = NotIdentifiedByBackendError
 
     # Will be thrown if the interpolation is creating an infinite loop. If you
     # are creating an interpolator which might cause an infinite loop, you

data/lib/paperclip/geometry.rb

@@ -21,8 +21,8 @@ module Paperclip
     end
 
     # Extracts the Geometry from a file (or path to a file)
-    def self.from_file(file)
-      GeometryDetector.new(file).make
+    def self.from_file(file, backend = nil)
+      GeometryDetector.new(file, backend: backend).make
     end
 
     # Extracts the Geometry from a "WxH,O" string
@@ -84,7 +84,7 @@ module Paperclip
       to_s
     end
 
-    # Returns the scaling and cropping geometries (in string-based ImageMagick format)
+    # Returns the scaling and cropping geometries (in string format)
     # neccessary to transform this Geometry into the Geometry given. If crop is true,
     # then it is assumed the destination Geometry will be the exact final resolution.
     # In this case, the source Geometry is scaled so that an image containing the

data/lib/paperclip/geometry_detector_factory.rb

@@ -1,31 +1,75 @@
 module Paperclip
   class GeometryDetector
-    def initialize(file)
+    def initialize(file, backend: nil)
       @file = file
+      @backend = backend
       raise_if_blank_file
     end
 
     def make
       geometry = GeometryParser.new(geometry_string.strip).make
-      geometry || raise(Errors::NotIdentifiedByImageMagickError.new("Could not identify image size"))
+      geometry || raise(Errors::NotIdentifiedByBackendError.new("Could not identify image size"))
     end
 
     private
 
     def geometry_string
-      orientation = Paperclip.options[:use_exif_orientation] ?
-        "%[exif:orientation]" : "1"
+      if resolve_backend == :vips
+        vips_geometry_string
+      else
+        imagemagick_geometry_string
+      end
+    end
+
+    def resolve_backend
+      Paperclip.resolve_backend(@backend || Paperclip.options[:backend])
+    end
+
+    def imagemagick_geometry_string
+      orientation = if Paperclip.options[:use_exif_orientation]
+                      "%[exif:orientation]"
+                    else
+                      "1"
+                    end
       Paperclip.run(
-        Paperclip.options[:is_windows] ? "magick identify" : "identify",
+        (Paperclip.options[:is_windows] || Paperclip.imagemagick7?) ? "magick identify" : "identify",
         "-format '%wx%h,#{orientation}' :file", {
-          file: "#{path}[0]"
+          file: "#{path}[0]",
         },
         swallow_stderr: true
       )
     rescue Terrapin::ExitStatusError
       ""
     rescue Terrapin::CommandNotFoundError => e
-      raise_because_imagemagick_missing
+      raise Errors::CommandNotFoundError.new("Could not run the `identify` command. Please install ImageMagick.")
+    end
+
+    def vips_geometry_string
+      begin
+        require "vips"
+      rescue LoadError => e
+        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips and the image_processing gem.")
+      end
+
+      begin
+        # Use ruby-vips gem directly instead of shelling out to vipsheader
+        image = Vips::Image.new_from_file(path, access: :sequential)
+        width = image.width
+        height = image.height
+
+        orientation = "1"
+        if Paperclip.options[:use_exif_orientation]
+          begin
+            orientation = image.get("orientation").to_s
+          rescue Vips::Error
+            # Field might not exist
+          end
+        end
+
+        "#{width}x#{height},#{orientation}"
+      rescue Vips::Error
+        ""
+      end
     end
 
     def path
@@ -34,12 +78,8 @@ module Paperclip
 
     def raise_if_blank_file
       if path.blank?
-        raise Errors::NotIdentifiedByImageMagickError.new("Cannot find the geometry of a file with a blank name")
+        raise Errors::NotIdentifiedByBackendError.new("Cannot find the geometry of a file with a blank name")
       end
     end
-
-    def raise_because_imagemagick_missing
-      raise Errors::CommandNotFoundError.new("Could not run the `identify` command. Please install ImageMagick.")
-    end
   end
 end

data/lib/paperclip/helpers.rb

@@ -56,5 +56,23 @@ module Paperclip
     def reset_duplicate_clash_check!
       @names_url = nil
     end
+
+    def imagemagick7?
+      return @imagemagick7 if instance_variable_defined?(:@imagemagick7)
+
+      @imagemagick7 = !!which("magick")
+    end
+
+    # https://github.com/minimagick/minimagick/blob/master/lib/mini_magick/utilities.rb#L9-L24
+    def which(cmd)
+      exts = ENV["PATHEXT"] ? ENV["PATHEXT"].split(";") : [""]
+      (ENV["PATH"] || "").split(File::PATH_SEPARATOR).each do |path|
+        exts.each do |ext|
+          exe = File.join(path, "#{cmd}#{ext}")
+          return exe if File.executable? exe
+        end
+      end
+      nil
+    end
   end
 end