Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xevion/phototag
Rich tagging in the Terminal via Google Vision API
https://github.com/xevion/phototag
click google-vision-api iptc iptc-metadata jpeg label labeling metadata photo-tagging python python-click python3 raw raw-image vision-api
Last synced: 27 days ago
JSON representation
Rich tagging in the Terminal via Google Vision API
- Host: GitHub
- URL: https://github.com/xevion/phototag
- Owner: Xevion
- License: gpl-3.0
- Created: 2019-08-03T23:51:48.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-05-12T07:41:12.000Z (over 1 year ago)
- Last Synced: 2023-05-12T08:25:35.005Z (over 1 year ago)
- Topics: click, google-vision-api, iptc, iptc-metadata, jpeg, label, labeling, metadata, photo-tagging, python, python-click, python3, raw, raw-image, vision-api
- Language: Python
- Homepage: https://xevion.dev/phototag
- Size: 30.6 MB
- Stars: 8
- Watchers: 3
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Built by Xevion
Phototag is a personal tool I use to automatically generate and layer tags describing a photo in a fast and easy way. It
uses Google's Vision API and supports IPTC metadata and Adobe XMP Sidecar files on Windows.
### Features
* Automatic tagging of photos using Google's Vision API
* Cheap, Fast and Accurate
* Minimal Data Usage
* Compresses and thumbnails images before sending to Google
* Support for both JPEG and RAW
* Store tags in JPEG via IPTC metadata
* Store tags in RAW files via Adobe's XMP sidecar files
* Full support for NEF only, CR2 and more untested
* Requires a existing XMP file to be available
### Installation
The project is currently not on PyPi yet. Until then, clone and install like so:
```bash
pip install
```
For development, install all dependencies with `pipenv`:
```bash
pipenv install
pip install -e . # Editable mode to use the folder's current source files
# You can also install the Phototag package with
pipenv install -e .
```
### Usage
Documentation of all functions is included by default with the `--help` flag.
```bash
# Copy the JSON authentication file for Google Vision API access
phototag auth [file]
phototag run
````
### Uninstallation
```bash
pip uninstall phototag
```
### How does it work?
This application is built in Python and utilizes the `google-cloud` python module family.
The basic process for each photo be tagged is as follows
1. Build relevant paths and identify important information used throughout the process
2. Save RAW files as JPEG using `rawpy`
3. Optimize JPEG files using thumbnailing and quality measures
4. Open and send the file to Google using the Vision API with `google_cloud.vision`
5. Compile and save the image's labels from Google
- JPEGs use the `iptcinfo3` module to save
- RAW files use a messy implementation of the `xml` module to read and write tags (experimental) from and to the XMP
Sidecar file used by Adobe
6. Delete the temporary (optimized) file and move the original image to the output folder.
The command used to access this program is `phototag run`, which would process and label all eligible images in the
current working directory.
### To-do
* Performance
* Async/Threading/Parallelization
* With configurable limits/targets
* GPU-accelerated Image Thumbnailing
* Memory/Disk Usage Metering
* Image Hashing & Tag Caching
* File Filtering
* Regex/Glob Pattern Matching
* Include/Exclude Files/Directories
* Tag Filtering
* Include/Exclude Tags
* Compatability
* All popular RAW formats
* Adobe XMP sidecar files
* Configuration
* Pull from configuration files with runtime overrides
* Logging
* Add additional logs
* Allow configuration of verbosity/level application wide