Welcome to geoextract
! This tool recursively extracts EXIF GPS data from images and outputs to CSV and HTML
geoextract
uses theexif
, a gem written in C that depends onlibexif
. To installlibexif
:
brew install libexif # Homebrew
sudo apt-get install libexif-dev # APT
sudo yum install libexif-devel # CentOS
- To install this gem onto your local machine, run:
bundle exec rake install
If you are using rbenv
, you might need to run rbenv rehash
as well.
Usage: geoextract [options]
-f, --format [FORMAT] Output format [csv|html]
Default: csv
-d, --directory [DIRECTORY] Directory to recursively search for images
Default: current directory
geoextract
is a UNIX-style tool, so it outputs to stdout
do you can grep it or redirect the output to files.
Prints GPS data in CSV format for images in the current directory and all subdirectories:
geoextract
Writes the CSV output into a file:
geoextract > output.csv
Writes the HTML output into a file:
geoextract --format html > output.html
Extracts data from images in the storage directory and its subdirectories:
geoextract --directory storage
- Displays the image path and the main GPS data first
- Detects images by MIME-type
- Handles images without EXIF data
- Converts data written in
Rational
numbers to more user-friendly formats.
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests.
You can open the code coverage report by running open coverage/index.html
.
You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.