Updated docs

2023-01-14 22:41:41 -08:00
parent de8f29a431
commit 2aa80996bf
23 changed files with 1442 additions and 278 deletions
--- a/docs/cli.html
+++ b/docs/cli.html
@@ -6,7 +6,7 @@
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="OSXPhotos Template System" href="template_help.html" /><link rel="prev" title="OSXPhotos Tutorial" href="tutorial.html" />

    <meta name="generator" content="sphinx-5.3.0, furo 2022.09.29"/>
-        <title>OSXPhotos Command Line Interface (CLI) - osxphotos 0.55.7 documentation</title>
+        <title>OSXPhotos Command Line Interface (CLI) - osxphotos 0.56.1 documentation</title>
      <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?digest=d81277517bee4d6b0349d71bb2661d4890b5617c" />
    <link rel="stylesheet" type="text/css" href="_static/copybutton.css" />
@@ -124,7 +124,7 @@
      </label>
    </div>
    <div class="header-center">
-      <a href="index.html"><div class="brand">osxphotos 0.55.7 documentation</div></a>
+      <a href="index.html"><div class="brand">osxphotos 0.56.1 documentation</div></a>
    </div>
    <div class="header-right">
      <div class="theme-toggle-container theme-toggle-header">
@@ -147,7 +147,7 @@
      <div class="sidebar-sticky"><a class="sidebar-brand" href="index.html">
  
  
-  <span class="sidebar-brand-text">osxphotos 0.55.7 documentation</span>
+  <span class="sidebar-brand-text">osxphotos 0.56.1 documentation</span>
  
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
  <input class="sidebar-search" placeholder=Search name="q" aria-label="Search">
@@ -200,11 +200,17 @@
 <h1>OSXPhotos Command Line Interface (CLI)<a class="headerlink" href="#osxphotos-command-line-interface-cli" title="Permalink to this heading">#</a></h1>
 <section id="osxphotos">
 <h2>osxphotos<a class="headerlink" href="#osxphotos" title="Permalink to this heading">#</a></h2>
-<p>osxphotos: query and export your Photos library</p>
+<p>osxphotos: the multi-tool for your Photos library</p>
 <div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>osxphotos <span class="o">[</span>OPTIONS<span class="o">]</span> COMMAND <span class="o">[</span>ARGS<span class="o">]</span>...
 </pre></div>
 </div>
 <p class="rubric">Options</p>
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-v">
+<span id="cmdoption-osxphotos-version"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--version</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-v" title="Permalink to this definition">#</a></dt>
+<dd><p>Show the version and exit.</p>
+</dd></dl>
+
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-osxphotos-db">
 <span class="sig-name descname"><span class="pre">--db</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;PHOTOS_LIBRARY_PATH&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-db" title="Permalink to this definition">#</a></dt>
@@ -217,12 +223,6 @@
 <dd><p>Print output in JSON format.</p>
 </dd></dl>

-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-v">
-<span id="cmdoption-osxphotos-version"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--version</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-v" title="Permalink to this definition">#</a></dt>
-<dd><p>Show the version and exit.</p>
-</dd></dl>
-
 <section id="osxphotos-about">
 <h3>about<a class="headerlink" href="#osxphotos-about" title="Permalink to this heading">#</a></h3>
 <p>Print information about osxphotos including license.</p>
@@ -974,6 +974,42 @@ to modify this behavior.</p>
 <dd><p>Search for photos with size &lt;= SIZE bytes. The size evaluated is the photo’s original size (when imported to Photos). Size may be specified as integer bytes or using SI or NIST units. For example, the following are all valid and equivalent sizes: ‘1048576’ ‘1.048576MB’, ‘1 MiB’.</p>
 </dd></dl>

+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-export-missing">
+<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos missing from disk.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-export-not-missing">
+<span class="sig-name descname"><span class="pre">--not-missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-not-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos present on disk (e.g. not missing).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-export-cloudasset">
+<span class="sig-name descname"><span class="pre">--cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-export-not-cloudasset">
+<span class="sig-name descname"><span class="pre">--not-cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-not-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-export-incloud">
+<span class="sig-name descname"><span class="pre">--incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are in iCloud (have been synched)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-export-not-incloud">
+<span class="sig-name descname"><span class="pre">--not-incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-not-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not in iCloud (have not been synched)</p>
+</dd></dl>
+
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-osxphotos-export-regex">
 <span class="sig-name descname"><span class="pre">--regex</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;REGEX</span> <span class="pre">TEMPLATE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-export-regex" title="Permalink to this definition">#</a></dt>
