Sync to GQview 1.5.9 release.
[geeqie.git] / doc / 5_2_finding_duplicates.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3 <HEAD>
4         <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
5         <TITLE>Finding Duplicates - GQview User Manual</TITLE>
6         <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.0  (Linux)">
7         <META NAME="CREATED" CONTENT="20040805;23590500">
8         <META NAME="CHANGED" CONTENT="20041227;15451200">
9 </HEAD>
10 <BODY LANG="en-US" DIR="LTR">
11 <CENTER>
12         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
13                 <COL WIDTH=85*>
14                 <COL WIDTH=85*>
15                 <COL WIDTH=85*>
16                 <THEAD>
17                         <TR VALIGN=TOP>
18                                 <TD WIDTH=33%>
19                                         <P><A HREF="5_1_search.html">Previous</A></P>
20                                 </TD>
21                                 <TD WIDTH=33%>
22                                         <P ALIGN=CENTER>Finding Duplicates - Image Search</P>
23                                 </TD>
24                                 <TD WIDTH=33%>
25                                         <P ALIGN=RIGHT><A HREF="6_collections.html">Next</A></P>
26                                 </TD>
27                         </TR>
28                 </THEAD>
29         </TABLE>
30 </CENTER>
31 <HR>
32 <H1>5.2 Finding Duplicates</H1>
33 <P>GQview provides a utility to find images that have similar
34 attributes or content.</P>
35 <P>To display a new Find Duplicates Window press D or select Find
36 duplicates from the File menu.</P>
37 <P><BR><BR>
38 </P>
39 <P><U>Adding files to be compared</U></P>
40 <P STYLE="margin-left: 0.79in">Add files to be compared using drag
41 and drop. Drop files or folders onto the Find Duplicates window to
42 add them to the list of files to compare. When one or more folders
43 are dropped onto the window a menu will appear allowing you to choose
44 the desired action:</P>
45 <P STYLE="margin-left: 1.58in"><B>Add contents:</B> The contents of
46 dropped folders will added to the window. <BR><B>Add contents
47 recursive:</B> The contents of dropped folders and all sub folders
48 will be added to the window.<BR><B>Skip folders:</B> Ignore folders
49 contained in the drop list.</P>
50 <P STYLE="margin-left: 0.79in">When files are added to the window,
51 the comparison is restarted to include the new files.</P>
52 <P><BR><BR>
53 </P>
54 <P><U>Comparison methods</U></P>
55 <P STYLE="margin-left: 0.79in">The attribute to use for two images to
56 match can be selected with the &ldquo;Compare by:&rdquo; drop down
57 menu. Each method is explained below:</P>
58 <P STYLE="margin-left: 0.79in"><B>Name:</B> The file name.</P>
59 <P STYLE="margin-left: 0.79in"><B>Size:</B> The file size.</P>
60 <P STYLE="margin-left: 0.79in"><B>Date:</B> The file date.</P>
61 <P STYLE="margin-left: 0.79in"><B>Dimensions:</B> The image
62 dimensions.</P>
63 <P STYLE="margin-left: 0.79in"><B>Checksum:</B> The MD5 file
64 checksum.</P>
65 <P STYLE="margin-left: 0.79in"><B>Path:</B> The complete path to
66 file.</P>
67 <P STYLE="margin-left: 0.79in"><B>Similarity (high):</B> Very similar
68 image content.</P>
69 <P STYLE="margin-left: 0.79in"><B>Similarity:</B> Similar image
70 content.</P>
71 <P STYLE="margin-left: 0.79in"><B>Similarity (low):</B> Slightly
72 similar image content.</P>
73 <P STYLE="margin-left: 0.79in"><B>Similarity (custom):</B> Similar
74 image content, the value to use to consider two images a match is
75 configured in the <A HREF="10_6_advanced.html">Advanced tab</A> of
76 the preferences dialog by setting the &ldquo;Custom similarity
77 threshold&rdquo;.</P>
78 <P><BR><BR>
79 </P>
80 <P><U>Results list</U></P>
81 <P STYLE="margin-left: 0.79in">Files that match with the selected
82 comparison method will appear in the list. Matching files are grouped
83 in alternating color.</P>
84 <P STYLE="margin-left: 0.79in">The order of the result list can not
85 be changed, files will appear in the order of the search. When
86 comparing by image content similarity, the matching groups will be
87 sorted by order of rank starting with the files that are most
88 similar.</P>
89 <P STYLE="margin-left: 0.79in">A <B>context menu</B> is available for
90 the result list by right clicking the mouse or pressing the Menu key
91 when a row has the focus.</P>
92 <P STYLE="margin-left: 0.79in"><B>Keyboard shortcuts</B> available in
93 the results list:</P>
94 <CENTER>
95         <TABLE WIDTH=80% BORDER=1 BORDERCOLOR="#cccccc" CELLPADDING=2 CELLSPACING=0>
96                 <COL WIDTH=64*>
97                 <COL WIDTH=64*>
98                 <COL WIDTH=128*>
99                 <TR VALIGN=TOP>
100                         <TD WIDTH=25%>
101                                 <P ALIGN=CENTER><B>Shortcut</B></P>
102                         </TD>
103                         <TD WIDTH=25%>
104                                 <P ALIGN=CENTER><B>Context menu name</B></P>
105                         </TD>
106                         <TD WIDTH=50%>
107                                 <P ALIGN=CENTER><B>Description</B></P>
108                         </TD>
109                 </TR>
110                 <TR VALIGN=TOP>
111                         <TD WIDTH=25%>
112                                 <P ALIGN=CENTER>Enter</P>
113                         </TD>
114                         <TD WIDTH=25%>
115                                 <P ALIGN=CENTER>View</P>
116                         </TD>
117                         <TD WIDTH=50%>
118                                 <P ALIGN=CENTER>Opens selected image in main window.</P>
119                         </TD>
120                 </TR>
121                 <TR VALIGN=TOP>
122                         <TD WIDTH=25%>
123                                 <P ALIGN=CENTER>V</P>
124                         </TD>
125                         <TD WIDTH=25%>
126                                 <P ALIGN=CENTER>View in new window</P>
127                         </TD>
128                         <TD WIDTH=50%>
129                                 <P ALIGN=CENTER>Opens selected image in a new window.</P>
130                         </TD>
131                 </TR>
132                 <TR VALIGN=TOP>
133                         <TD WIDTH=25%>
134                                 <P ALIGN=CENTER>Control + A</P>
135                         </TD>
136                         <TD WIDTH=25%>
137                                 <P ALIGN=CENTER>Select all</P>
138                         </TD>
139                         <TD WIDTH=50%>
140                                 <P ALIGN=CENTER>Selects all images.</P>
141                         </TD>
142                 </TR>
143                 <TR VALIGN=TOP>
144                         <TD WIDTH=25%>
145                                 <P ALIGN=CENTER>Control + Shift + A</P>
146                         </TD>
147                         <TD WIDTH=25%>
148                                 <P ALIGN=CENTER>Select none</P>
149                         </TD>
150                         <TD WIDTH=50%>
151                                 <P ALIGN=CENTER>Clear the image selection.</P>
152                         </TD>
153                 </TR>
154                 <TR>
155                         <TD WIDTH=25% VALIGN=BOTTOM SDVAL="1" SDNUM="1033;">
156                                 <P ALIGN=CENTER>1</P>
157                         </TD>
158                         <TD WIDTH=25% VALIGN=TOP>
159                                 <P ALIGN=CENTER>Select group 1 duplicates</P>
160                         </TD>
161                         <TD WIDTH=50% VALIGN=TOP>
162                                 <P ALIGN=CENTER>Selects the first image from each match group.</P>
163                         </TD>
164                 </TR>
165                 <TR>
166                         <TD WIDTH=25% VALIGN=BOTTOM SDVAL="2" SDNUM="1033;">
167                                 <P ALIGN=CENTER>2</P>
168                         </TD>
169                         <TD WIDTH=25% VALIGN=TOP>
170                                 <P ALIGN=CENTER>Select group 2 duplicates</P>
171                         </TD>
172                         <TD WIDTH=50% VALIGN=TOP>
173                                 <P ALIGN=CENTER>Selects all but the first image from each match
174                                 group.</P>
175                         </TD>
176                 </TR>
177                 <TR VALIGN=TOP>
178                         <TD WIDTH=25%>
179                                 <P ALIGN=CENTER>Control + 1 through<BR>Control + 0</P>
180                         </TD>
181                         <TD WIDTH=25%>
182                                 <P ALIGN=CENTER>Edit sub menu</P>
183                         </TD>
184                         <TD WIDTH=50%>
185                                 <P ALIGN=CENTER>Executes the respective editor command.</P>
186                         </TD>
187                 </TR>
188                 <TR VALIGN=TOP>
189                         <TD WIDTH=25%>
190                                 <P ALIGN=CENTER>Control + P</P>
191                         </TD>
192                         <TD WIDTH=25%>
193                                 <P ALIGN=CENTER>Properties</P>
194                         </TD>
195                         <TD WIDTH=50%>
196                                 <P ALIGN=CENTER>Opens a properties window for selected images.</P>
197                         </TD>
198                 </TR>
199                 <TR VALIGN=TOP>
200                         <TD WIDTH=25%>
201                                 <P ALIGN=CENTER>C</P>
202                         </TD>
203                         <TD WIDTH=25%>
204                                 <P ALIGN=CENTER>Add to new collection</P>
205                         </TD>
206                         <TD WIDTH=50%>
207                                 <P ALIGN=CENTER>Creates a new collection containing the selected
208                                 images.</P>
209                         </TD>
210                 </TR>
211                 <TR VALIGN=TOP>
212                         <TD WIDTH=25%>
213                                 <P ALIGN=CENTER><BR>
214                                 </P>
215                         </TD>
216                         <TD WIDTH=25%>
217                                 <P ALIGN=CENTER>Print</P>
218                         </TD>
219                         <TD WIDTH=50%>
220                                 <P ALIGN=CENTER>Opens a print dialog for selected images.</P>
221                         </TD>
222                 </TR>
223                 <TR VALIGN=TOP>
224                         <TD WIDTH=25%>
225                                 <P ALIGN=CENTER>Control + C</P>
226                         </TD>
227                         <TD WIDTH=25%>
228                                 <P ALIGN=CENTER>Copy</P>
229                         </TD>
230                         <TD WIDTH=50%>
231                                 <P ALIGN=CENTER>Copy selected images.</P>
232                         </TD>
233                 </TR>
234                 <TR VALIGN=TOP>
235                         <TD WIDTH=25%>
236                                 <P ALIGN=CENTER>Control + M</P>
237                         </TD>
238                         <TD WIDTH=25%>
239                                 <P ALIGN=CENTER>Move</P>
240                         </TD>
241                         <TD WIDTH=50%>
242                                 <P ALIGN=CENTER>Move selected images.</P>
243                         </TD>
244                 </TR>
245                 <TR VALIGN=TOP>
246                         <TD WIDTH=25%>
247                                 <P ALIGN=CENTER>Control + R</P>
248                         </TD>
249                         <TD WIDTH=25%>
250                                 <P ALIGN=CENTER>Rename</P>
251                         </TD>
252                         <TD WIDTH=50%>
253                                 <P ALIGN=CENTER>Rename selected images.</P>
254                         </TD>
255                 </TR>
256                 <TR VALIGN=TOP>
257                         <TD WIDTH=25%>
258                                 <P ALIGN=CENTER>Control + D</P>
259                         </TD>
260                         <TD WIDTH=25%>
261                                 <P ALIGN=CENTER>Delete</P>
262                         </TD>
263                         <TD WIDTH=50%>
264                                 <P ALIGN=CENTER>Delete selected images.</P>
265                         </TD>
266                 </TR>
267                 <TR VALIGN=TOP>
268                         <TD WIDTH=25%>
269                                 <P ALIGN=CENTER>Delete</P>
270                         </TD>
271                         <TD WIDTH=25%>
272                                 <P ALIGN=CENTER>Remove</P>
273                         </TD>
274                         <TD WIDTH=50%>
275                                 <P ALIGN=CENTER>Remove selected images from result list.</P>
276                         </TD>
277                 </TR>
278                 <TR VALIGN=TOP>
279                         <TD WIDTH=25%>
280                                 <P ALIGN=CENTER>Control + Delete</P>
281                         </TD>
282                         <TD WIDTH=25%>
283                                 <P ALIGN=CENTER>Clear</P>
284                         </TD>
285                         <TD WIDTH=50%>
286                                 <P ALIGN=CENTER>Cleared the result list.</P>
287                         </TD>
288                 </TR>
289                 <TR VALIGN=TOP>
290                         <TD WIDTH=25%>
291                                 <P ALIGN=CENTER>Menu</P>
292                         </TD>
293                         <TD WIDTH=25%>
294                                 <P ALIGN=CENTER><BR>
295                                 </P>
296                         </TD>
297                         <TD WIDTH=50%>
298                                 <P ALIGN=CENTER>Displays the context menu.</P>
299                         </TD>
300                 </TR>
301                 <TR VALIGN=TOP>
302                         <TD WIDTH=25%>
303                                 <P ALIGN=CENTER>Control + T</P>
304                         </TD>
305                         <TD WIDTH=25%>
306                                 <P ALIGN=CENTER><BR>
307                                 </P>
308                         </TD>
309                         <TD WIDTH=50%>
310                                 <P ALIGN=CENTER>Toggle display of thumbnails.</P>
311                         </TD>
312                 </TR>
313                 <TR VALIGN=TOP>
314                         <TD WIDTH=25%>
315                                 <P ALIGN=CENTER>Control + W</P>
316                         </TD>
317                         <TD WIDTH=25%>
318                                 <P ALIGN=CENTER><BR>
319                                 </P>
320                         </TD>
321                         <TD WIDTH=50%>
322                                 <P ALIGN=CENTER>Close window.</P>
323                         </TD>
324                 </TR>
325         </TABLE>
326 </CENTER>
327 <P STYLE="margin-left: 0.79in"><BR><BR>
328 </P>
329 <P STYLE="margin-left: 0.79in">The <B>selection</B> can be changed
330 using the keyboard and mouse the same as in a <A HREF="2_4_file_pane.html">file
331 pane</A> of the main window.</P>
332 <P STYLE="margin-left: 0.79in">The image Dimensions column of the
333 result list will only contain dimension information when comparing by
334 dimensions, or when the data is easily available from memory or has
335 been read from the cache.</P>
336 <P><BR><BR>
337 </P>
338 <P><U>Status bar</U></P>
339 <P STYLE="margin-left: 0.79in">Along the bottom of the Find
340 Duplicates window is an area that displays the count of files
341 contained in the window, and the number of files in the result list.</P>
342 <P STYLE="margin-left: 0.79in">The status bar will also display the
343 status of an active compare operation using the progress bar. A
344 compare operation involves 2 or 3 stages, depending on the type of
345 comparison. These are the stages in order:</P>
346 <P STYLE="margin-left: 1.58in">1) If necessary, extra data is read
347 into memory for the comparison stage, the progress bar will indicate
348 this stage with text that resembles &ldquo;reading dimensions...&rdquo;,
349 &ldquo;reading checksums...&rdquo;, or &ldquo;reading similarity
350 data...&rdquo;. <BR>2) The images are compared using the selected
351 method, the progress bar will indicate this stage with the text
352 &ldquo;comparing...&rdquo;.<BR>3) The results are sorted for display,
353 the progress bar will indicate this stage with the text &ldquo;sorting...&rdquo;.</P>
354 <P STYLE="margin-left: 0.79in">Stage 1 is only used for the
355 Dimensions, Checksum, and Similarity compare methods.</P>
356 <P STYLE="margin-left: 0.79in">If the time to complete a stage will
357 be significant, an estimated time to completion will also be
358 displayed in the progress bar. The estimated time only refers to the
359 current stage, other stages are not included in the estimate. The
360 time estimate is displayed using the format MINUTES:SECONDS.</P>
361 <P><BR><BR>
362 </P>
363 <P><U>Thumbnails</U></P>
364 <P STYLE="margin-left: 0.79in">Thumbnails can be displayed beside
365 each image in the result list by enabling the Thumbnails check box.</P>
366 <P><BR><BR>
367 </P>
368 <P><U>Compare two file sets</U></P>
369 <P STYLE="margin-left: 0.79in">Sometimes it is useful to compare one
370 group of files to another, different group of files. Enable this
371 check box to compare two groups of files. When enabled a second list
372 will appear, files can be added to this list using the same methods
373 for the main list.</P>
374 <P STYLE="margin-left: 0.79in">When comparing two file sets the
375 results list will display matches between the two lists. For each
376 match group, the first file is always from the main group, and the
377 remaining files are always from the second group.</P>
378 <P><BR><BR>
379 </P>
380 <P><U>Drag and Drop</U></P>
381 <P STYLE="margin-left: 0.79in">Drag and drop can be initiated with
382 the primary or middle mouse buttons. Dragging a file that is selected
383 will include all selected files in the drag. Dragging a file that is
384 not selected will first change the selection to the dragged file, and
385 clear the previous selection.</P>
386 <P><BR><BR>
387 </P>
388 <P><BR><BR>
389 </P>
390 <HR>
391 <CENTER>
392         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
393                 <COL WIDTH=85*>
394                 <COL WIDTH=85*>
395                 <COL WIDTH=85*>
396                 <THEAD>
397                         <TR VALIGN=TOP>
398                                 <TD WIDTH=33%>
399                                         <P><A HREF="5_1_search.html">Previous</A></P>
400                                 </TD>
401                                 <TD WIDTH=33%>
402                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
403                                 </TD>
404                                 <TD WIDTH=33%>
405                                         <P ALIGN=RIGHT><A HREF="6_collections.html">Next</A></P>
406                                 </TD>
407                         </TR>
408                 </THEAD>
409                 <TBODY>
410                         <TR VALIGN=TOP>
411                                 <TD WIDTH=33%>
412                                         <P><BR>
413                                         </P>
414                                 </TD>
415                                 <TD WIDTH=33%>
416                                         <P ALIGN=CENTER><BR>
417                                         </P>
418                                 </TD>
419                                 <TD WIDTH=33%>
420                                         <P ALIGN=RIGHT>GQview User Manual</P>
421                                 </TD>
422                         </TR>
423                 </TBODY>
424         </TABLE>
425 </CENTER>
426 <P STYLE="margin-bottom: 0in"><BR>
427 </P>
428 </BODY>
429 </HTML>