📜 PortaFontium Image Downloader

A Python tool for downloading full-resolution church book from the
Porta Fontium digital archive using the DeepZoom (DZI / JP2) protocol.

---

⚙️ Requirements

Install dependencies:

pip install -r requirements.txt

---

▶️ Usage

Run the script:

python main.py

Then paste any Porta Fontium image detail URL, for example:

https://www.portafontium.eu/iipimage/30063600/karlovy-vary-evangelicka-07_0100-z

You’ll then be asked to enter a filename (without extension).
If you just press Enter, the default name page_full.jpg will be used.

Example:

=== Porta Fontium DZI Image Downloader ===
Enter image detail URL (or 'exit' to quit): https://www.portafontium.eu/iipimage/30063600/karlovy-v...
Enter output file name (default: page_full):
🔍 Extracting DeepZoom path...
📄 Found: register/soap-pn/karlovy-vary-evangelicka/karlovy-v...
📥 Fetching DZI metadata...
🧠 Metadata: {'tile_size': 256, 'width': 3453, 'height': 2592, 'format': 'jpg'}
🔍 Using zoom level 12
🧩 Image size: 3453×2592
🧱 Tile size: 256
📦 Tiles: 14×11 = 154

|████████████████████████████████████████| 100.0% (154/154)
🖼️ Saving final image...
✅ Done! Saved as 'page_full.jpg'

You can download multiple images in one session —
just press Enter again when prompted to start a new download.

Type exit to quit the program.

---

🧱 Building an EXE (Windows)

To create a standalone .exe file that runs without Python:

pyinstaller --onefile --name "PortaFontiumDownloader" main.py

After building, run it using:

dist\PortaFontiumDownloader.exe

The console will remain open after each download so you can continue downloading more images.

---

🌍 About

This tool is designed for accessing digitized parish books
from the Porta Fontium digital archive.

It extracts the correct DeepZoom JP2 path from the detail page, retrieves and parses the DZI metadata descriptor, and downloads all image tiles and merges them into one full-resolution .jpg file.