@@ -1004,12 +1040,6 @@ to modify this behavior.</p>
 <dd><p>Run function to filter photos. Use this in format: –query-function filename.py::function where filename.py is a python file you’ve created and function is the name of the function in the python file you want to call. Your function will be passed a list of PhotoInfo objects and is expected to return a filtered list of PhotoInfo objects. You may use more than one function by repeating the –query-function option with a different value. Your query function will be called after all other query options have been evaluated. See https://github.com/RhetTbull/osxphotos/blob/master/examples/query_function.py for example of how to use this option.</p>
 </dd></dl>

-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-export-missing">
-<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-missing" title="Permalink to this definition">#</a></dt>
-<dd><p>Export only photos missing from the Photos library; must be used with –download-missing.</p>
-</dd></dl>
-
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-osxphotos-export-deleted">
 <span class="sig-name descname"><span class="pre">--deleted</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-export-deleted" title="Permalink to this definition">#</a></dt>
@@ -2480,6 +2510,42 @@ If the same query option is provided multiple times, they are treated as
 <dd><p>Search for photos with size &lt;= SIZE bytes. The size evaluated is the photo’s original size (when imported to Photos). Size may be specified as integer bytes or using SI or NIST units. For example, the following are all valid and equivalent sizes: ‘1048576’ ‘1.048576MB’, ‘1 MiB’.</p>
 </dd></dl>

+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-query-missing">
+<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos missing from disk.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-query-not-missing">
+<span class="sig-name descname"><span class="pre">--not-missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-not-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos present on disk (e.g. not missing).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-query-cloudasset">
+<span class="sig-name descname"><span class="pre">--cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-query-not-cloudasset">
+<span class="sig-name descname"><span class="pre">--not-cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-not-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-query-incloud">
+<span class="sig-name descname"><span class="pre">--incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are in iCloud (have been synched)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-query-not-incloud">
+<span class="sig-name descname"><span class="pre">--not-incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-not-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not in iCloud (have not been synched)</p>
+</dd></dl>
+
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-osxphotos-query-regex">
 <span class="sig-name descname"><span class="pre">--regex</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;REGEX</span> <span class="pre">TEMPLATE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-query-regex" title="Permalink to this definition">#</a></dt>
@@ -2522,42 +2588,6 @@ If the same query option is provided multiple times, they are treated as
 <dd><p>Include only photos from the ‘Recently Deleted’ folder.</p>
 </dd></dl>

-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-query-missing">
-<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-missing" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos missing from disk.</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-query-not-missing">
-<span class="sig-name descname"><span class="pre">--not-missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-not-missing" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos present on disk (e.g. not missing).</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-query-cloudasset">
-<span class="sig-name descname"><span class="pre">--cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-cloudasset" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are part of an iCloud library</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-query-not-cloudasset">
-<span class="sig-name descname"><span class="pre">--not-cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-not-cloudasset" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are not part of an iCloud library</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-query-incloud">
-<span class="sig-name descname"><span class="pre">--incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-incloud" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are in iCloud (have been synched)</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-query-not-incloud">
-<span class="sig-name descname"><span class="pre">--not-incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-query-not-incloud" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are not in iCloud (have not been synched)</p>
-</dd></dl>
-
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-osxphotos-query-add-to-album">
 <span class="sig-name descname"><span class="pre">--add-to-album</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;ALBUM&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-query-add-to-album" title="Permalink to this definition">#</a></dt>
@@ -3011,6 +3041,42 @@ If the same query option is provided multiple times, they are treated as
 <dd><p>Search for photos with size &lt;= SIZE bytes. The size evaluated is the photo’s original size (when imported to Photos). Size may be specified as integer bytes or using SI or NIST units. For example, the following are all valid and equivalent sizes: ‘1048576’ ‘1.048576MB’, ‘1 MiB’.</p>
 </dd></dl>

