scrub_jpeg 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+.rvmrc
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in scrub_jpeg.gemspec
+gemspec

data/README.md

@@ -0,0 +1,78 @@
+Scrub JPEG
+==========
+
+Why do I need this?
+-------------------
+
+Whenever you upload photos to the web, need to really compress JPEGs, or want
+to hide embarrassing details about how exactly this photo came to be, you need
+to cover all your tracks.
+
+More likely, you may be a photographer who wants to keep his shiny new lens 
+parameters his very own little trade secret.
+
+
+What do I do?
+--------------
+
+Exiv2 bindings are required. On MacOSX I suggest homebrew:
+
+`brew install exiv2`
+
+Then just grab the gem:
+
+`gem install scrub_jpeg`
+
+
+What exactly do I get?
+----------------------
+
+### View photo metadata
+
+`$ view_jpeg_info bachelor_party.jpg`
+
+Shows all the incriminating EXIF, IPTC, and XMP tags your friends may have
+slyly add to your photo.
+
+### Destroy photo metadata
+
+    $ scrub_jpeg bachelor_party.jpg
+    $ scrub_jpeg foo/bar/*.jpg
+    $ scrub_jpeg .
+    $ scrub_jpeg "my/photos/" "more/photos/*.jp"
+
+Removes all EXIF, IPTC, and XMP tags, leaving only your actual facial expression
+to incriminate you. But hey, that's why we have Photoshop™.
+
+The arguments are one or more files, directories, or shell splats. Directories
+are not searched recursively and only pick up files with `jpg` or `jpeg` extensions.
+
+**WARNING:** This will overwrite the existing image. Make sure you have backups
+and be aware you are deleting all metadata tags.  No undo, no passing go, no collecting $200.
+
+
+Why not X, Y, or Z?
+-------------------
+
+I did not want to write code, I just wanted something that worked predictably.
+
+The existing choices were either convoluted GUI editors that did lots of image
+manipulation related tasks, or poorly written shell scripts.
+
+The closest thing I could find was `jhead -purejpeg`, which looked like my meal
+ticket, until I ran it on some images and found it modified the actual images!
+
+`scrub_jpeg` uses exiv2 to delete all metadata tags, but will never modify the
+actual image. Hopefully it just does one thing well.
+
+
+Disclaimer
+----------
+
+This is alpha software. 
+
+It is provided "AS IS" and without any express or implied warranties, including,
+without limitation, the implied warranties of merchantability and fitness for
+a particular purpose.
+
+Use at your own risk. And make plenty of backups.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/scrub_jpeg

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+
+require "scrub_jpeg"
+
+def parse_files(args)
+  files = []
+  args.each do |argv|
+    Dir.glob(argv).each do |f_or_d|
+      next unless File.exists?(f_or_d)
+      if File.file?(f_or_d)
+        next unless f_or_d =~ /\.jpe?g/i
+        files << f_or_d
+      elsif File.directory?(f_or_d)
+        splat = File.expand_path(f_or_d) + '/*'
+        Dir[splat].each do |f|
+          next unless f =~ /\.jpe?g/i
+          files << f
+        end
+      end
+    end
+  end
+  files
+end
+
+def scrub_files(files)
+  files.each do |filename|
+    scrubber = ScrubJpeg::Scrubber.new(filename)
+    scrubber.scrub!
+  end
+end
+
+USAGE = <<EOS
+Usage: scrub_jpeg [INPUT]
+
+  where INPUT may be:
+  1) file.jpg
+  2) *splat*.jpg
+  3) /path/to/dir
+EOS
+
+if ARGV.empty?
+  puts USAGE
+  exit 0
+else
+  scrub_files(parse_files(ARGV))
+end

data/bin/view_jpeg_info

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+require 'exiv2'
+
+filename = ARGV[0] or fail 'Missing filename'
+
+image = Exiv2::ImageFactory.open(filename)
+image.read_metadata
+
+image.iptc_data.each do |key, value|
+  puts "#{key} = #{value}\n"
+end
+
+image.exif_data.each do |key, value|
+  puts "#{key} = #{value}\n"
+end
+
+image.xmp_data.each do |key, value|
+  puts "#{key} = #{value}\n"
+end

data/lib/scrub_jpeg.rb

@@ -0,0 +1,55 @@
+require "scrub_jpeg/version"
+require 'exiv2'
+
+module ScrubJpeg
+  class Scrubber
+    def initialize(filename)
+      info "Scrubbing... #{filename}"
+      @image = Exiv2::ImageFactory.open(filename)
+      @image.read_metadata
+    rescue Exiv2::BasicError
+      warn "Cannot open file: #{filename}"
+    end
+
+    def scrub!
+      delete_all_iptc_tags
+      delete_all_exif_tags
+      delete_all_xmp_tags
+      @image.write_metadata
+    end
+
+    private
+
+    def iptc_tags
+      @image.iptc_data.map(&:first)
+    end
+
+    def exif_tags
+      @image.exif_data.map(&:first)
+    end
+
+    def xmp_tags
+      @image.xmp_data.map(&:first)
+    end
+
+    def delete_all_iptc_tags
+      iptc_tags.each { |x| @image.iptc_data.delete_all(x) }
+    end
+
+    def delete_all_exif_tags
+      exif_tags.each { |x| @image.exif_data.delete_all(x) }
+    end
+
+    def delete_all_xmp_tags
+      xmp_tags.each { |x| @image.xmp_data.delete_all(x) }
+    end
+
+    def info(msg)
+      puts "#{msg}"
+    end
+
+    def warn(msg)
+      puts "[WARNING] #{msg}"
+    end
+  end
+end

data/lib/scrub_jpeg/version.rb

@@ -0,0 +1,3 @@
+module ScrubJpeg
+  VERSION = "0.0.1"
+end

data/scrub_jpeg.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "scrub_jpeg/version"
+
+Gem::Specification.new do |s|
+  s.name        = "scrub_jpeg"
+  s.version     = ScrubJpeg::VERSION
+  s.authors     = ["Norbert Wojtowicz"]
+  s.email       = ["wojtowicz.norbert@gmail.com"]
+  s.homepage    = "https://github.com/pithyless/scrub_jpeg"
+  s.summary     = "Scrubs your images free of all metadata tags."
+  s.description = s.summary
+
+  s.rubyforge_project = "scrub_jpeg"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  s.add_runtime_dependency 'exiv2', '0.0.6'
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: scrub_jpeg
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Norbert Wojtowicz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-04 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: exiv2
+  requirement: &70272426498160 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - =
+      - !ruby/object:Gem::Version
+        version: 0.0.6
+  type: :runtime
+  prerelease: false
+  version_requirements: *70272426498160
+description: Scrubs your images free of all metadata tags.
+email:
+- wojtowicz.norbert@gmail.com
+executables:
+- scrub_jpeg
+- view_jpeg_info
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- bin/scrub_jpeg
+- bin/view_jpeg_info
+- lib/scrub_jpeg.rb
+- lib/scrub_jpeg/version.rb
+- scrub_jpeg.gemspec
+homepage: https://github.com/pithyless/scrub_jpeg
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: scrub_jpeg
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Scrubs your images free of all metadata tags.
+test_files: []