forked/osxphotos
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated docs

Browse Source
This commit is contained in:
Rhet Turnbull
2021-01-20 07:08:08 -08:00
parent 8a935ffbc0
commit 0904a6e44d
2 changed files with 13 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
README.md
View File

@@ -347,18 +347,18 @@ Options:
images will be skipped. images will be skipped.
--sidecar FORMAT Create sidecar for each photo exported; valid --sidecar FORMAT Create sidecar for each photo exported; valid
FORMAT values: xmp, json, exiftool; --sidecar FORMAT values: xmp, json, exiftool; --sidecar
xmp: create XMP sidecar used by Adobe xmp: create XMP sidecar used by Digikam, Adobe
Lightroom, etc. The sidecar file is named in Lightroom, etc. The sidecar file is named in
format photoname.ext.xmp The XMP sidecar format photoname.ext.xmp The XMP sidecar
exports the following tags: Description, exports the following tags: Description,
Title, Keywords/Tags, Subject (set to Keywords Title, Keywords/Tags, Subject (set to Keywords
+ PersonInImage), PersonInImage, CreateDate, + PersonInImage), PersonInImage, CreateDate,
ModifyDate, GPSLongitude. ModifyDate, GPSLongitude, Face Regions
--sidecar json: (Metadata Working Group and Microsoft Photo).
create JSON sidecar useable by exiftool --sidecar json: create JSON sidecar useable by
(https://exiftool.org/) The sidecar file can exiftool (https://exiftool.org/) The sidecar
be used to apply metadata to the file with file can be used to apply metadata to the file
exiftool, for example: "exiftool with exiftool, for example: "exiftool
-j=photoname.jpg.json photoname.jpg" The -j=photoname.jpg.json photoname.jpg" The
sidecar file is named in format sidecar file is named in format
photoname.ext.json; format includes tag groups photoname.ext.json; format includes tag groups
@@ -373,10 +373,10 @@ Options:
--sidecar-drop-ext Drop the photo's extension when naming sidecar --sidecar-drop-ext Drop the photo's extension when naming sidecar
files. By default, sidecar files are named in files. By default, sidecar files are named in
format 'photo_filename.photo_ext.sidecar_ext', format 'photo_filename.photo_ext.sidecar_ext',
e.g. 'IMG_1234.JPG.json'. Use '--sidecar-drop- e.g. 'IMG_1234.JPG.xmp'. Use '--sidecar-drop-
ext' to ignore the photo extension. Resulting ext' to ignore the photo extension. Resulting
sidecar files will have name in format sidecar files will have name in format
'IMG_1234.json'. Warning: this may result in 'IMG_1234.xmp'. Warning: this may result in
sidecar filename collisions if there are files sidecar filename collisions if there are files
of different types but the same name in the of different types but the same name in the
output directory, e.g. 'IMG_1234.JPG' and output directory, e.g. 'IMG_1234.JPG' and

8
osxphotos/__main__.py
View File

@@ -816,11 +816,11 @@ def cli(ctx, db, json_, debug):
metavar="FORMAT", metavar="FORMAT",
type=click.Choice(["xmp", "json", "exiftool"], case_sensitive=False), type=click.Choice(["xmp", "json", "exiftool"], case_sensitive=False),
help="Create sidecar for each photo exported; valid FORMAT values: xmp, json, exiftool; " help="Create sidecar for each photo exported; valid FORMAT values: xmp, json, exiftool; "
"--sidecar xmp: create XMP sidecar used by Adobe Lightroom, etc. " "--sidecar xmp: create XMP sidecar used by Digikam, Adobe Lightroom, etc. "
"The sidecar file is named in format photoname.ext.xmp " "The sidecar file is named in format photoname.ext.xmp "
"The XMP sidecar exports the following tags: Description, Title, Keywords/Tags, " "The XMP sidecar exports the following tags: Description, Title, Keywords/Tags, "
"Subject (set to Keywords + PersonInImage), PersonInImage, CreateDate, ModifyDate, " "Subject (set to Keywords + PersonInImage), PersonInImage, CreateDate, ModifyDate, "
"GPSLongitude. " "GPSLongitude, Face Regions (Metadata Working Group and Microsoft Photo)."
f"\n--sidecar json: create JSON sidecar useable by exiftool ({_EXIF_TOOL_URL}) " f"\n--sidecar json: create JSON sidecar useable by exiftool ({_EXIF_TOOL_URL}) "
"The sidecar file can be used to apply metadata to the file with exiftool, for example: " "The sidecar file can be used to apply metadata to the file with exiftool, for example: "
'"exiftool -j=photoname.jpg.json photoname.jpg" ' '"exiftool -j=photoname.jpg.json photoname.jpg" '
@@ -836,8 +836,8 @@ def cli(ctx, db, json_, debug):
is_flag=True, is_flag=True,
help="Drop the photo's extension when naming sidecar files. " help="Drop the photo's extension when naming sidecar files. "
"By default, sidecar files are named in format 'photo_filename.photo_ext.sidecar_ext', " "By default, sidecar files are named in format 'photo_filename.photo_ext.sidecar_ext', "
"e.g. 'IMG_1234.JPG.json'. Use '--sidecar-drop-ext' to ignore the photo extension. " "e.g. 'IMG_1234.JPG.xmp'. Use '--sidecar-drop-ext' to ignore the photo extension. "
"Resulting sidecar files will have name in format 'IMG_1234.json'. " "Resulting sidecar files will have name in format 'IMG_1234.xmp'. "
"Warning: this may result in sidecar filename collisions if there are files of different " "Warning: this may result in sidecar filename collisions if there are files of different "
"types but the same name in the output directory, e.g. 'IMG_1234.JPG' and 'IMG_1234.MOV'.", "types but the same name in the output directory, e.g. 'IMG_1234.JPG' and 'IMG_1234.MOV'.",
) )