+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-missing">
+<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos missing from disk.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-not-missing">
+<span class="sig-name descname"><span class="pre">--not-missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-not-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos present on disk (e.g. not missing).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-cloudasset">
+<span class="sig-name descname"><span class="pre">--cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-not-cloudasset">
+<span class="sig-name descname"><span class="pre">--not-cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-not-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-incloud">
+<span class="sig-name descname"><span class="pre">--incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are in iCloud (have been synched)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-not-incloud">
+<span class="sig-name descname"><span class="pre">--not-incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-not-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not in iCloud (have not been synched)</p>
+</dd></dl>
+
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-osxphotos-repl-regex">
 <span class="sig-name descname"><span class="pre">--regex</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;REGEX</span> <span class="pre">TEMPLATE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-repl-regex" title="Permalink to this definition">#</a></dt>
@@ -3053,42 +3119,6 @@ If the same query option is provided multiple times, they are treated as
 <dd><p>Include only photos from the ‘Recently Deleted’ folder.</p>
 </dd></dl>

-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-missing">
-<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-missing" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos missing from disk.</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-not-missing">
-<span class="sig-name descname"><span class="pre">--not-missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-not-missing" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos present on disk (e.g. not missing).</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-cloudasset">
-<span class="sig-name descname"><span class="pre">--cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-cloudasset" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are part of an iCloud library</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-not-cloudasset">
-<span class="sig-name descname"><span class="pre">--not-cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-not-cloudasset" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are not part of an iCloud library</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-incloud">
-<span class="sig-name descname"><span class="pre">--incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-incloud" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are in iCloud (have been synched)</p>
-</dd></dl>
-
-<dl class="std option">
-<dt class="sig sig-object std" id="cmdoption-osxphotos-repl-not-incloud">
-<span class="sig-name descname"><span class="pre">--not-incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-repl-not-incloud" title="Permalink to this definition">#</a></dt>
-<dd><p>Search for photos that are not in iCloud (have not been synched)</p>
-</dd></dl>
-
 </section>
 <section id="osxphotos-run">
 <h3>run<a class="headerlink" href="#osxphotos-run" title="Permalink to this heading">#</a></h3>
@@ -3135,6 +3165,589 @@ uses ‘/private/tmp/osxphotos_snapshots’</p>
 <dd><p>Specify Photos database path. Path to Photos library/database can be specified using either –db or directly as PHOTOS_LIBRARY positional argument. If neither –db or PHOTOS_LIBRARY provided, will attempt to find the library to use in the following order: 1. last opened library, 2. system library, 3. ~/Pictures/Photos Library.photoslibrary</p>
 </dd></dl>

