Rollup/README.md

<img align='left' src='icon.iconset/icon_512x512.png' width='128'>

# Rollup

**Rollup** is a tool for renaming image files based on their EXIF tags. It was originally written to improve the arbitrary filenames in the iPhone Camera Roll.

####[⇩ Download Rollup 0.4.1.1](https://git1.profiteroles.org/p/Rollup/raw/master/Rollup.app.zip) ([Changelog](CHANGELOG.md))

## Features

* Recursive directory scanning
* Reverse Geocoding
* Custom rename template

## Available tags

| Option | Description |
| :------| :-----------|
| **%FILE** | The original filename |
| **%DTO** | Timestamp (with fallback to file modification date) |
| **%DUR** | Video Duration (formatted) |
| **%SW** | Software (formatted) |
| **%MODEL** | Digital Camera Model |
| **%LENS** | Lens (formatted) |
| **%PLACE** | Formatted location (from GPS coordinates) |

## Screenshots

<img src='screenshot_1.png' width='552'>
<img src='screenshot_2.png' width='1079'>

## Notes

- Running Rollup may require disabling Gatekeeper by running `sudo spctl --master-disable` in the Terminal
- Reverse Geocoding requires a valid Google API key. As of 2018, Google requires a paid account for access to the places database. Although a valid credit card is required to create the account, only massive searches incur fees. More here: https://developers.google.com/maps/documentation/geocoding/start
- The following characters are currently supported as delimiters: ' ','_','-','+'

## Building from source

Building Rollup requires Platypus and Pashua

* https://github.com/sveinbjornt/Platypus
* https://github.com/BlueM/Pashua