Catalog

MCP tools that open catalogs and bring photos into one.

open_catalog

Open a catalog. Open a recent catalog or a catalog file and show it in DarkRay.

Bridge method: catalogs.open

Parameter	Type	Required	Details
catalog	string	yes	A catalog from list_catalogs, or a catalog file’s path.

Python: app.open_catalog(…)

from darkray_bridge import DarkRay

with DarkRay.connect() as app:
    # A recent or open catalog by name, or any catalog file by its path.
    key = app.open_catalog("Travel")
    app.open_catalog(r"D:\Catalogs\Clients 2026.db")

    # DarkRay now shows the catalog; changes go to the one shown.
    app.open_catalog(key)

import_photos

Import photos. Add the photos of a folder to the catalog where they are (no files are copied or moved); Remove from Catalog takes them out again. Returns a job: finished with the photos added when it ends within about 20 s, else running (follow it with get_jobs).

Bridge method: catalogs.import

Parameter	Type	Required	Details
folder	string	yes	The folder’s path.
recursive	boolean		Include subfolders. Default true.
catalog	string		A catalog from list_catalogs; omitted, the one DarkRay shows.

Python: app.import_photos(…)

from darkray_bridge import DarkRay

with DarkRay.connect() as app:
    # Adds the folder's photos where they are; nothing is copied or moved.
    job = app.import_photos(r"D:\Photos\2026\Iceland", recursive=True)
    job.wait()
    added = job.result["added"]

    # Show the new photos in the grid.
    app.show_photos(mode="grid", source={"kind": "all"})