Drop chapters numbers from h1 title, and reformat top title a bit.
[geeqie.git] / doc / image_search_finding_duplicates.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2
3 <html xmlns="http://www.w3.org/1999/xhtml">
4 <head>
5   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
6
7   <title>Finding Duplicates - Geeqie User Manual</title>
8   <meta name="CREATED" content="20040805;23590500" />
9   <meta name="CHANGED" content="20041227;15451200" />
10 <style type="text/css">
11 /*<![CDATA[*/
12  p.gq-finding-duplicates-8 {margin-bottom: 0in}
13  p.gq-finding-duplicates-7 {font-weight: bold; text-align: center}
14  p.gq-finding-duplicates-6 {margin-left: 1.58in}
15  p.gq-finding-duplicates-5 {margin-left: 0.79in}
16  div.gq-finding-duplicates-4 {text-align: center}
17  table.gq-finding-duplicates-3 {page-break-before: always}
18  p.gq-finding-duplicates-2 {text-align: right}
19  p.gq-finding-duplicates-1 {text-align: center}
20 /*]]>*/
21 </style>
22 </head>
23
24 <body lang="en-US" dir="ltr">
25   <div class="gq-finding-duplicates-4">
26     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-finding-duplicates-3">
27       <col width="85*" />
28       <col width="85*" />
29       <col width="85*" />
30
31       <thead>
32         <tr valign="top">
33           <td width="33%">
34             <p><a href="image_search_search.html">Previous</a>
35             </p>
36           </td>
37
38           <td width="33%">
39             <p class="gq-finding-duplicates-1">Finding Duplicates &ndash; Image Search</p>
40           </td>
41
42           <td width="33%">
43             <p class="gq-finding-duplicates-2"><a href="collections.html">Next</a>
44             </p>
45           </td>
46         </tr>
47       </thead>
48     </table>
49   </div>
50
51   <hr />
52
53   <h1>Finding Duplicates</h1>
54
55   <p>Geeqie provides a utility to find images that have similar attributes or content.</p>
56
57   <p>To display a new Find Duplicates Window press D or select Find duplicates from the File menu.</p>
58
59   <p><br />
60   <br />
61   </p>
62
63   <p><u>Adding files to be compared</u>
64   </p>
65
66   <p class="gq-finding-duplicates-5">Add files to be compared using drag and drop. Drop files or folders onto the Find Duplicates window to add them to the list of files to compare. When one or more folders are dropped onto the window a menu will appear allowing you to choose the desired action:</p>
67
68   <p class="gq-finding-duplicates-6"><b>Add contents:</b> The contents of dropped folders will added to the window.<br />
69   <b>Add contents recursive:</b> The contents of dropped folders and all sub folders will be added to the window.<br />
70   <b>Skip folders:</b> Ignore folders contained in the drop list.</p>
71
72   <p class="gq-finding-duplicates-5">When files are added to the window, the comparison is restarted to include the new files.</p>
73
74   <p><br />
75   <br />
76   </p>
77
78   <p><u>Comparison methods</u>
79   </p>
80
81   <p class="gq-finding-duplicates-5">The attribute to use for two images to match can be selected with the &#8220;Compare by:&#8221; drop down menu. Each method is explained below:</p>
82
83   <p class="gq-finding-duplicates-5"><b>Name:</b> The file name.</p>
84
85   <p class="gq-finding-duplicates-5"><b>Size:</b> The file size.</p>
86
87   <p class="gq-finding-duplicates-5"><b>Date:</b> The file date.</p>
88
89   <p class="gq-finding-duplicates-5"><b>Dimensions:</b> The image dimensions.</p>
90
91   <p class="gq-finding-duplicates-5"><b>Checksum:</b> The MD5 file checksum.</p>
92
93   <p class="gq-finding-duplicates-5"><b>Path:</b> The complete path to file.</p>
94
95   <p class="gq-finding-duplicates-5"><b>Similarity (high):</b> Very similar image content.</p>
96
97   <p class="gq-finding-duplicates-5"><b>Similarity:</b> Similar image content.</p>
98
99   <p class="gq-finding-duplicates-5"><b>Similarity (low):</b> Slightly similar image content.</p>
100
101   <p class="gq-finding-duplicates-5"><b>Similarity (custom):</b> Similar image content, the value to use to consider two images a match is configured in the <a href="options_advanced.html">Advanced tab</a> of the preferences dialog by setting the &#8220;Custom similarity threshold&#8221;.</p>
102
103   <p><br />
104   <br />
105   </p>
106
107   <p><u>Results list</u>
108   </p>
109
110   <p class="gq-finding-duplicates-5">Files that match with the selected comparison method will appear in the list. Matching files are grouped in alternating color.</p>
111
112   <p class="gq-finding-duplicates-5">The order of the result list can not be changed, files will appear in the order of the search. When comparing by image content similarity, the matching groups will be sorted by order of rank starting with the files that are most similar.</p>
113
114   <p class="gq-finding-duplicates-5">A <b>context menu</b> is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.</p>
115
116   <p class="gq-finding-duplicates-5"><b>Keyboard shortcuts</b> available in the results list:</p>
117
118   <div class="gq-finding-duplicates-4">
119     <table width="80%" border="1" cellpadding="2" cellspacing="0">
120       <col width="64*" />
121       <col width="64*" />
122       <col width="128*" />
123
124       <tr valign="top">
125         <td width="25%">
126           <p class="gq-finding-duplicates-7">Shortcut</p>
127         </td>
128
129         <td width="25%">
130           <p class="gq-finding-duplicates-7">Context menu name</p>
131         </td>
132
133         <td width="50%">
134           <p class="gq-finding-duplicates-7">Description</p>
135         </td>
136       </tr>
137
138       <tr valign="top">
139         <td width="25%">
140           <p class="gq-finding-duplicates-1">Enter</p>
141         </td>
142
143         <td width="25%">
144           <p class="gq-finding-duplicates-1">View</p>
145         </td>
146
147         <td width="50%">
148           <p class="gq-finding-duplicates-1">Opens selected image in main window.</p>
149         </td>
150       </tr>
151
152       <tr valign="top">
153         <td width="25%">
154           <p class="gq-finding-duplicates-1">V</p>
155         </td>
156
157         <td width="25%">
158           <p class="gq-finding-duplicates-1">View in new window</p>
159         </td>
160
161         <td width="50%">
162           <p class="gq-finding-duplicates-1">Opens selected image in a new window.</p>
163         </td>
164       </tr>
165
166       <tr valign="top">
167         <td width="25%">
168           <p class="gq-finding-duplicates-1">Control + A</p>
169         </td>
170
171         <td width="25%">
172           <p class="gq-finding-duplicates-1">Select all</p>
173         </td>
174
175         <td width="50%">
176           <p class="gq-finding-duplicates-1">Selects all images.</p>
177         </td>
178       </tr>
179
180       <tr valign="top">
181         <td width="25%">
182           <p class="gq-finding-duplicates-1">Control + Shift + A</p>
183         </td>
184
185         <td width="25%">
186           <p class="gq-finding-duplicates-1">Select none</p>
187         </td>
188
189         <td width="50%">
190           <p class="gq-finding-duplicates-1">Clear the image selection.</p>
191         </td>
192       </tr>
193
194       <tr>
195         <td width="25%" valign="bottom">
196           <p class="gq-finding-duplicates-1">1</p>
197         </td>
198
199         <td width="25%" valign="top">
200           <p class="gq-finding-duplicates-1">Select group 1 duplicates</p>
201         </td>
202
203         <td width="50%" valign="top">
204           <p class="gq-finding-duplicates-1">Selects the first image from each match group.</p>
205         </td>
206       </tr>
207
208       <tr>
209         <td width="25%" valign="bottom">
210           <p class="gq-finding-duplicates-1">2</p>
211         </td>
212
213         <td width="25%" valign="top">
214           <p class="gq-finding-duplicates-1">Select group 2 duplicates</p>
215         </td>
216
217         <td width="50%" valign="top">
218           <p class="gq-finding-duplicates-1">Selects all but the first image from each match group.</p>
219         </td>
220       </tr>
221
222       <tr valign="top">
223         <td width="25%">
224           <p class="gq-finding-duplicates-1">Control + 1 through<br />
225           Control + 0</p>
226         </td>
227
228         <td width="25%">
229           <p class="gq-finding-duplicates-1">Edit sub menu</p>
230         </td>
231
232         <td width="50%">
233           <p class="gq-finding-duplicates-1">Executes the respective editor command.</p>
234         </td>
235       </tr>
236
237       <tr valign="top">
238         <td width="25%">
239           <p class="gq-finding-duplicates-1">Control + P</p>
240         </td>
241
242         <td width="25%">
243           <p class="gq-finding-duplicates-1">Properties</p>
244         </td>
245
246         <td width="50%">
247           <p class="gq-finding-duplicates-1">Opens a properties window for selected images.</p>
248         </td>
249       </tr>
250
251       <tr valign="top">
252         <td width="25%">
253           <p class="gq-finding-duplicates-1">C</p>
254         </td>
255
256         <td width="25%">
257           <p class="gq-finding-duplicates-1">Add to new collection</p>
258         </td>
259
260         <td width="50%">
261           <p class="gq-finding-duplicates-1">Creates a new collection containing the selected images.</p>
262         </td>
263       </tr>
264
265       <tr valign="top">
266         <td width="25%">
267           <p class="gq-finding-duplicates-1"><br />
268           </p>
269         </td>
270
271         <td width="25%">
272           <p class="gq-finding-duplicates-1">Print</p>
273         </td>
274
275         <td width="50%">
276           <p class="gq-finding-duplicates-1">Opens a print dialog for selected images.</p>
277         </td>
278       </tr>
279
280       <tr valign="top">
281         <td width="25%">
282           <p class="gq-finding-duplicates-1">Control + C</p>
283         </td>
284
285         <td width="25%">
286           <p class="gq-finding-duplicates-1">Copy</p>
287         </td>
288
289         <td width="50%">
290           <p class="gq-finding-duplicates-1">Copy selected images.</p>
291         </td>
292       </tr>
293
294       <tr valign="top">
295         <td width="25%">
296           <p class="gq-finding-duplicates-1">Control + M</p>
297         </td>
298
299         <td width="25%">
300           <p class="gq-finding-duplicates-1">Move</p>
301         </td>
302
303         <td width="50%">
304           <p class="gq-finding-duplicates-1">Move selected images.</p>
305         </td>
306       </tr>
307
308       <tr valign="top">
309         <td width="25%">
310           <p class="gq-finding-duplicates-1">Control + R</p>
311         </td>
312
313         <td width="25%">
314           <p class="gq-finding-duplicates-1">Rename</p>
315         </td>
316
317         <td width="50%">
318           <p class="gq-finding-duplicates-1">Rename selected images.</p>
319         </td>
320       </tr>
321
322       <tr valign="top">
323         <td width="25%">
324           <p class="gq-finding-duplicates-1">Control + D</p>
325         </td>
326
327         <td width="25%">
328           <p class="gq-finding-duplicates-1">Delete</p>
329         </td>
330
331         <td width="50%">
332           <p class="gq-finding-duplicates-1">Delete selected images.</p>
333         </td>
334       </tr>
335
336       <tr valign="top">
337         <td width="25%">
338           <p class="gq-finding-duplicates-1">Delete</p>
339         </td>
340
341         <td width="25%">
342           <p class="gq-finding-duplicates-1">Remove</p>
343         </td>
344
345         <td width="50%">
346           <p class="gq-finding-duplicates-1">Remove selected images from result list.</p>
347         </td>
348       </tr>
349
350       <tr valign="top">
351         <td width="25%">
352           <p class="gq-finding-duplicates-1">Control + Delete</p>
353         </td>
354
355         <td width="25%">
356           <p class="gq-finding-duplicates-1">Clear</p>
357         </td>
358
359         <td width="50%">
360           <p class="gq-finding-duplicates-1">Cleared the result list.</p>
361         </td>
362       </tr>
363
364       <tr valign="top">
365         <td width="25%">
366           <p class="gq-finding-duplicates-1">Menu</p>
367         </td>
368
369         <td width="25%">
370           <p class="gq-finding-duplicates-1"><br />
371           </p>
372         </td>
373
374         <td width="50%">
375           <p class="gq-finding-duplicates-1">Displays the context menu.</p>
376         </td>
377       </tr>
378
379       <tr valign="top">
380         <td width="25%">
381           <p class="gq-finding-duplicates-1">Control + T</p>
382         </td>
383
384         <td width="25%">
385           <p class="gq-finding-duplicates-1"><br />
386           </p>
387         </td>
388
389         <td width="50%">
390           <p class="gq-finding-duplicates-1">Toggle display of thumbnails.</p>
391         </td>
392       </tr>
393
394       <tr valign="top">
395         <td width="25%">
396           <p class="gq-finding-duplicates-1">Control + W</p>
397         </td>
398
399         <td width="25%">
400           <p class="gq-finding-duplicates-1"><br />
401           </p>
402         </td>
403
404         <td width="50%">
405           <p class="gq-finding-duplicates-1">Close window.</p>
406         </td>
407       </tr>
408     </table>
409   </div>
410
411   <p class="gq-finding-duplicates-5"><br />
412   <br />
413   </p>
414
415   <p class="gq-finding-duplicates-5">The <b>selection</b> can be changed using the keyboard and mouse the same as in a <a href="main_window_file_pane.html">file pane</a> of the main window.</p>
416
417   <p class="gq-finding-duplicates-5">The image Dimensions column of the result list will only contain dimension information when comparing by dimensions, or when the data is easily available from memory or has been read from the cache.</p>
418
419   <p><br />
420   <br />
421   </p>
422
423   <p><u>Status bar</u>
424   </p>
425
426   <p class="gq-finding-duplicates-5">Along the bottom of the Find Duplicates window is an area that displays the count of files contained in the window, and the number of files in the result list.</p>
427
428   <p class="gq-finding-duplicates-5">The status bar will also display the status of an active compare operation using the progress bar. A compare operation involves 2 or 3 stages, depending on the type of comparison. These are the stages in order:</p>
429
430   <p class="gq-finding-duplicates-6">1) If necessary, extra data is read into memory for the comparison stage, the progress bar will indicate this stage with text that resembles &#8220;reading dimensions...&#8221;, &#8220;reading checksums...&#8221;, or &#8220;reading similarity data...&#8221;.<br />
431   2) The images are compared using the selected method, the progress bar will indicate this stage with the text &#8220;comparing...&#8221;.<br />
432   3) The results are sorted for display, the progress bar will indicate this stage with the text &#8220;sorting...&#8221;.</p>
433
434   <p class="gq-finding-duplicates-5">Stage 1 is only used for the Dimensions, Checksum, and Similarity compare methods.</p>
435
436   <p class="gq-finding-duplicates-5">If the time to complete a stage will be significant, an estimated time to completion will also be displayed in the progress bar. The estimated time only refers to the current stage, other stages are not included in the estimate. The time estimate is displayed using the format MINUTES:SECONDS.</p>
437
438   <p><br />
439   <br />
440   </p>
441
442   <p><u>Thumbnails</u>
443   </p>
444
445   <p class="gq-finding-duplicates-5">Thumbnails can be displayed beside each image in the result list by enabling the Thumbnails check box.</p>
446
447   <p><br />
448   <br />
449   </p>
450
451   <p><u>Compare two file sets</u>
452   </p>
453
454   <p class="gq-finding-duplicates-5">Sometimes it is useful to compare one group of files to another, different group of files. Enable this check box to compare two groups of files. When enabled a second list will appear, files can be added to this list using the same methods for the main list.</p>
455
456   <p class="gq-finding-duplicates-5">When comparing two file sets the results list will display matches between the two lists. For each match group, the first file is always from the main group, and the remaining files are always from the second group.</p>
457
458   <p><br />
459   <br />
460   </p>
461
462   <p><u>Drag and Drop</u>
463   </p>
464
465   <p class="gq-finding-duplicates-5">Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</p>
466
467   <p><br />
468   <br />
469   </p>
470
471   <p><br />
472   <br />
473   </p>
474
475   <hr />
476
477   <div class="gq-finding-duplicates-4">
478     <table width="100%" border="0" cellpadding="4" cellspacing="0">
479       <col width="85*" />
480       <col width="85*" />
481       <col width="85*" />
482
483       <thead>
484         <tr valign="top">
485           <td width="33%">
486             <p><a href="image_search_search.html">Previous</a>
487             </p>
488           </td>
489
490           <td width="33%">
491             <p class="gq-finding-duplicates-1"><a href="index.html">Contents</a>
492             </p>
493           </td>
494
495           <td width="33%">
496             <p class="gq-finding-duplicates-2"><a href="collections.html">Next</a>
497             </p>
498           </td>
499         </tr>
500       </thead>
501
502       <tbody>
503         <tr valign="top">
504           <td width="33%">
505             <p><br />
506             </p>
507           </td>
508
509           <td width="33%">
510             <p class="gq-finding-duplicates-1"><br />
511             </p>
512           </td>
513
514           <td width="33%">
515             <p class="gq-finding-duplicates-2">Geeqie User Manual</p>
516           </td>
517         </tr>
518       </tbody>
519     </table>
520   </div>
521
522   <p class="gq-finding-duplicates-8"><br />
523   </p>
524 </body>
525 </html>