# Name2Exif

**Restore EXIF timestamps from filenames — batch desktop utility.**

[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

![GUI preview of Name2Exif](image.png)

## What it does

Name2Exif parses date and time values from camera/phone filenames and writes them into standard EXIF date fields (`DateTimeOriginal`, `DateTimeDigitized`, `DateTime`). Use it when timestamps are lost after transfers to SD cards or when EXIF is missing.

## Installation



## Key features

- Batch processing of JPEG/HEIC images.
- Multiple filename pattern presets and manual pattern entry.
- Auto-detect common filename formats (Pixel, Samsung, iPhone exports).
- Token based regex pattern builder
- Preview parsed dates before applying.
- Optional: sync filesystem timestamps with EXIF.
- Drag and drop functionality

## Quick install
1. Clone github repository
2. Create a virtualenv:
```sh
python -m venv .venv
```
3. Activate (Windows):
```sh
.venv\Scripts\activate
```
4. Install:
```sh
pip install -r requirements.txt
```
5. Run:
```sh
python app.py
```
> [!NOTE]
>
> ### Android phone storage note
>
> Name2Exif cannot modify files directly on Android devices connected via USB (MTP).
> Files must be copied to local storage first due to protocol limitations.