1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Metadata</title>
6 <link rel="previous" href="GuideOptionsFiltering.html" title="Files Options">
7 <link rel="next" href="GuideOptionsKeywords.html" title="Keywords">
8 <link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
9 <style type="text/css">
11 html { height: 100%; }
13 margin: 0px; padding: 12px;
14 background-color: #f9f9f6;
18 div, p, pre, blockquote { margin: 0; padding: 0; }
19 p img { vertical-align: middle; }
20 sub { font-size: 0.83em; }
21 sub sub { font-size: 1em; }
22 sup { font-size: 0.83em; }
23 sup sup { font-size: 1em; }
24 table { border-collapse: collapse; }
25 table.table-pgwide { width: 100%; }
26 td { vertical-align: top; }
27 td { padding: 0.2em 0.83em 0.2em 0.83em; }
28 th { padding: 0 0.83em 0 0.83em; }
30 background-color: #f9f9f6;
32 td.td-colsep { border-right: solid 1px; }
33 td.td-rowsep { border-bottom: solid 1px; }
34 thead { border-top: solid 2px; border-bottom: solid 2px; }
35 tfoot { border-top: solid 2px; border-bottom: solid 2px; }
39 background-color: #ffffff;
40 border: solid 1px #e0e0df;
45 div.division div.division { margin-top: 1.72em; }
46 div.division div.division div.division { margin-top: 1.44em; }
50 border-bottom: solid 1px #e0e0df;
52 h1, h2, h3, h4, h5, h6, h7 {
53 margin: 0; padding: 0;
56 h1.title { font-size: 1.72em; }
57 h2.title { font-size: 1.44em; }
58 h3.title { font-size: 1.2em; }
59 h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
60 .block { margin-top: 1em; }
61 .block .block-first { margin-top: 0; }
63 margin-left left: 1.72em;
66 .block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
67 td .block-indent { margin-left: 0em; margin-right: 0em; }
68 dd .block-indent { margin-left: 0em; margin-right: 0em; }
69 .block-verbatim { white-space: pre; }
75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
76 div.title-formal .label { font-weight: normal; }
79 text-decoration: none;
81 a:hover { text-decoration: underline; }
82 a:visited { color: #9f1f6f; }
83 ul, ol, dl { margin: 0; padding: 0; }
89 li.li-first { margin-top: 0; }
90 dt { margin: 1em 0 0 0; }
91 dt.dt-first { margin: 0; }
96 dl.dl-compact dt { margin-top: 0; }
97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
105 li.linktrail { display: inline; margin: 0; padding: 0; }
107 li.linktrail::before {
112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
116 padding: 0.5em 1em 0.5em 1em;
118 background-color: #ffffff;
119 border: solid 1px #e0e0df;
121 div.navbar-top { margin-bottom: 1em; }
122 div.navbar-bottom { margin-top: 1em; clear: both; }
123 div.navbar img { border: 0; vertical-align: -0.4em; }
124 table.navbar { width: 100%; margin: 0; border: none; }
125 table.navbar td { padding: 0; border: none; }
129 a.navbar-prev::before {
134 a.navbar-next::after {
143 padding: 0; margin: 0; width: 12em;
146 padding: 0.5em 1em 0 1em;
147 background-color: #ffffff;
148 border: solid 1px #e0e0df;
150 div.sidenav div.autotoc {
151 background-color: #ffffff;
152 border: none; padding: 0; margin: 0;
154 div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
155 div.sidenav div.autotoc li { margin-bottom: 0.5em; }
156 div.sidenav div.autotoc div.autotoc div.autotoc {
160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
168 padding: 0.5em 1em 0.5em 1em;
169 background-color: #f0f9ff;
170 border: solid 1px #c0c9ff;
172 div.autotoc ul { margin: 0; padding: 0; }
173 div.autotoc li { list-style-type: none; margin: 0; }
174 div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
175 div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
176 div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
185 padding: 0.5em 6px 0.5em 6px;
186 border: solid 1px #e0e0df;
187 background-color: #fffff0;
189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
191 background-position: left top;
192 background-repeat: no-repeat;
195 div.caution-inner { background-image: url("admon-caution.png"); }
196 div.important-inner { background-image: url("admon-important.png"); }
197 div.note-inner { background-image: url("admon-note.png"); }
198 div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
199 div.tip-inner { background-image: url("admon-tip.png"); }
200 div.warning-inner { background-image: url("admon-warning.png"); }
203 background-image: url('watermark-blockquote-201C.png');
204 background-repeat: no-repeat;
205 background-position: top left;
213 div.attribution::before {
223 div.figure, div.informalfigure {
227 background-color: #f9f9f6;
228 border: solid 1px #e0e0df;
230 div.figure-inner, div.informalfigure-inner {
232 background-color: #ffffff;
233 border: solid 1px #e0e0df;
235 div.caption { margin-top: 0.5em; }
239 background-color: #f9f9f6;
240 border: solid 1px #e0e0df;
245 background-color: #f9f9f6;
246 border: solid 1px #e0e0df;
251 div.screen .userinput {
255 div.programlisting .userinput {
269 dl.index dt { margin-top: 0; }
270 dl.index dd { margin-top: 0; margin-bottom: 0; }
271 dl.indexdiv dt { margin-top: 0; }
272 dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
273 dl.setindex dt { margin-top: 0; }
274 dl.setindex dd { margin-top: 0; margin-bottom: 0; }
275 div.list div.title-formal span.title {
276 border-bottom: solid 1px #e0e0df;
281 div.simplelist table { margin-left: 0; border: none; }
284 border-left: solid 1px #e0e0df;
286 div.simplelist td.td-first {
293 background-color: #f9f9f6;
294 border-top: solid 2px #c0c9ff;
295 border-bottom: solid 2px #c0c9ff;
297 div.synopsis div.synopsis {
301 div.synopsis div.block { margin-top: 0.2em; }
302 div.synopsis div.block-first { margin-top: 0; }
303 div.cmdsynopsis { font-family: monospace; }
305 span.accel { text-decoration: underline; }
306 span.acronym { font-family: sans-serif; }
307 span.application { font-style: italic; }
308 span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
310 font-family: monospace;
311 border: solid 1px #e0e0df;
313 padding-right: 0.2em;
315 pre span.code { border: none; padding: 0; }
317 font-family: monospace;
318 border: solid 1px #e0e0df;
320 padding-right: 0.2em;
322 pre span.command { border: none; padding: 0; }
323 span.computeroutput { font-family: monospace; }
325 span.constant { font-family: monospace; }
326 span.database { font-family: monospace; }
327 span.email { font-family: monospace; }
328 span.emphasis { font-style: italic; }
329 span.emphasis-bold { font-style: normal; font-weight: bold; }
330 span.envar { font-family: monospace; }
332 span.filename { font-family: monospace; }
333 span.firstterm { font-style: italic; }
334 span.foreignphrase { font-style: italic; }
335 span.function { font-family: monospace; }
337 dt.glossterm span.glossterm { font-style: normal; }
340 span.glossterm { font-style: italic; }
342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
350 span.lineannotation { font-style: italic; }
351 span.literal { font-family: monospace; }
352 span.markup { font-family: monospace; }
353 span.medialabel { font-style: italic; }
354 span.methodname { font-family: monospace; }
355 span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
356 span.option { font-family: monospace; }
357 span.parameter { font-family: monospace; }
358 span.paramdef span.parameter { font-style: italic; }
359 span.prompt { font-family: monospace; }
360 span.property { font-family: monospace; }
361 span.replaceable { font-style: italic; }
362 span.returnvalue { font-family: monospace; }
363 span.sgmltag { font-family: monospace; }
364 span.structfield, span.structname { font-family: monospace; }
365 span.symbol { font-family: monospace; }
366 span.systemitem { font-family: monospace; }
367 span.token { font-family: monospace; }
368 span.type { font-family: monospace; }
369 span.uri { font-family: monospace; }
370 span.userinput { font-family: monospace; }
371 span.varname { font-family: monospace; }
372 span.wordasword { font-style: italic; }
376 div.footnotes { font-style: italic; font-size: 0.8em; }
377 div.footnote { margin-top: 1.44em; }
378 span.footnote-number { display: inline; padding-right: 0.83em; }
379 span.footnote-number + p { display: inline; }
380 a.footnote { text-decoration: none; font-size: 0.8em; }
381 a.footnote-ref { text-decoration: none; }
384 margin-left: 0.2em; margin-right: 0.2em;
385 padding-left: 0.4em; padding-right: 0.4em;
386 border: solid 1px #000000;
387 -moz-border-radius: 8px;
388 background-color: #000000;
393 border-color: #333333;
394 background-color: #333333;
397 span.co a { text-decoration: none; }
398 span.co a:hover { text-decoration: none; }
400 dt.question { margin-left: 0em; }
401 dt.question div.label { float: left; }
402 dd + dt.question { margin-top: 1em; }
408 dd.answer div.label { float: left; }
412 <div class="navbar navbar-top"><table class="navbar"><tr>
413 <td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsFiltering.html" title="Files Options">Files Options</a></td>
414 <td class="navbar-next"><a class="navbar-next" href="GuideOptionsKeywords.html" title="Keywords">Keywords</a></td>
416 <div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
417 <li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
419 <a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
420 <li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
421 <li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
422 <li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
423 <li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
424 <li><a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
425 <li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
426 <li><a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a></li>
427 <li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
428 <li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
429 <li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
431 <a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a><div class="autotoc"><ul>
432 <li><a class="xref" href="GuideOptionsGeneral.html" title="General Options">General Options</a></li>
433 <li><a class="xref" href="GuideOptionsImage.html" title="Image Options">Image Options</a></li>
434 <li><a class="xref" href="GuideOptionsWindow.html" title="Window Options">Window Options</a></li>
435 <li><a class="xref" href="GuideOptionsKeyboard.html" title="Keyboard Options">Keyboard Options</a></li>
436 <li><a class="xref" href="GuideOptionsFiltering.html" title="Files Options">Files Options</a></li>
438 <li><a class="xref" href="GuideOptionsKeywords.html" title="Keywords">Keywords</a></li>
439 <li><a class="xref" href="GuideOptionsColor.html" title="Color management options">Color management options</a></li>
440 <li><a class="xref" href="GuideOptionsStereo.html" title="Stereo image management">Stereo image management</a></li>
441 <li><a class="xref" href="GuideOptionsBehavior.html" title="Behavior Options">Behavior Options</a></li>
442 <li><a class="xref" href="GuideOptionsToolbar.html" title="Toolbar">Toolbar</a></li>
445 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
446 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
447 <li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
448 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
449 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
450 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
453 </ul></div></div></div>
454 <div class="body body-sidebar"><div class="division section">
455 <a name="GuideOptionsMetadata"></a><div class="header"><h1 class="section title"><span class="title"><a name="titleGuideOptionsMetadata"></a>Metadata</span></h1></div>
456 <ul class="linktrail">
457 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
458 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
460 <p class="para block block-first">This section describes the options for metadata writing.</p>
461 <p class="para block"></p>
462 <p class="para block">
464 <a class="link" href="GuideOptionsFiltering.html#Filetypes" title="File types">Files tab of Preferences</a>
465 influence whether an attempt is made to write metadata to the file itself, to a sidecar file or to a local folder.
467 <p class="para block">
469 <a class="link" href="GuideReferenceMetadata.html" title="Metadata Processing">Metadata Processing</a>
470 in the Reference section.
472 <div class="autotoc"><ul>
474 <span class="label">11.6.1. </span><a class="xref" href="GuideOptionsMetadata.html#MetadataWritingProcess" title="Metadata writing process">Metadata writing process</a>
477 <span class="label">11.6.2. </span><a class="xref" href="GuideOptionsMetadata.html#WriteToImageFiles" title="Step 1: Write to image files">Step 1: Write to image files</a>
480 <span class="label">11.6.3. </span><a class="xref" href="GuideOptionsMetadata.html#WriteToGeeqiePrivateFiles" title="Steps 2 and 3: Write to Geeqie private files">Steps 2 and 3: Write to Geeqie private files</a>
483 <span class="label">11.6.4. </span><a class="xref" href="GuideOptionsMetadata.html#MetadataMiscellaneous" title="Miscellaneous">Miscellaneous</a>
486 <span class="label">11.6.5. </span><a class="xref" href="GuideOptionsMetadata.html#AutoSaveOptions" title="Auto-save options">Auto-save options</a>
489 <span class="label">11.6.6. </span><a class="xref" href="GuideOptionsMetadata.html#PreLoadMetadata" title="Pre-load metadata">Pre-load metadata</a>
492 <div class="division section">
493 <a name="MetadataWritingProcess"></a><div class="header"><h2 class="section title"><span class="title"><a name="titleMetadataWritingProcess"></a><span class="label">11.6.1. </span>Metadata writing process</span></h2></div>
494 <p class="para block block-first">
495 When writing metadata, Geeqie will follow three steps. This process will stop when the first successful write occurs.
496 <div class="block list orderedlist"><ol class="orderedlist">
497 <li class="li-first">
499 <span class="guilabel">Save metadata in image files, resp. sidecar files, according to the XMP standard</span>
500 <p class="para block"></p>
501 If checked, Geeqie will attempt to write metadata to the file itself, or to an associated XMP sidecar file
506 <span class="guilabel">Save metadata in '.metadata' folder, local to image folder (non-standard)</span>
507 <p class="para block"></p>
508 If checked, Geeqie will attempt to write to an xmp file in a local .metadata folder
513 <span class="guilabel">Save metadata in Geeqie private directory</span>
514 <p class="para block"></p>
515 If neither of the above are successful, Geeqie will write to an xmp file in the folder
516 <div dir="ltr" class=" block programlisting block-indent"><pre class="programlisting">$HOME/.local/share/geeqie/metadata</pre></div>
521 <p class="para block">When writing to local metadata folders, the directory structure duplicates that of the location of the source files.</p>
523 <div class="division section">
524 <a name="WriteToImageFiles"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.6.2. </span>Step 1: Write to image files</span></h2></div>
525 <p class="para block block-first">If Step 1 above was successful, the following options take effect:</p>
526 <div class="block list itemizedlist"><ul class="itemizedlist">
527 <li class="li-first">
529 <span class="guilabel">Store metadata also in legacy IPTC tags (converted according to IPTC4XMP standard)</span>
530 <p class="para block"></p>
531 If checked, Geeqie will write IPTC tags as defined in
532 <a class="link" href="GuideReferenceStandards.html" title="Standards">Standards</a>
537 <span class="guilabel">Warn if the image files are not writeable</span>
538 <p class="para block"></p>
539 If checked, open a warning dialogue if the file is not writeable
544 <span class="guilabel">Ask before writing to image files</span>
545 <p class="para block"></p>
546 If checked, open a confirmation dialogue before writing to the file
551 <span class="guilabel">Create sidecar files named image.ext.xmp (as opposed to image.xmp)</span>
552 <p class="para block"></p>
553 If checked, new sidecar files will use image.ext.xmp naming scheme
558 <div class="division section">
559 <a name="WriteToGeeqiePrivateFiles"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.6.3. </span>Steps 2 and 3: Write to Geeqie private files</span></h2></div>
560 <p class="para block block-first">If Step 2 or 3 above was successful, the following option takes effect:</p>
561 <div class="block list itemizedlist"><ul class="itemizedlist"><li class="li-first">
563 <span class="guilabel">Use GQview legacy metadata format (supports only keywords and comments) instead of XMP</span>
564 <p class="para block"></p>
565 If checked, Geeqie will write metadata in GQview legacy files (file extension .meta) format
569 <div class="division section">
570 <a name="MetadataMiscellaneous"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.6.4. </span>Miscellaneous</span></h2></div>
571 <div class="block list itemizedlist"><ul class="itemizedlist">
572 <li class="li-first">
573 <p class="para block block-first">
574 <span class="guilabel">Write the same description tags (keywords, comment, title) to all grouped sidecars</span>
575 <p class="para block"></p>
576 If checked the same descriptive tags are written to all files in a group. File grouping is as defined in the
577 <a class="link" href="GuideOptionsFiltering.html#Groupingsidecarextensions" title="Grouping sidecar extensions">Files tab</a>
578 of main Preferences. Technical tags (exif) are handled separately for each file.
582 <p class="para block block-first">
583 <span class="guilabel">Allow keywords to differ only in case</span>
584 <p class="para block"></p>
585 If checked, permits keywords to be case-sensitive (e.g.
586 <span class="emphasis">Place</span>
588 <span class="emphasis">place</span>
589 are two different keywords)
593 <p class="para block block-first">
594 <span class="guilabel">Write altered image orientation to the metadata</span>
595 <p class="para block"></p>
596 If checked, the results of orientation commands (Rotate, Mirror and Flip) issued on an image will be written to metadata either automatically as specified below or when manually initiated. This option also affects the
597 <a class="link" href="GuideMainWindowMenus.html#Editmenu" title="Edit menu">Auto rotate image using EXIF information</a>
600 <div class="admonition block warning block-indent"><div class="warning-inner">
601 <p class="para block block-first">If this option is not checked, the results of orientation commands will be lost when Geeqie closes.</p>
602 <p class="para block">Do not change this option while you have temporary rotations applied to images.</p>
606 <p class="para block"></p>
608 <div class="division section">
609 <a name="AutoSaveOptions"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.6.5. </span>Auto-save options</span></h2></div>
610 <div class="block list itemizedlist"><ul class="itemizedlist">
611 <li class="li-first">
613 <span class="guilabel">Write metadata after timeout</span>
614 <p class="para block"></p>
615 If checked, metadata writes will be made automatically at the defined interval. Warning dialogues will be issued if required.
620 <span class="guilabel">Write metadata on image change</span>
621 <p class="para block"></p>
622 If checked, metadata writes will be made when you move focus to another image.
627 <span class="guilabel">Write metadata on directory change</span>
628 <p class="para block"></p>
629 If checked, metadata writes will be made when you move focus to another folder.
633 <p class="para block"></p>
635 <div class="division section">
636 <a name="PreLoadMetadata"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">11.6.6. </span>Pre-load metadata</span></h2></div>
637 <div class="block list itemizedlist"><ul class="itemizedlist"><li class="li-first">
639 <span class="guilabel">Read metadata in background</span>
640 <p class="para block"></p>
641 Using the folder sorting options:
642 <p class="para block"></p>
643 <span class="guilabel">Exif date original</span>
644 <p class="para block"></p>
645 <span class="guilabel">Exif date digitized</span>
646 <p class="para block"></p>
647 <span class="guilabel">Rating</span>
648 <p class="para block"></p>
649 requires metadata to be read from all files in a folder before the sort action can be made. If a folder contains a large number of file, this can take a noticeable period of time.
650 <p class="para block"></p>
651 If this option is checked, Geeqie will automatically read the required metatada in the background as soon as a folder is opened. This will reduce the amount of time you have to wait until the sort is completed.
652 <p class="para block"></p>
653 If you do not use these sort otions, leave this option unchecked.
656 <p class="para block"></p>
659 <div class="navbar navbar-bottom"><table class="navbar"><tr>
660 <td class="navbar-prev"><a class="navbar-prev" href="GuideOptionsFiltering.html" title="Files Options">Files Options</a></td>
661 <td class="navbar-next"><a class="navbar-next" href="GuideOptionsKeywords.html" title="Keywords">Keywords</a></td>