Add style.css to list of files to install.
[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   <link rel="stylesheet" type="text/css" href="style.css" />
9 </head>
10
11 <body lang="en-US" dir="ltr">
12   <div class="gq-finding-duplicates-4">
13     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-finding-duplicates-3">
14
15       <thead>
16         <tr valign="top">
17           <td width="33%">
18             <p class="previous"><a href="image_search_search.html">Previous</a>
19             </p>
20           </td>
21
22           <td width="33%">
23             <p class="gq-finding-duplicates-1">Finding Duplicates &ndash; Image Search</p>
24           </td>
25
26           <td width="33%">
27             <p class="gq-finding-duplicates-2"><a href="collections.html">Next</a>
28             </p>
29           </td>
30         </tr>
31       </thead>
32     </table>
33   </div>
34
35   <hr />
36
37   <h1>Finding Duplicates</h1>
38
39   <p>Geeqie provides a utility to find images that have similar attributes or content.</p>
40
41   <p>To display a new Find Duplicates Window press D or select Find duplicates from the File menu.</p>
42
43   <p><br />
44   <br />
45   </p>
46
47   <h2>Adding files to be compared</h2>
48
49   <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>
50
51   <p class="gq-finding-duplicates-6"><b>Add contents:</b> The contents of dropped folders will added to the window.<br />
52   <b>Add contents recursive:</b> The contents of dropped folders and all sub folders will be added to the window.<br />
53   <b>Skip folders:</b> Ignore folders contained in the drop list.</p>
54
55   <p class="gq-finding-duplicates-5">When files are added to the window, the comparison is restarted to include the new files.</p>
56
57   <p><br />
58   <br />
59   </p>
60
61   <h2>Comparison methods</h2>
62
63   <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>
64
65   <p class="gq-finding-duplicates-5"><b>Name:</b> The file name.</p>
66
67   <p class="gq-finding-duplicates-5"><b>Size:</b> The file size.</p>
68
69   <p class="gq-finding-duplicates-5"><b>Date:</b> The file date.</p>
70
71   <p class="gq-finding-duplicates-5"><b>Dimensions:</b> The image dimensions.</p>
72
73   <p class="gq-finding-duplicates-5"><b>Checksum:</b> The MD5 file checksum.</p>
74
75   <p class="gq-finding-duplicates-5"><b>Path:</b> The complete path to file.</p>
76
77   <p class="gq-finding-duplicates-5"><b>Similarity (high):</b> Very similar image content.</p>
78
79   <p class="gq-finding-duplicates-5"><b>Similarity:</b> Similar image content.</p>
80
81   <p class="gq-finding-duplicates-5"><b>Similarity (low):</b> Slightly similar image content.</p>
82
83   <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>
84
85   <p><br />
86   <br />
87   </p>
88
89   <h2>Results list</h2>
90
91   <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>
92
93   <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>
94
95   <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>
96
97   <p class="gq-finding-duplicates-5"><b>Keyboard shortcuts</b> available in the results list:</p>
98
99   <div class="gq-finding-duplicates-4">
100     <table width="80%" border="1" cellpadding="2" cellspacing="0">
101
102       <tr valign="top">
103         <td width="25%">
104           <p class="gq-finding-duplicates-7">Shortcut</p>
105         </td>
106
107         <td width="25%">
108           <p class="gq-finding-duplicates-7">Context menu name</p>
109         </td>
110
111         <td width="50%">
112           <p class="gq-finding-duplicates-7">Description</p>
113         </td>
114       </tr>
115
116       <tr valign="top">
117         <td width="25%">
118           <p class="gq-finding-duplicates-1">Enter</p>
119         </td>
120
121         <td width="25%">
122           <p class="gq-finding-duplicates-1">View</p>
123         </td>
124
125         <td width="50%">
126           <p class="gq-finding-duplicates-1">Opens selected image in main window.</p>
127         </td>
128       </tr>
129
130       <tr valign="top">
131         <td width="25%">
132           <p class="gq-finding-duplicates-1">V</p>
133         </td>
134
135         <td width="25%">
136           <p class="gq-finding-duplicates-1">View in new window</p>
137         </td>
138
139         <td width="50%">
140           <p class="gq-finding-duplicates-1">Opens selected image in a new window.</p>
141         </td>
142       </tr>
143
144       <tr valign="top">
145         <td width="25%">
146           <p class="gq-finding-duplicates-1">Control + A</p>
147         </td>
148
149         <td width="25%">
150           <p class="gq-finding-duplicates-1">Select all</p>
151         </td>
152
153         <td width="50%">
154           <p class="gq-finding-duplicates-1">Selects all images.</p>
155         </td>
156       </tr>
157
158       <tr valign="top">
159         <td width="25%">
160           <p class="gq-finding-duplicates-1">Control + Shift + A</p>
161         </td>
162
163         <td width="25%">
164           <p class="gq-finding-duplicates-1">Select none</p>
165         </td>
166
167         <td width="50%">
168           <p class="gq-finding-duplicates-1">Clear the image selection.</p>
169         </td>
170       </tr>
171
172       <tr>
173         <td width="25%" valign="bottom">
174           <p class="gq-finding-duplicates-1">1</p>
175         </td>
176
177         <td width="25%" valign="top">
178           <p class="gq-finding-duplicates-1">Select group 1 duplicates</p>
179         </td>
180
181         <td width="50%" valign="top">
182           <p class="gq-finding-duplicates-1">Selects the first image from each match group.</p>
183         </td>
184       </tr>
185
186       <tr>
187         <td width="25%" valign="bottom">
188           <p class="gq-finding-duplicates-1">2</p>
189         </td>
190
191         <td width="25%" valign="top">
192           <p class="gq-finding-duplicates-1">Select group 2 duplicates</p>
193         </td>
194
195         <td width="50%" valign="top">
196           <p class="gq-finding-duplicates-1">Selects all but the first image from each match group.</p>
197         </td>
198       </tr>
199
200       <tr valign="top">
201         <td width="25%">
202           <p class="gq-finding-duplicates-1">Control + 1 through<br />
203           Control + 0</p>
204         </td>
205
206         <td width="25%">
207           <p class="gq-finding-duplicates-1">Edit sub menu</p>
208         </td>
209
210         <td width="50%">
211           <p class="gq-finding-duplicates-1">Executes the respective editor command.</p>
212         </td>
213       </tr>
214
215       <tr valign="top">
216         <td width="25%">
217           <p class="gq-finding-duplicates-1">Control + P</p>
218         </td>
219
220         <td width="25%">
221           <p class="gq-finding-duplicates-1">Properties</p>
222         </td>
223
224         <td width="50%">
225           <p class="gq-finding-duplicates-1">Opens a properties window for selected images.</p>
226         </td>
227       </tr>
228
229       <tr valign="top">
230         <td width="25%">
231           <p class="gq-finding-duplicates-1">C</p>
232         </td>
233
234         <td width="25%">
235           <p class="gq-finding-duplicates-1">Add to new collection</p>
236         </td>
237
238         <td width="50%">
239           <p class="gq-finding-duplicates-1">Creates a new collection containing the selected images.</p>
240         </td>
241       </tr>
242
243       <tr valign="top">
244         <td width="25%">
245           <p class="gq-finding-duplicates-1"><br />
246           </p>
247         </td>
248
249         <td width="25%">
250           <p class="gq-finding-duplicates-1">Print</p>
251         </td>
252
253         <td width="50%">
254           <p class="gq-finding-duplicates-1">Opens a print dialog for selected images.</p>
255         </td>
256       </tr>
257
258       <tr valign="top">
259         <td width="25%">
260           <p class="gq-finding-duplicates-1">Control + C</p>
261         </td>
262
263         <td width="25%">
264           <p class="gq-finding-duplicates-1">Copy</p>
265         </td>
266
267         <td width="50%">
268           <p class="gq-finding-duplicates-1">Copy selected images.</p>
269         </td>
270       </tr>
271
272       <tr valign="top">
273         <td width="25%">
274           <p class="gq-finding-duplicates-1">Control + M</p>
275         </td>
276
277         <td width="25%">
278           <p class="gq-finding-duplicates-1">Move</p>
279         </td>
280
281         <td width="50%">
282           <p class="gq-finding-duplicates-1">Move selected images.</p>
283         </td>
284       </tr>
285
286       <tr valign="top">
287         <td width="25%">
288           <p class="gq-finding-duplicates-1">Control + R</p>
289         </td>
290
291         <td width="25%">
292           <p class="gq-finding-duplicates-1">Rename</p>
293         </td>
294
295         <td width="50%">
296           <p class="gq-finding-duplicates-1">Rename selected images.</p>
297         </td>
298       </tr>
299
300       <tr valign="top">
301         <td width="25%">
302           <p class="gq-finding-duplicates-1">Control + D</p>
303         </td>
304
305         <td width="25%">
306           <p class="gq-finding-duplicates-1">Delete</p>
307         </td>
308
309         <td width="50%">
310           <p class="gq-finding-duplicates-1">Delete selected images.</p>
311         </td>
312       </tr>
313
314       <tr valign="top">
315         <td width="25%">
316           <p class="gq-finding-duplicates-1">Delete</p>
317         </td>
318
319         <td width="25%">
320           <p class="gq-finding-duplicates-1">Remove</p>
321         </td>
322
323         <td width="50%">
324           <p class="gq-finding-duplicates-1">Remove selected images from result list.</p>
325         </td>
326       </tr>
327
328       <tr valign="top">
329         <td width="25%">
330           <p class="gq-finding-duplicates-1">Control + Delete</p>
331         </td>
332
333         <td width="25%">
334           <p class="gq-finding-duplicates-1">Clear</p>
335         </td>
336
337         <td width="50%">
338           <p class="gq-finding-duplicates-1">Cleared the result list.</p>
339         </td>
340       </tr>
341
342       <tr valign="top">
343         <td width="25%">
344           <p class="gq-finding-duplicates-1">Menu</p>
345         </td>
346
347         <td width="25%">
348           <p class="gq-finding-duplicates-1"><br />
349           </p>
350         </td>
351
352         <td width="50%">
353           <p class="gq-finding-duplicates-1">Displays the context menu.</p>
354         </td>
355       </tr>
356
357       <tr valign="top">
358         <td width="25%">
359           <p class="gq-finding-duplicates-1">Control + T</p>
360         </td>
361
362         <td width="25%">
363           <p class="gq-finding-duplicates-1"><br />
364           </p>
365         </td>
366
367         <td width="50%">
368           <p class="gq-finding-duplicates-1">Toggle display of thumbnails.</p>
369         </td>
370       </tr>
371
372       <tr valign="top">
373         <td width="25%">
374           <p class="gq-finding-duplicates-1">Control + W</p>
375         </td>
376
377         <td width="25%">
378           <p class="gq-finding-duplicates-1"><br />
379           </p>
380         </td>
381
382         <td width="50%">
383           <p class="gq-finding-duplicates-1">Close window.</p>
384         </td>
385       </tr>
386     </table>
387   </div>
388
389   <p class="gq-finding-duplicates-5"><br />
390   <br />
391   </p>
392
393   <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>
394
395   <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>
396
397   <p><br />
398   <br />
399   </p>
400
401   <h2>Status bar</h2>
402
403   <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>
404
405   <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>
406
407   <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 />
408   2) The images are compared using the selected method, the progress bar will indicate this stage with the text &#8220;comparing...&#8221;.<br />
409   3) The results are sorted for display, the progress bar will indicate this stage with the text &#8220;sorting...&#8221;.</p>
410
411   <p class="gq-finding-duplicates-5">Stage 1 is only used for the Dimensions, Checksum, and Similarity compare methods.</p>
412
413   <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>
414
415   <p><br />
416   <br />
417   </p>
418
419   <h2>Thumbnails</h2>
420
421   <p class="gq-finding-duplicates-5">Thumbnails can be displayed beside each image in the result list by enabling the Thumbnails check box.</p>
422
423   <p><br />
424   <br />
425   </p>
426
427   <h2>Compare two file sets</h2>
428
429   <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>
430
431   <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>
432
433   <p><br />
434   <br />
435   </p>
436
437   <h2>Drag and Drop</h2>
438
439   <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>
440
441   <p><br />
442   <br />
443   </p>
444
445   <p><br />
446   <br />
447   </p>
448
449   <hr />
450
451   <div class="gq-finding-duplicates-4">
452     <table width="100%" border="0" cellpadding="4" cellspacing="0">
453
454       <thead>
455         <tr valign="top">
456           <td width="33%">
457             <p class="previous"><a href="image_search_search.html">Previous</a>
458             </p>
459           </td>
460
461           <td width="33%">
462             <p class="gq-finding-duplicates-1"><a href="index.html">Contents</a>
463             </p>
464           </td>
465
466           <td width="33%">
467             <p class="gq-finding-duplicates-2"><a href="collections.html">Next</a>
468             </p>
469           </td>
470         </tr>
471       </thead>
472
473       <tbody>
474         <tr valign="top">
475           <td width="33%">
476             <p><br />
477             </p>
478           </td>
479
480           <td width="33%">
481             <p class="gq-finding-duplicates-1"><br />
482             </p>
483           </td>
484
485           <td width="33%">
486             <p class="gq-finding-duplicates-2">Geeqie User Manual</p>
487           </td>
488         </tr>
489       </tbody>
490     </table>
491   </div>
492
493   <p class="gq-finding-duplicates-8"><br />
494   </p>
495 </body>
496 </html>