Documentation

Learn Obscura Catalog.

The Obscura Catalog user guide: install, import, describe, catalogue, export, certify.

User guide

All chapters.

  1. 00
    Introduction

    Obscura Catalog is a macOS app to organise, describe and find your images, and to keep the catalogue raisonné of a photographic body of work: numbered works…

  2. 01
    Install and get started

    The licence and free tier, settings and updates, the main window, where Catalog keeps its data, backing up and restoring the library, moving it, keeping…

  3. 02
    Import a folder

    Turn a folder into a project, the SHA-256 fingerprint, duplicates, resume an interrupted import, locate a moved folder.

  4. 03
    Browse the library

    The grid, the keyboard, the loupe, comparison, the inspector, ratings, flags and labels, versions and relationships.

  5. 04
    Collections, tags and search

    Manual and smart collections, tags, quick search, advanced search and saved searches.

  6. 05
    EXIF and XMP metadata

    What Catalog reads, editing metadata, the XMP sidecar, writing into the file.

  7. 06
    The thesaurus

    Controlled vocabulary, hierarchy, synonyms, CSV import, CSV and SKOS export.

  8. 07
    Faces and similar photos

    On-Mac analysis, naming, merging and splitting people, close photos and likely duplicates, privacy.

  9. 08
    Import a Lightroom catalog

    Catalog read without being modified, dry run, what is carried over, resume and report.

  10. 09
    The catalogue raisonné: works

    Work and file, numbering, the record and its tabs (rights, relations, files, documents), the change history, statuses, completeness, creating works from files.

  11. 10
    Attributions, prints and provenance

    Competing attributions, editions and prints, conservation, the provenance chain and auction sales.

  12. 11
    Agents

    The directory of persons and organisations, authority identifiers, duplicates and merging, living persons.

  13. 12
    Exhibitions and publications

    Exhibition history and bibliography, shared by the whole corpus.

  14. 13
    Batch editing

    Edit several works, attribute in batch, series values, undo.

  15. 14
    Importing a CSV inventory

    Works, exhibitions and publications: column mapping, dry-run preview, unknown agents, rejection report.

  16. 15
    Exporting the catalogue

    CSV in twelve tables, LIDO 1.1, CIDOC CRM, the full library export, the package for Obscura Vault, and the confidentiality rule.

  17. 16
    Certificates of authenticity

    The signing key, issuing, re-issuing, revoking, verifying a PDF.

  18. 17
    Reports

    Portfolio, catalogue raisonné and inventory as PDF/A.

  19. 18
    Troubleshooting and FAQ

    File not found, interrupted import, publishing refused…

  20. 19
    Glossary

    The words of this guide.

  21. 20
    Input examples

    Screen by screen, what to type in each field, and CSV files ready to import.

Next step

Give every work its catalogue.

Obscura Catalog is available for macOS. Download it from the Obscura member area, or write to us to learn more.