A utility for exporting IIIF manifest data to ZIP files. LuxPort is specifically designed to work with Yale Library's digital collections and other IIIF-compliant repositories.
- 📦 Downloads and exports IIIF manifest data to a ZIP file
- 🖼️ Downloads all images in both full size and thumbnail formats
- 🧩 Saves the original JSON manifest and a simplified version
- 📁 Organizes content in a structured, accessible format
- 💻 Provides both a command-line interface and a Python API
- ⚡ Supports parallel batch processing for multiple manifests
- 🔗 Works with direct IIIF manifest URLs or Lux/Linked Art URLs
pip install luxportgit clone https://github.com/project-lux/luxport.git
cd luxport
pip install -e .from luxport import ManifestExporter
# Export a manifest from URL to ZIP file
exporter = ManifestExporter("https://collections.library.yale.edu/manifests/16867950")
exporter.export("yale_collection.zip")
# Export from a Lux URL
exporter = ManifestExporter("https://lux.collections.yale.edu/data/object/4ec7e7d5-c81b-453e-90a6-88a73e9a0171")
exporter.export("yale_diary.zip")
# Export using Linked Art format
exporter = ManifestExporter("https://linked-art.library.yale.edu/node/2b7fe907-b537-45b3-8cab-75db73d3bed0", format="la")
exporter.export("yale_la_export.zip")# Export a manifest by URL
luxport export https://collections.library.yale.edu/manifests/16867950 --output-dir ./exported
# Specify a custom output filename
luxport export https://collections.library.yale.edu/manifests/16867950 --output-file yale_collection.zip
# Export from a Lux URL
luxport export https://lux.collections.yale.edu/data/object/4ec7e7d5-c81b-453e-90a6-88a73e9a0171 --output-file yale_diary.zip
# Export using Linked Art format
luxport export https://linked-art.library.yale.edu/node/2b7fe907-b537-45b3-8cab-75db73d3bed0 --format la --output-file yale_la_export.zip
# Show help
luxport --help
luxport export --helpfrom luxport import ManifestExporter
# Export a manifest from URL to ZIP file
exporter = ManifestExporter("https://collections.library.yale.edu/manifests/16867950")
exporter.export("yale_collection.zip")
# Or export to a directory
exporter.export_to_directory("./exported")
# Work with Lux or Linked Art URLs
exporter = ManifestExporter("https://lux.collections.yale.edu/data/object/4ec7e7d5-c81b-453e-90a6-88a73e9a0171")
exporter.export("yale_lux_item.zip")LuxPort can process both Lux and Linked Art URLs:
from luxport import LuxParser
# Process a Lux URL to get IIIF manifest URLs
parser = LuxParser()
data = parser.get_data("https://lux.collections.yale.edu/data/object/4ec7e7d5-c81b-453e-90a6-88a73e9a0171")
manifest_urls = parser.find_iiif_manifests(data)
print(manifest_urls)
# Get Linked Art format of the same data
linked_art_data = parser.get_data("https://lux.collections.yale.edu/data/object/4ec7e7d5-c81b-453e-90a6-88a73e9a0171", format="la")You can also use the convenience function:
from luxport import process_lux_url
# Get IIIF manifest URLs from a Lux URL
manifest_urls = process_lux_url("https://lux.collections.yale.edu/data/object/4ec7e7d5-c81b-453e-90a6-88a73e9a0171")
print(manifest_urls)manifest_16867950.zip
├── manifest.json # Original JSON manifest
├── manifest_simplified.json # Simplified JSON manifest
├── images/
│ ├── full/ # Full-size images
│ │ ├── 16868023.jpg
│ │ ├── 16868024.jpg
│ │ └── ...
│ └── thumbnails/ # Thumbnail images
│ ├── 16868023.jpg
│ ├── 16868024.jpg
│ └── ...
├── metadata.txt # Extracted metadata in readable format
└── info.txt # Summary information about the export
from luxport import ManifestExporter
from concurrent.futures import ThreadPoolExecutor
# List of manifest URLs to export
manifests = [
"https://collections.library.yale.edu/manifests/16867950",
"https://collections.library.yale.edu/manifests/12345678"
]
def export_manifest(url, output_dir="./output"):
exporter = ManifestExporter(url)
manifest_id = exporter.downloader.get_manifest_id()
output_file = f"{output_dir}/manifest_{manifest_id}.zip"
exporter.export(output_file)
return output_file
# Export manifests in parallel using a thread pool
with ThreadPoolExecutor(max_workers=4) as executor:
results = list(executor.map(export_manifest, manifests))LuxPort includes utilities to simplify complex IIIF manifests into a more accessible format:
from luxport import ManifestDownloader
from luxport.utils import simplify_manifest
# Download a manifest
downloader = ManifestDownloader("https://collections.library.yale.edu/manifests/16867950")
manifest = downloader.download_manifest()
# Simplify it
simplified = simplify_manifest(manifest)
# Work with the simplified data
print(f"Title: {simplified['title']}")
print(f"Number of images: {len(simplified['images'])}")Several example scripts are included in the examples/ directory:
from luxport import ManifestExporter
# Create the exporter with a manifest URL
exporter = ManifestExporter("https://collections.library.yale.edu/manifests/16867950")
# Export to a ZIP file
exporter.export("output/manifest.zip")# Run the example
python examples/batch_export.py
# Export specific manifests
python examples/batch_export.py -m "https://collections.library.yale.edu/manifests/16867950" "https://collections.library.yale.edu/manifests/12345678"
# Specify output directory and parallel workers
python examples/batch_export.py -o ./batch_output -w 8# Analyze a manifest from a URL
python examples/analyze_manifest.py https://collections.library.yale.edu/manifests/16867950
# Analyze a previously exported ZIP file
python examples/analyze_manifest.py output/manifest_16867950.zip
# Save analysis results to a JSON file
python examples/analyze_manifest.py output/manifest_16867950.zip -o analysis.jsonpython tests.pypython -m buildpython -m twine upload dist/*Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Yale University Library for their IIIF implementation
- International Image Interoperability Framework (IIIF) community
- Project Lux at Yale University Library