Metadata-Version: 2.1
Name: whatsapp-media-tools
Version: 0.1.1
Summary: Python scripts to manage WhatsApp media backups for archival purposes
Home-page: https://github.com/Allain18/whatsapp-media-tools
Author: Alain Girard
Author-email: alaingirardvd@gmail.com
License: MIT License
Keywords: whatsapp,EXIF,image
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: piexif (>=1.1.3)

# whatsapp-media-tools
Python scripts to manage WhatsApp media backups for archival purposes.

## Usage

### Installation
` pip install whatsapp_media_tools`


### Restoring exif dates
```
usage: restore-exif [-h] [-r] [-m] path

Restore discarded Exif date information in WhatsApp media based on the filename. For videos, only the created and modified dates are set.

positional arguments:
  path             Path to WhatsApp media folder

options:
  -h, --help       show this help message and exit
  -r, --recursive  Recursively process media
  -m, --mod        Set file created/modified date on top of exif for images
```

### Finding duplicate media files
```
usage: find-duplicates [-h] [-c CHUNK_SIZE] [-f] [-r] [--dry-run] path

Remove duplicated media, preserving the file with the shortest filename or earliest date encoded in the filename.

positional arguments:
  path                  Path to WhatsApp media folder

options:
  -h, --help            show this help message and exit
  -c CHUNK_SIZE, --chunk-size CHUNK_SIZE
                        Chunk size for heuristic, smaller values are generally faster but if many files have identical starting chunks, performance degrades as more full hashes are computed
  -f, --force           Delete duplicates without prompting
  -r, --recursive       Recursively process media
  --dry-run             Dry run deletion (no files deleted)
  ```

  # License
  MIT License

  Original work by [Will Ho](https://ikarus.sg/whatsapp-exif-dates-duplicates/)
