ICC Profile Converter

Een Python tool om TIFF-bestanden te converteren van een bron-ICC naar een doel-ICC profiel, met de optie om metadata te behouden via ExifTool.

---

Installatie

1. Clone of download dit project.

   git clone <repo-url>
   cd TIFF_ICCprofile

2. Installeer dependencies (Pillow + tqdm vereist).

   python -m venv .venv
   source .venv/bin/activate    # macOS/Linux
   .venv\Scripts\activate       # Windows
   pip install -r requirements.txt

3. ExifTool installeren

   • macOS/Linux: meestal via brew install exiftool of pakketbeheer.
   • Windows (zonder admin-rechten):
     1. Download ZIP van ExifTool website.
     2. Pak uit naar C:\Tools\exiftool-13.36_64 (of vergelijkbare versie).
     3. Hernoem exiftool(-k).exe naar exiftool.exe.

---

Configuratie van EXIFTOOL_PATH

In icc_convert.py staat bovenaan:

# Pas aan indien nodig
if platform.system() == "Windows":
    EXIFTOOL_PATH = r"C:\Tools\exiftool-13.36_64\exiftool.exe"
else:
    EXIFTOOL_PATH = ""  # gebruik 'exiftool' uit PATH

---

Gebruik

Basissyntax

python icc_convert.py [bestanden of mappen] -s <source.icc> -t <target.icc> [opties]

Voorbeelden

• Alle TIFFs in ./testdata converteren:

  python icc_convert.py ./testdata -s CNN8083DA.ICC -t AdobeRGB1998.icc

• Metadata behouden (volledige kopie, ModifyDate en MetadataDate bijgewerkt):

  python icc_convert.py ./testdata -s CNN8083DA.ICC -t AdobeRGB1998.icc --preserve-metadata all

• Alleen XMP metadata kopiëren:

  python icc_convert.py ./testdata -s CNN8083DA.ICC -t AdobeRGB1998.icc --preserve-metadata xmp

• Alle gevonden ICC-profielen tonen (inclusief extra map):

  python icc_convert.py --list-icc --icc-dirs ./iccprofiles

• Output in aparte map + logging naar CSV:

  python icc_convert.py ./testdata -s CNN8083DA.ICC -t AdobeRGB1998.icc --outdir ./converted --log resultaten.csv

• Forceren ondanks ICC mismatch:

  python icc_convert.py ./testdata -s CNN8083DA.ICC -t AdobeRGB1998.icc --force

• Configbestand gebruiken:

  python icc_convert.py ./testdata --config config.yaml

---

CLI Opties

Optie	Beschrijving
paths	Bestanden en/of mappen met TIFFs. Ondersteunt mix van .tif en .tiff.
-s, --source-icc	Bestandsnaam van het bronprofiel (zoals gevonden met --list-icc).
-t, --target-icc	Bestandsnaam van het doelprofiel (zoals gevonden met --list-icc).
--icc-dirs	Extra directories om ICC-profielen in te zoeken.
--list-icc	Toon alle gevonden ICC-profielen en stop daarna.
--overwrite	Overschrijf de originele bestanden.
--outdir	Map waar geconverteerde bestanden worden opgeslagen (default: ./output).
--log	Schrijf resultaten weg in een logbestand (CSV).
--force	Forceer conversie ook bij ICC mismatch (anders overslaan).
--preserve-metadata	Kopieer metadata met ExifTool: • smart – merge metadata (default gedrag) • all – volledige kopie (waarden kunnen genormaliseerd worden; ModifyDate/MetadataDate bijgewerkt) • xmp – alleen XMP secties
--config	YAML-configbestand met standaardwaarden.
--version	Toon de versie van de tool en stop.
-h, --help	Toon help.

---

Config.yaml voorbeeld

source_icc: CNN8083DA.ICC
target_icc: AdobeRGB1998.icc
outdir: ./converted
preserve_metadata: all

---

Workflow samengevat

1. Zoek ICC-profielen (--list-icc).
2. Kies bron- en doelprofiel.
3. Run conversie (-s ... -t ...).
4. Optioneel: metadata kopiëren (--preserve-metadata), logging (--log), outputmap (--outdir).
5. Gebruik --force om mismatches tóch te converteren.

---

Dev

[email protected] voor KB Digitalisering (09-2025).