https://github.com/dikayx/exifex

Extract exif and metadata from images.
https://github.com/dikayx/exifex

docker exif exif-data-extraction flask image-metadata python

Last synced: 10 months ago
JSON representation

Extract exif and metadata from images.

• Host: GitHub
• URL: https://github.com/dikayx/exifex
• Owner: dikayx
• License: mit
• Created: 2024-05-21T03:23:07.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-10-30T15:28:17.000Z (over 1 year ago)
• Last Synced: 2024-11-11T03:13:00.917Z (over 1 year ago)
• Topics: docker, exif, exif-data-extraction, flask, image-metadata, python
• Language: Python
• Homepage:
• Size: 770 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/CONTRIBUTING.md
  • License: LICENSE
  • Security: docs/SECURITY.md

Awesome Lists containing this project

README

          
# ExifEx

[![Python3](https://img.shields.io/badge/Python-3.10-blue.svg)](https://www.python.org/downloads/release/python-3100/)

[![License](https://img.shields.io/badge/License-MIT-lightgrey.svg)](LICENSE)

[![Build Status](https://github.com/dikayx/exifex/actions/workflows/python-app.yml/badge.svg)](https://github.com/dikayx/exifex/actions/workflows/python-app.yml)

ExifEx is a small utility tool to extract EXIF metadata from images. It is written in Python and Flask and uses the Pillow library to read the images and retrieve the metadata.

![Screenshot of the app](assets/screenshot.png)

_Example images taken from [this](https://github.com/ianare/exif-samples) repository._

## Features

-   🏞️ Extract EXIF metadata from images (_JPEG, PNG, TIFF, GIF, WebP, and more comming soon!_)

-   🕵️‍♀️ Display the metadata and GPS coordinates in a human-readable format

-   🌍 Generate a Google Maps link to the location where the image was taken (if available)

-   🗂️ Supports multiple images at once

-   📁 No data is stored on the server

-   🔒 Secure and privacy-friendly

## Get started

Download the latest release from the [releases page](https://github.com/dikayx/exifex/releases) and use the [setup.sh](setup.sh) (Mac & Linux) or [setup.bat](setup.bat) (Windows) script to set up the app via Docker or locally. For more detailed instructions, see the [installation guide](docs/INSTALLATION.md).

If you are already familiar with Git, you can use the commands below to clone the repository and run the setup script.

### Quickstart

To get the app up and running on Mac or Linux, run:

```bash

git clone https://github.com/dikayx/exifex.git && cd exifex && chmod +x setup.sh && ./setup.sh

```

On Windows, open a command prompt (cmd) and run:

```cmd

git clone https://github.com/dikayx/exifex.git && cd exifex && setup.bat

```

Follow the instructions in the terminal to start the app. By default, it will be available at [http://localhost:8080](http://localhost:8080). If you want to use SSL, see the [Securing the app with SSL](docs/INSTALLATION.md#securing-the-app-with-ssl) section in the installation guide.

### Usage

It's simple! Just drag and drop one or multiple images into the dropzone or click on it to select a file from your computer. The app will then display the extracted metadata and GPS coordinates (if available).

> **⚠️ Note**: Exif data can contain sensitive information, such as the location where the image was taken. Only analyze images you have the right to use.

## Contributing

If you want to contribute to the project, feel free to open an issue or a pull request. You can also suggest new features or improvements by [creating an issue](https://github.com/dikayx/exifex/issues). Check out the [contributing guidelines](docs/CONTRIBUTING.md) for more information.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.