+</section>
+<section id="osxphotos-sync">
+<h3>sync<a class="headerlink" href="#osxphotos-sync" title="Permalink to this heading">#</a></h3>
+<p>Sync metadata and albums between Photos libraries.</p>
+<p>Use sync to update metadata in a local Photos library to match
+metadata in another Photos library. The sync command works by
+finding identical photos in the local library and the import source
+and then updating the metadata in the local library to match the
+metadata in the import source. Photos are considered identical if
+their original filename and fingerprint match.</p>
+<p>The import source can be a Photos library or a metadata export file
+created with the –export option.</p>
+<p>The sync command can be useful if you have imported the same photos to
+multiple Photos libraries and want to keep the metadata in all libraries
+in sync.</p>
+<p>Metadata can be overwritten (–set) or merged (–merge) with the metadata
+in the import source. You may specify specific metadata to sync or sync
+all metadata. See –set and –merge for more details.</p>
+<p>The sync command can be used to sync metadata between an iPhone or iPad
+and a Mac, for example, in the case where you do not use iCloud but
+manually import photos from your iPhone or iPad to your Mac. To do this,
+you’ll first need to copy the Photos database from the iPhone or iPad to
+your Mac. This can be done by connecting your iPhone or iPad to your Mac
+using a USB cable and then copying the Photos database from the iPhone
+using a third-party tool such as iMazing (<a class="reference external" href="https://imazing.com/">https://imazing.com/</a>). You can
+then use the sync command and set the import source to the Photos database
+you copied from the iPhone or iPad.</p>
+<p>The sync command can also be used to sync metadata between users using
+iCloud Shared Photo Library. NOTE: This use case has not yet been
+tested. If you use iCloud Shared Photo Library and would like to help
+test this use case, please connect with me on GitHub:
+<a class="reference external" href="https://github.com/RhetTbull/osxphotos/issues/887">https://github.com/RhetTbull/osxphotos/issues/887</a></p>
+<p>You can run the –export and –import commands together. In this case,
+the import will be run first and then the export will be run.</p>
+<p>For example, if you want to sync two Photos libraries between users or
+two different computers, you can export the metadata to a shared folder.</p>
+<p>On the first computer, run:</p>
+<p>osxphotos sync –export /path/to/export/folder/computer1.db –merge all –import /path/to/export/folder/computer2.db</p>
+<p>On the second computer, run:</p>
+<p>osxphotos sync –export /path/to/export/folder/computer2.db –merge all –import /path/to/export/folder/computer1.db</p>
+<div class="highlight-shell notranslate"><div class="highlight"><pre><span></span>osxphotos sync <span class="o">[</span>OPTIONS<span class="o">]</span>
+</pre></div>
+</div>
+<p class="rubric">Options</p>
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-e">
+<span id="cmdoption-osxphotos-sync-export"></span><span class="sig-name descname"><span class="pre">-e</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--export</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;EXPORT_FILE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-e" title="Permalink to this definition">#</a></dt>
+<dd><p>Export metadata to file EXPORT_FILE for later use with –import. The export file will be a SQLite database; it is recommended to use the .db extension though this is not required.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-i">
+<span id="cmdoption-osxphotos-sync-import"></span><span class="sig-name descname"><span class="pre">-i</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--import</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;IMPORT_PATH&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-i" title="Permalink to this definition">#</a></dt>
+<dd><p>Import metadata from file IMPORT_PATH. IMPORT_PATH can a Photos library, a Photos database, or a metadata export file created with –export.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-s">
+<span id="cmdoption-osxphotos-sync-set"></span><span class="sig-name descname"><span class="pre">-s</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--set</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;METADATA&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-s" title="Permalink to this definition">#</a></dt>
+<dd><p>When used with –import, set metadata in local Photos library to match import data. Multiple metadata properties can be specified by repeating the –set option or by using a comma-separated list. METADATA can be one of: all, keywords, albums, title, description, favorite. For example, to set keywords and favorite, use <cite>–set keywords –set favorite</cite> or <cite>–set keywords,favorite</cite>. If <cite>–set all</cite> is specified, all metadata will be set. Note that using –set overwrites any existing metadata in the local Photos library. For example, if a photo is marked as favorite in the local library but not in the import source, –set favorite will clear the favorite status in the local library. The exception to this is that <cite>–set album</cite> will not remove the photo from any existing albums in the local library but will add the photo to any new albums specified in the import source.See also –merge.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-m">
+<span id="cmdoption-osxphotos-sync-merge"></span><span class="sig-name descname"><span class="pre">-m</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--merge</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;METADATA&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-m" title="Permalink to this definition">#</a></dt>
+<dd><p>When used with –import, merge metadata in local Photos library with import data. Multiple metadata properties can be specified by repeating the –merge option or by using a comma-separated list. METADATA can be one of: all, keywords, albums, title, description, favorite. For example, to merge keywords and favorite, use <cite>–merge keywords –merge favorite</cite> or <cite>–merge keywords,favorite</cite>. If <cite>–merge all</cite> is specified, all metadata will be merged. Note that using –merge does not overwrite any existing metadata in the local Photos library. For example, if a photo is marked as favorite in the local library but not in the import source, –merge favorite will not change the favorite status in the local library. See also –set.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-R">
+<span id="cmdoption-osxphotos-sync-r"></span><span id="cmdoption-osxphotos-sync-report"></span><span class="sig-name descname"><span class="pre">-R</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--report</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;REPORT_FILE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-R" title="Permalink to this definition">#</a></dt>
+<dd><p>Write a report of all photos that were processed with –import. The extension of the report filename will be used to determine the format. Valid extensions are: .csv (CSV file), .json (JSON), .db and .sqlite (SQLite database). REPORT_FILE may be a an osxphotos template string, for example, –report ‘update_{today.date}.csv’ will write a CSV report file named with today’s date. See also –append.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-A">
+<span id="cmdoption-osxphotos-sync-a"></span><span id="cmdoption-osxphotos-sync-append"></span><span class="sig-name descname"><span class="pre">-A</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--append</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-A" title="Permalink to this definition">#</a></dt>
+<dd><p>If used with –report, add data to existing report file instead of overwriting it. See also –report.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-dry-run">
+<span class="sig-name descname"><span class="pre">--dry-run</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-dry-run" title="Permalink to this definition">#</a></dt>
+<dd><p>Dry run; when used with –import, don’t actually update metadata.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-V">
+<span id="cmdoption-osxphotos-sync-v"></span><span id="cmdoption-osxphotos-sync-verbose"></span><span class="sig-name descname"><span class="pre">-V</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--verbose</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-V" title="Permalink to this definition">#</a></dt>
+<dd><p>Print verbose output.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-T">
+<span id="cmdoption-osxphotos-sync-t"></span><span id="cmdoption-osxphotos-sync-timestamp"></span><span class="sig-name descname"><span class="pre">-T</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--timestamp</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-T" title="Permalink to this definition">#</a></dt>
+<dd><p>Add time stamp to verbose output.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-keyword">
+<span class="sig-name descname"><span class="pre">--keyword</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;KEYWORD&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-keyword" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with keyword KEYWORD. If more than one keyword, treated as “OR”, e.g. find photos matching any keyword</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-keyword">
+<span class="sig-name descname"><span class="pre">--no-keyword</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-keyword" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no keyword.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-person">
+<span class="sig-name descname"><span class="pre">--person</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;PERSON&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-person" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with person PERSON. If more than one person, treated as “OR”, e.g. find photos matching any person</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-album">
+<span class="sig-name descname"><span class="pre">--album</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;ALBUM&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-album" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos in album ALBUM. If more than one album, treated as “OR”, e.g. find photos matching any album</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-folder">
+<span class="sig-name descname"><span class="pre">--folder</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;FOLDER&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-folder" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos in an album in folder FOLDER. If more than one folder, treated as “OR”, e.g. find photos in any FOLDER.  Only searches top level folders (e.g. does not look at subfolders)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-name">
+<span class="sig-name descname"><span class="pre">--name</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;FILENAME&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-name" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with filename matching FILENAME. If more than one –name options is specified, they are treated as “OR”, e.g. find photos matching any FILENAME.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-uuid">
+<span class="sig-name descname"><span class="pre">--uuid</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;UUID&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-uuid" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with UUID(s). May be repeated to include multiple UUIDs.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-uuid-from-file">
+<span class="sig-name descname"><span class="pre">--uuid-from-file</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;FILE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-uuid-from-file" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with UUID(s) loaded from FILE. Format is a single UUID per line.  Lines preceded with # are ignored.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-title">
+<span class="sig-name descname"><span class="pre">--title</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;TITLE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-title" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for TITLE in title of photo.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-title">
+<span class="sig-name descname"><span class="pre">--no-title</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-title" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no title.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-description">
+<span class="sig-name descname"><span class="pre">--description</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;DESC&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-description" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for DESC in description of photo.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-description">
+<span class="sig-name descname"><span class="pre">--no-description</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-description" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no description.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-place">
+<span class="sig-name descname"><span class="pre">--place</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;PLACE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-place" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for PLACE in photo’s reverse geolocation info</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-place">
+<span class="sig-name descname"><span class="pre">--no-place</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-place" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no associated place name info (no reverse geolocation info)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-location">
+<span class="sig-name descname"><span class="pre">--location</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-location" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with associated location info (e.g. GPS coordinates)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-location">
+<span class="sig-name descname"><span class="pre">--no-location</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-location" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no associated location info (e.g. no GPS coordinates)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-label">
+<span class="sig-name descname"><span class="pre">--label</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;LABEL&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-label" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with image classification label LABEL (Photos 5 only). If more than one label, treated as “OR”, e.g. find photos matching any label</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-uti">
+<span class="sig-name descname"><span class="pre">--uti</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;UTI&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-uti" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos whose uniform type identifier (UTI) matches UTI</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-0">
+<span id="cmdoption-osxphotos-sync-ignore-case"></span><span class="sig-name descname"><span class="pre">-i</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--ignore-case</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-0" title="Permalink to this definition">#</a></dt>
+<dd><p>Case insensitive search for title, description, place, keyword, person, or album.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-edited">
+<span class="sig-name descname"><span class="pre">--edited</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-edited" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that have been edited.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-external-edit">
+<span class="sig-name descname"><span class="pre">--external-edit</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-external-edit" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos edited in external editor.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-favorite">
+<span class="sig-name descname"><span class="pre">--favorite</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-favorite" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos marked favorite.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-favorite">
+<span class="sig-name descname"><span class="pre">--not-favorite</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-favorite" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos not marked favorite.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-hidden">
+<span class="sig-name descname"><span class="pre">--hidden</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-hidden" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos marked hidden.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-hidden">
+<span class="sig-name descname"><span class="pre">--not-hidden</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-hidden" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos not marked hidden.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-shared">
+<span class="sig-name descname"><span class="pre">--shared</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-shared" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos in shared iCloud album (Photos 5 only).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-shared">
+<span class="sig-name descname"><span class="pre">--not-shared</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-shared" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos not in shared iCloud album (Photos 5 only).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-burst">
+<span class="sig-name descname"><span class="pre">--burst</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-burst" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that were taken in a burst.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-burst">
+<span class="sig-name descname"><span class="pre">--not-burst</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-burst" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not part of a burst.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-live">
+<span class="sig-name descname"><span class="pre">--live</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-live" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for Apple live photos</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-live">
+<span class="sig-name descname"><span class="pre">--not-live</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-live" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not Apple live photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-portrait">
+<span class="sig-name descname"><span class="pre">--portrait</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-portrait" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for Apple portrait mode photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-portrait">
+<span class="sig-name descname"><span class="pre">--not-portrait</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-portrait" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not Apple portrait mode photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-screenshot">
+<span class="sig-name descname"><span class="pre">--screenshot</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-screenshot" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for screenshot photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-screenshot">
+<span class="sig-name descname"><span class="pre">--not-screenshot</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-screenshot" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not screenshot photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-slow-mo">
+<span class="sig-name descname"><span class="pre">--slow-mo</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-slow-mo" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for slow motion videos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-slow-mo">
+<span class="sig-name descname"><span class="pre">--not-slow-mo</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-slow-mo" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not slow motion videos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-time-lapse">
+<span class="sig-name descname"><span class="pre">--time-lapse</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-time-lapse" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for time lapse videos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-time-lapse">
+<span class="sig-name descname"><span class="pre">--not-time-lapse</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-time-lapse" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not time lapse videos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-hdr">
+<span class="sig-name descname"><span class="pre">--hdr</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-hdr" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for high dynamic range (HDR) photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-hdr">
+<span class="sig-name descname"><span class="pre">--not-hdr</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-hdr" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not HDR photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-selfie">
+<span class="sig-name descname"><span class="pre">--selfie</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-selfie" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for selfies (photos taken with front-facing cameras).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-selfie">
+<span class="sig-name descname"><span class="pre">--not-selfie</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-selfie" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not selfies.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-panorama">
+<span class="sig-name descname"><span class="pre">--panorama</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-panorama" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for panorama photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-panorama">
+<span class="sig-name descname"><span class="pre">--not-panorama</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-panorama" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not panoramas.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-has-raw">
+<span class="sig-name descname"><span class="pre">--has-raw</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-has-raw" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with both a jpeg and raw version</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-only-movies">
+<span class="sig-name descname"><span class="pre">--only-movies</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-only-movies" title="Permalink to this definition">#</a></dt>
+<dd><p>Search only for movies (default searches both images and movies).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-only-photos">
+<span class="sig-name descname"><span class="pre">--only-photos</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-only-photos" title="Permalink to this definition">#</a></dt>
+<dd><p>Search only for photos/images (default searches both images and movies).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-from-date">
+<span class="sig-name descname"><span class="pre">--from-date</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;from_date&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-from-date" title="Permalink to this definition">#</a></dt>
+<dd><p>Search by item start date, e.g. 2000-01-12T12:00:00, 2001-01-12T12:00:00-07:00, or 2000-12-31 (ISO 8601 with/without timezone).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-to-date">
+<span class="sig-name descname"><span class="pre">--to-date</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;to_date&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-to-date" title="Permalink to this definition">#</a></dt>
+<dd><p>Search by item end date, e.g. 2000-01-12T12:00:00, 2001-01-12T12:00:00-07:00, or 2000-12-31 (ISO 8601 with/without timezone).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-from-time">
+<span class="sig-name descname"><span class="pre">--from-time</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;from_time&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-from-time" title="Permalink to this definition">#</a></dt>
+<dd><p>Search by item start time of day, e.g. 12:00, or 12:00:00.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-to-time">
+<span class="sig-name descname"><span class="pre">--to-time</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;to_time&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-to-time" title="Permalink to this definition">#</a></dt>
+<dd><p>Search by item end time of day, e.g. 12:00 or 12:00:00.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-year">
+<span class="sig-name descname"><span class="pre">--year</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;YEAR&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-year" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for items from a specific year, e.g. –year 2022 to find all photos from the year 2022. May be repeated to search multiple years.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-added-before">
+<span class="sig-name descname"><span class="pre">--added-before</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;DATE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-added-before" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for items added to the library before a specific date/time, e.g. –added-before e.g. 2000-01-12T12:00:00, 2001-01-12T12:00:00-07:00, or 2000-12-31 (ISO 8601 with/without timezone).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-added-after">
+<span class="sig-name descname"><span class="pre">--added-after</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;DATE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-added-after" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for items added to the libray after a specific date/time, e.g. –added-after e.g. 2000-01-12T12:00:00, 2001-01-12T12:00:00-07:00, or 2000-12-31 (ISO 8601 with/without timezone).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-added-in-last">
+<span class="sig-name descname"><span class="pre">--added-in-last</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;TIME_DELTA&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-added-in-last" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for items added to the library in the last TIME_DELTA, where TIME_DELTA is a string like ‘12 hrs’, ‘1 day’, ‘1d’, ‘1 week’, ‘2weeks’, ‘1 month’, ‘1 year’. for example, <cite>–added-in-last 7d</cite> and <cite>–added-in-last ‘1 week’</cite> are equivalent. months are assumed to be 30 days and years are assumed to be 365 days. Common English abbreviations are accepted, e.g. d, day, days or m, min, minutes.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-has-comment">
+<span class="sig-name descname"><span class="pre">--has-comment</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-has-comment" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that have comments.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-comment">
+<span class="sig-name descname"><span class="pre">--no-comment</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-comment" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no comments.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-has-likes">
+<span class="sig-name descname"><span class="pre">--has-likes</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-has-likes" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that have likes.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-no-likes">
+<span class="sig-name descname"><span class="pre">--no-likes</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-no-likes" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with no likes.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-is-reference">
+<span class="sig-name descname"><span class="pre">--is-reference</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-is-reference" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that were imported as referenced files (not copied into Photos library).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-reference">
+<span class="sig-name descname"><span class="pre">--not-reference</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-reference" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not references, that is, they were copied into the Photos library and are managed by Photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-in-album">
+<span class="sig-name descname"><span class="pre">--in-album</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-in-album" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are in one or more albums.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-in-album">
+<span class="sig-name descname"><span class="pre">--not-in-album</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-in-album" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not in any albums.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-duplicate">
+<span class="sig-name descname"><span class="pre">--duplicate</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-duplicate" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with possible duplicates. osxphotos will compare signatures of photos, evaluating date created, size, height, width, and edited status to find <em>possible</em> duplicates. This does not compare images byte-for-byte nor compare hashes but should find photos imported multiple times or duplicated within Photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-min-size">
+<span class="sig-name descname"><span class="pre">--min-size</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;SIZE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-min-size" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with size &gt;= SIZE bytes. The size evaluated is the photo’s original size (when imported to Photos). Size may be specified as integer bytes or using SI or NIST units. For example, the following are all valid and equivalent sizes: ‘1048576’ ‘1.048576MB’, ‘1 MiB’.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-max-size">
+<span class="sig-name descname"><span class="pre">--max-size</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;SIZE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-max-size" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos with size &lt;= SIZE bytes. The size evaluated is the photo’s original size (when imported to Photos). Size may be specified as integer bytes or using SI or NIST units. For example, the following are all valid and equivalent sizes: ‘1048576’ ‘1.048576MB’, ‘1 MiB’.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-missing">
+<span class="sig-name descname"><span class="pre">--missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos missing from disk.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-missing">
+<span class="sig-name descname"><span class="pre">--not-missing</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-missing" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos present on disk (e.g. not missing).</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-cloudasset">
+<span class="sig-name descname"><span class="pre">--cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-cloudasset">
+<span class="sig-name descname"><span class="pre">--not-cloudasset</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-cloudasset" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not part of an iCloud library</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-incloud">
+<span class="sig-name descname"><span class="pre">--incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are in iCloud (have been synched)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-not-incloud">
+<span class="sig-name descname"><span class="pre">--not-incloud</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-not-incloud" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos that are not in iCloud (have not been synched)</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-regex">
+<span class="sig-name descname"><span class="pre">--regex</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;REGEX</span> <span class="pre">TEMPLATE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-regex" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos where TEMPLATE matches regular expression REGEX. For example, to find photos in an album that begins with ‘Beach’: ‘–regex “^Beach” “{album}”’. You may specify more than one regular expression match by repeating ‘–regex’ with different arguments.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-selected">
+<span class="sig-name descname"><span class="pre">--selected</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-osxphotos-sync-selected" title="Permalink to this definition">#</a></dt>
+<dd><p>Filter for photos that are currently selected in Photos.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-exif">
+<span class="sig-name descname"><span class="pre">--exif</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;EXIF_TAG</span> <span class="pre">VALUE&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-exif" title="Permalink to this definition">#</a></dt>
+<dd><p>Search for photos where EXIF_TAG exists in photo’s EXIF data and contains VALUE. For example, to find photos created by Adobe Photoshop: <cite>–exif Software ‘Adobe Photoshop’ `or to find all photos shot on a Canon camera: `–exif Make Canon</cite>. EXIF_TAG can be any valid exiftool tag, with or without group name, e.g. <cite>EXIF:Make</cite> or <cite>Make</cite>. To use –exif, exiftool must be installed and in the path.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-query-eval">
+<span class="sig-name descname"><span class="pre">--query-eval</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;CRITERIA&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-query-eval" title="Permalink to this definition">#</a></dt>
+<dd><p>Evaluate CRITERIA to filter photos. CRITERIA will be evaluated in context of the following python list comprehension: <cite>photos = [photo for photo in photos if CRITERIA]</cite> where photo represents a PhotoInfo object. For example: <cite>–query-eval photo.favorite</cite> returns all photos that have been favorited and is equivalent to –favorite. You may specify more than one CRITERIA by using –query-eval multiple times. CRITERIA must be a valid python expression. See <a class="reference external" href="https://rhettbull.github.io/osxphotos/">https://rhettbull.github.io/osxphotos/</a> for additional documentation on the PhotoInfo class.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-query-function">
+<span class="sig-name descname"><span class="pre">--query-function</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;filename.py::function&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-query-function" title="Permalink to this definition">#</a></dt>
+<dd><p>Run function to filter photos. Use this in format: –query-function filename.py::function where filename.py is a python file you’ve created and function is the name of the function in the python file you want to call. Your function will be passed a list of PhotoInfo objects and is expected to return a filtered list of PhotoInfo objects. You may use more than one function by repeating the –query-function option with a different value. Your query function will be called after all other query options have been evaluated. See https://github.com/RhetTbull/osxphotos/blob/master/examples/query_function.py for example of how to use this option.</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-db">
+<span class="sig-name descname"><span class="pre">--db</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;PHOTOS_LIBRARY_PATH&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-db" title="Permalink to this definition">#</a></dt>
+<dd><p>Specify Photos database path. Path to Photos library/database can be specified using either –db or directly as PHOTOS_LIBRARY positional argument. If neither –db or PHOTOS_LIBRARY provided, will attempt to find the library to use in the following order: 1. last opened library, 2. system library, 3. ~/Pictures/Photos Library.photoslibrary</p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-osxphotos-sync-theme">
+<span class="sig-name descname"><span class="pre">--theme</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;THEME&gt;</span></span><a class="headerlink" href="#cmdoption-osxphotos-sync-theme" title="Permalink to this definition">#</a></dt>
+<dd><p>Specify the color theme to use for –verbose output. Valid themes are ‘dark’, ‘light’, ‘mono’, and ‘plain’. Defaults to ‘dark’ or ‘light’ depending on system dark mode setting.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Options<span class="colon">:</span></dt>
+<dd class="field-odd"><p>dark | light | mono | plain</p>
+</dd>
+</dl>
+</dd></dl>
+
 </section>
 <section id="osxphotos-theme">
 <h3>theme<a class="headerlink" href="#osxphotos-theme" title="Permalink to this heading">#</a></h3>
@@ -3527,6 +4140,7 @@ Commands:
 <li><a class="reference internal" href="#osxphotos-repl">repl</a></li>
 <li><a class="reference internal" href="#osxphotos-run">run</a></li>
 <li><a class="reference internal" href="#osxphotos-snap">snap</a></li>
+<li><a class="reference internal" href="#osxphotos-sync">sync</a></li>
 <li><a class="reference internal" href="#osxphotos-theme">theme</a></li>
 <li><a class="reference internal" href="#osxphotos-timewarp">timewarp</a></li>
 <li><a class="reference internal" href="#osxphotos-tutorial">tutorial</a></li>