A command-line metadata viewer for TIFF Revision 6.0 files.

Download the latest tiffany executable for macOS from the Releases page.

After downloading, you first need to make the file executable. Open your terminal, navigate to the directory where you downloaded the file (e.g., ~/Downloads), and run:

chmod +x tiffany

Note: On the first run, macOS may show a security warning because the application is not signed. To bypass this, you can right-click the file in Finder, select "Open," and then confirm in the dialog box. You only need to do this once.

You can now run the tool directly from the folder where you downloaded it.

Use the --file (or -f) flag, pointing to your TIFF file.

./tiffany --file image.tiff

Or using the short flag:

./tiffany -f image.tiff

Example Output:

Tag Name                       | Value(s)
--------------------------------------------------------------------------------
ImageWidth                     | 100 
ImageLength                    | 100 
BitsPerSample                  | 16 
Compression                    | 1 
PhotometricInterpretation      | 1 
FillOrder                      | 1 
Make                           | Canon
Model                          | EOS 5D Mark IV
StripOffsets                   | 8 
Orientation                    | 1 
SamplesPerPixel                | 1 
RowsPerStrip                   | 100 
StripByteCounts                | 20000 
PlanarConfiguration            | 1 
PageNumber                     | 0 1 
WhitePoint                     | 0.3127 0.329 
...

For convenience, you can move the executable to a directory in your system's PATH. This allows you to call tiffany from any directory without needing the ./ prefix. A common location for user-installed command-line tools is /usr/local/bin.

# Move the tiffany executable to /usr/local/bin
# You may be prompted for your password
sudo mv tiffany /usr/local/bin/

Now you can run the command from anywhere:

tiffany -f /path/to/any/image.tiff

To see all available options, use the --help flag:

./tiffany --help

Or, if you moved it to your path:

tiffany --help

If you prefer to build the executable yourself, you will need:

• Maven
• A GraalVM JDK for Java 17 or later

The easiest way to install GraalVM is with SDKMAN!:

# Install GraalVM and the native-image tool
sdk install java 22.3.r17-grl
gu install native-image

Then, clone the repository and run the Maven build with the native profile:

git clone https://github.com/rossheat/tiffany.git
cd tiffany
mvn clean package -Pnative

The final executable will be located at target/tiffany.

This project is released under the MIT License.