mirror of
https://github.com/arsenetar/dupeguru.git
synced 2024-11-05 07:49:02 +00:00
Andrew Senetar
bacba3f0a5
- Add sphinx documentation generated from build to help - Add link to help (in english) in header - Add link to github in header
253 lines
20 KiB
HTML
253 lines
20 KiB
HTML
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
|
||
<head>
|
||
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<title>Frequently Asked Questions — dupeGuru 4.0.3 documentation</title>
|
||
<link rel="stylesheet" href="_static/haiku.css" type="text/css" />
|
||
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
||
<script type="text/javascript" src="_static/documentation_options.js"></script>
|
||
<script type="text/javascript" src="_static/jquery.js"></script>
|
||
<script type="text/javascript" src="_static/underscore.js"></script>
|
||
<script type="text/javascript" src="_static/doctools.js"></script>
|
||
<script type="text/javascript" src="_static/translations.js"></script>
|
||
<link rel="index" title="Index" href="genindex.html" />
|
||
<link rel="search" title="Search" href="search.html" />
|
||
<link rel="next" title="Developer Guide" href="developer/index.html" />
|
||
<link rel="prev" title="Re-Prioritizing duplicates" href="reprioritize.html" />
|
||
</head><body>
|
||
<div class="header" role="banner"><h1 class="heading"><a href="index.html">
|
||
<span>dupeGuru 4.0.3 documentation</span></a></h1>
|
||
<h2 class="heading"><span>Frequently Asked Questions</span></h2>
|
||
</div>
|
||
<div class="topnav" role="navigation" aria-label="top navigation">
|
||
|
||
<p>
|
||
«  <a href="reprioritize.html">Re-Prioritizing duplicates</a>
|
||
  ::  
|
||
<a class="uplink" href="index.html">Contents</a>
|
||
  ::  
|
||
<a href="developer/index.html">Developer Guide</a>  »
|
||
</p>
|
||
|
||
</div>
|
||
<div class="content">
|
||
|
||
|
||
<div class="section" id="frequently-asked-questions">
|
||
<h1><a class="toc-backref" href="#id1">Frequently Asked Questions</a><a class="headerlink" href="#frequently-asked-questions" title="Permalink to this headline">¶</a></h1>
|
||
<div class="contents topic" id="contents">
|
||
<p class="topic-title first">Contents</p>
|
||
<ul class="simple">
|
||
<li><a class="reference internal" href="#frequently-asked-questions" id="id1">Frequently Asked Questions</a><ul>
|
||
<li><a class="reference internal" href="#what-is-dupeguru" id="id2">What is dupeGuru?</a></li>
|
||
<li><a class="reference internal" href="#what-makes-it-special" id="id3">What makes it special?</a></li>
|
||
<li><a class="reference internal" href="#how-safe-is-it-to-use-dupeguru" id="id4">How safe is it to use dupeGuru?</a></li>
|
||
<li><a class="reference internal" href="#how-can-i-report-a-bug-a-suggest-a-feature" id="id5">How can I report a bug a suggest a feature?</a></li>
|
||
<li><a class="reference internal" href="#the-mark-box-of-a-file-i-want-to-delete-is-disabled-what-must-i-do" id="id6">The mark box of a file I want to delete is disabled. What must I do?</a></li>
|
||
<li><a class="reference internal" href="#i-have-a-folder-from-which-i-really-don-t-want-to-delete-files" id="id7">I have a folder from which I really don’t want to delete files.</a></li>
|
||
<li><a class="reference internal" href="#what-is-this-x-discarded-notice-in-the-status-bar" id="id8">What is this ‘(X discarded)’ notice in the status bar?</a></li>
|
||
<li><a class="reference internal" href="#i-want-to-mark-all-files-from-a-specific-folder-what-can-i-do" id="id9">I want to mark all files from a specific folder. What can I do?</a></li>
|
||
<li><a class="reference internal" href="#i-want-to-remove-all-files-that-are-more-than-300-kb-away-from-their-reference-file-what-can-i-do" id="id10">I want to remove all files that are more than 300 KB away from their reference file. What can I do?</a></li>
|
||
<li><a class="reference internal" href="#i-want-to-make-my-latest-modified-files-reference-files-what-can-i-do" id="id11">I want to make my latest modified files reference files. What can I do?</a></li>
|
||
<li><a class="reference internal" href="#i-want-to-mark-all-duplicates-containing-the-word-copy-how-do-i-do-that" id="id12">I want to mark all duplicates containing the word “copy”. How do I do that?</a></li>
|
||
<li><a class="reference internal" href="#i-want-to-remove-all-songs-that-are-more-than-3-seconds-away-from-their-reference-file-what-can-i-do" id="id13">I want to remove all songs that are more than 3 seconds away from their reference file. What can I do?</a></li>
|
||
<li><a class="reference internal" href="#i-want-to-make-my-highest-bitrate-songs-reference-files-what-can-i-do" id="id14">I want to make my highest bitrate songs reference files. What can I do?</a></li>
|
||
<li><a class="reference internal" href="#i-don-t-want-live-and-remix-versions-of-my-songs-counted-as-duplicates-how-do-i-do-that" id="id15">I don’t want [live] and [remix] versions of my songs counted as duplicates. How do I do that?</a></li>
|
||
<li><a class="reference internal" href="#the-filter-hardness-slider-in-the-preferences-won-t-move" id="id16">The “Filter Hardness” slider in the preferences won’t move!</a></li>
|
||
<li><a class="reference internal" href="#i-ve-tried-to-send-my-duplicates-to-trash-but-dupeguru-is-telling-me-it-can-t-do-it-why-what-can-i-do" id="id17">I’ve tried to send my duplicates to Trash, but dupeGuru is telling me it can’t do it. Why? What can I do?</a></li>
|
||
<li><a class="reference internal" href="#why-is-picture-mode-s-contents-scan-so-slow" id="id18">Why is Picture mode’s contents scan so slow?</a></li>
|
||
<li><a class="reference internal" href="#where-are-user-files-located" id="id19">Where are user files located?</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="what-is-dupeguru">
|
||
<h2><a class="toc-backref" href="#id2">What is dupeGuru?</a><a class="headerlink" href="#what-is-dupeguru" title="Permalink to this headline">¶</a></h2>
|
||
<p>dupeGuru is a tool to find duplicate files on your computer. It has three operational modes:
|
||
Standard, Music and Picture. Each mode has its own specialized preferences.</p>
|
||
<p>Each mode has multiple scan types, such as filename, contents, tags. Some scan types feature
|
||
advanced fuzzy matching algorithm, allowing you to find duplicates that other more rigid duplicate
|
||
scanners can’t.</p>
|
||
</div>
|
||
<div class="section" id="what-makes-it-special">
|
||
<h2><a class="toc-backref" href="#id3">What makes it special?</a><a class="headerlink" href="#what-makes-it-special" title="Permalink to this headline">¶</a></h2>
|
||
<p>It’s mostly about customizability. There’s a lot of scanning options that allow you to get the
|
||
type of results you’re really looking for.</p>
|
||
</div>
|
||
<div class="section" id="how-safe-is-it-to-use-dupeguru">
|
||
<h2><a class="toc-backref" href="#id4">How safe is it to use dupeGuru?</a><a class="headerlink" href="#how-safe-is-it-to-use-dupeguru" title="Permalink to this headline">¶</a></h2>
|
||
<p>Very safe. dupeGuru has been designed to make sure you don’t delete files you didn’t mean to delete.
|
||
First, there is the reference folder system that lets you define folders where you absolutely
|
||
<strong>don’t</strong> want dupeGuru to let you delete files there, and then there is the group reference system
|
||
that makes sure that you will <strong>always</strong> keep at least one member of the duplicate group.</p>
|
||
</div>
|
||
<div class="section" id="how-can-i-report-a-bug-a-suggest-a-feature">
|
||
<h2><a class="toc-backref" href="#id5">How can I report a bug a suggest a feature?</a><a class="headerlink" href="#how-can-i-report-a-bug-a-suggest-a-feature" title="Permalink to this headline">¶</a></h2>
|
||
<p>dupeGuru is hosted on <a class="reference external" href="https://github.com/hsoft/dupeguru">Github</a> and it’s also where issues are tracked. The best way to report a
|
||
bug or suggest a feature is to sign up on Github and <a class="reference external" href="https://github.com/hsoft/dupeguru/wiki/issue-labels">open an issue</a>.</p>
|
||
</div>
|
||
<div class="section" id="the-mark-box-of-a-file-i-want-to-delete-is-disabled-what-must-i-do">
|
||
<h2><a class="toc-backref" href="#id6">The mark box of a file I want to delete is disabled. What must I do?</a><a class="headerlink" href="#the-mark-box-of-a-file-i-want-to-delete-is-disabled-what-must-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<p>You cannot mark the reference (The first file) of a duplicate group. However, what you can do is to
|
||
promote a duplicate file to reference. Thus, if a file you want to mark is reference, select a
|
||
duplicate file in the group that you want to promote to reference, and click on
|
||
<strong>Actions–>Make Selected into Reference</strong>. If the reference file is from a reference folder
|
||
(filename written in blue letters), you cannot remove it from the reference position.</p>
|
||
</div>
|
||
<div class="section" id="i-have-a-folder-from-which-i-really-don-t-want-to-delete-files">
|
||
<h2><a class="toc-backref" href="#id7">I have a folder from which I really don’t want to delete files.</a><a class="headerlink" href="#i-have-a-folder-from-which-i-really-don-t-want-to-delete-files" title="Permalink to this headline">¶</a></h2>
|
||
<p>If you want to be sure that dupeGuru will never delete file from a particular folder, make sure to
|
||
set its state to <strong>Reference</strong> at <a class="reference internal" href="folders.html"><span class="doc">Folder Selection</span></a>.</p>
|
||
</div>
|
||
<div class="section" id="what-is-this-x-discarded-notice-in-the-status-bar">
|
||
<h2><a class="toc-backref" href="#id8">What is this ‘(X discarded)’ notice in the status bar?</a><a class="headerlink" href="#what-is-this-x-discarded-notice-in-the-status-bar" title="Permalink to this headline">¶</a></h2>
|
||
<p>In some cases, some matches are not included in the final results for security reasons. Let me use
|
||
an example. We have 3 file: A, B and C. We scan them using a low filter hardness. The scanner
|
||
determines that A matches with B, A matches with C, but B does <strong>not</strong> match with C. Here, dupeGuru
|
||
has kind of a problem. It cannot create a duplicate group with A, B and C in it because not all
|
||
files in the group would match together. It could create 2 groups: one A-B group and then one A-C
|
||
group, but it will not, for security reasons. Lets think about it: If B doesn’t match with C, it
|
||
probably means that either B, C or both are not actually duplicates. If there would be 2 groups (A-B
|
||
and A-C), you would end up delete both B and C. And if one of them is not a duplicate, that is
|
||
really not what you want to do, right? So what dupeGuru does in a case like this is to discard the
|
||
A-C match (and adds a notice in the status bar). Thus, if you delete B and re-run a scan, you will
|
||
have a A-C match in your next results.</p>
|
||
</div>
|
||
<div class="section" id="i-want-to-mark-all-files-from-a-specific-folder-what-can-i-do">
|
||
<h2><a class="toc-backref" href="#id9">I want to mark all files from a specific folder. What can I do?</a><a class="headerlink" href="#i-want-to-mark-all-files-from-a-specific-folder-what-can-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<p>Enable the <a class="reference internal" href="results.html"><span class="doc">Dupes Only</span></a> mode and click on the Folder column to sort your duplicates
|
||
by folder. It will then be easy for you to select all duplicates from the same folder, and then
|
||
press Space to mark all selected duplicates.</p>
|
||
</div>
|
||
<div class="section" id="i-want-to-remove-all-files-that-are-more-than-300-kb-away-from-their-reference-file-what-can-i-do">
|
||
<h2><a class="toc-backref" href="#id10">I want to remove all files that are more than 300 KB away from their reference file. What can I do?</a><a class="headerlink" href="#i-want-to-remove-all-files-that-are-more-than-300-kb-away-from-their-reference-file-what-can-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<ul class="simple">
|
||
<li>Enable the <a class="reference internal" href="results.html"><span class="doc">Dupes Only</span></a> mode.</li>
|
||
<li>Enable the <strong>Delta Values</strong> mode.</li>
|
||
<li>Click on the “Size” column to sort the results by size.</li>
|
||
<li>Select all duplicates below -300.</li>
|
||
<li>Click on <strong>Remove Selected from Results</strong>.</li>
|
||
<li>Select all duplicates over 300.</li>
|
||
<li>Click on <strong>Remove Selected from Results</strong>.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="i-want-to-make-my-latest-modified-files-reference-files-what-can-i-do">
|
||
<h2><a class="toc-backref" href="#id11">I want to make my latest modified files reference files. What can I do?</a><a class="headerlink" href="#i-want-to-make-my-latest-modified-files-reference-files-what-can-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<ul class="simple">
|
||
<li>Enable the <a class="reference internal" href="results.html"><span class="doc">Dupes Only</span></a> mode.</li>
|
||
<li>Enable the <strong>Delta Values</strong> mode.</li>
|
||
<li>Click on the “Modification” column to sort the results by modification date.</li>
|
||
<li>Click on the “Modification” column again to reverse the sort order.</li>
|
||
<li>Select all duplicates over 0.</li>
|
||
<li>Click on <strong>Make Selected into Reference</strong>.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="i-want-to-mark-all-duplicates-containing-the-word-copy-how-do-i-do-that">
|
||
<h2><a class="toc-backref" href="#id12">I want to mark all duplicates containing the word “copy”. How do I do that?</a><a class="headerlink" href="#i-want-to-mark-all-duplicates-containing-the-word-copy-how-do-i-do-that" title="Permalink to this headline">¶</a></h2>
|
||
<ul class="simple">
|
||
<li>Type “copy” in the “Filter” field in the top-right corner of the result window.</li>
|
||
<li>Click on <strong>Mark –> Mark All</strong>.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="i-want-to-remove-all-songs-that-are-more-than-3-seconds-away-from-their-reference-file-what-can-i-do">
|
||
<h2><a class="toc-backref" href="#id13">I want to remove all songs that are more than 3 seconds away from their reference file. What can I do?</a><a class="headerlink" href="#i-want-to-remove-all-songs-that-are-more-than-3-seconds-away-from-their-reference-file-what-can-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<ul class="simple">
|
||
<li>Enable the <a class="reference internal" href="results.html"><span class="doc">Dupes Only</span></a> mode.</li>
|
||
<li>Enable the <strong>Delta Values</strong> mode.</li>
|
||
<li>Click on the “Time” column to sort the results by time.</li>
|
||
<li>Select all duplicates below -00:03.</li>
|
||
<li>Click on <strong>Remove Selected from Results</strong>.</li>
|
||
<li>Select all duplicates over 00:03.</li>
|
||
<li>Click on <strong>Remove Selected from Results</strong>.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="i-want-to-make-my-highest-bitrate-songs-reference-files-what-can-i-do">
|
||
<h2><a class="toc-backref" href="#id14">I want to make my highest bitrate songs reference files. What can I do?</a><a class="headerlink" href="#i-want-to-make-my-highest-bitrate-songs-reference-files-what-can-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<ul class="simple">
|
||
<li>Enable the <a class="reference internal" href="results.html"><span class="doc">Dupes Only</span></a> mode.</li>
|
||
<li>Enable the <strong>Delta Values</strong> mode.</li>
|
||
<li>Click on the “Bitrate” column to sort the results by bitrate.</li>
|
||
<li>Click on the “Bitrate” column again to reverse the sort order.</li>
|
||
<li>Select all duplicates over 0.</li>
|
||
<li>Click on <strong>Make Selected into Reference</strong>.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="i-don-t-want-live-and-remix-versions-of-my-songs-counted-as-duplicates-how-do-i-do-that">
|
||
<h2><a class="toc-backref" href="#id15">I don’t want [live] and [remix] versions of my songs counted as duplicates. How do I do that?</a><a class="headerlink" href="#i-don-t-want-live-and-remix-versions-of-my-songs-counted-as-duplicates-how-do-i-do-that" title="Permalink to this headline">¶</a></h2>
|
||
<p>If your comparison threshold is low enough, you will probably end up with live and remix
|
||
versions of your songs in your results. There’s nothing you can do to prevent that, but there’s
|
||
something you can do to easily remove them from your results after the scan: post-scan
|
||
filtering. If, for example, you want to remove every song with anything inside square brackets
|
||
[]:</p>
|
||
<ul class="simple">
|
||
<li>Type “[*]” in the “Filter” field in the top-right corner of the result window.</li>
|
||
<li>Click on <strong>Mark –> Mark All</strong>.</li>
|
||
<li>Click on <strong>Actions –> Remove Selected from Results</strong>.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section" id="the-filter-hardness-slider-in-the-preferences-won-t-move">
|
||
<h2><a class="toc-backref" href="#id16">The “Filter Hardness” slider in the preferences won’t move!</a><a class="headerlink" href="#the-filter-hardness-slider-in-the-preferences-won-t-move" title="Permalink to this headline">¶</a></h2>
|
||
<p>This slider is only relevant for scan types that support “fuzziness”. Many scan types, such as the
|
||
“Contents” type, only support exact matches. When these types are selected, the slider is disabled.</p>
|
||
<p>On some OS, the fact that it’s disabled is harder to see than on others, but if you can’t move the
|
||
slider, it means that this preference is irrelevant in your current scan type.</p>
|
||
</div>
|
||
<div class="section" id="i-ve-tried-to-send-my-duplicates-to-trash-but-dupeguru-is-telling-me-it-can-t-do-it-why-what-can-i-do">
|
||
<h2><a class="toc-backref" href="#id17">I’ve tried to send my duplicates to Trash, but dupeGuru is telling me it can’t do it. Why? What can I do?</a><a class="headerlink" href="#i-ve-tried-to-send-my-duplicates-to-trash-but-dupeguru-is-telling-me-it-can-t-do-it-why-what-can-i-do" title="Permalink to this headline">¶</a></h2>
|
||
<p>Most of the time, the reason why dupeGuru can’t send files to Trash is because of file permissions.
|
||
You need <em>write</em> permissions on files you want to send to Trash.</p>
|
||
<p>If dupeGuru still gives you troubles after fixing your permissions, try enabling the “Directly
|
||
delete files” option that is offered to you when you activate Send to Trash. This will not send
|
||
files to the Trash, but delete them immediately. In some cases, for example on network storage
|
||
(NAS), this has been known to work when normal deletion didn’t.</p>
|
||
<p>If this fail, <a class="reference external" href="https://forum.hardcoded.net/">HS forums</a> might be of some help.</p>
|
||
</div>
|
||
<div class="section" id="why-is-picture-mode-s-contents-scan-so-slow">
|
||
<h2><a class="toc-backref" href="#id18">Why is Picture mode’s contents scan so slow?</a><a class="headerlink" href="#why-is-picture-mode-s-contents-scan-so-slow" title="Permalink to this headline">¶</a></h2>
|
||
<p>This scanning method is very different from methods. It can detect duplicate photos even if they
|
||
are not exactly the same. This very cool capability has a cost: time. Every picture has to be
|
||
individually and fuzzily matched to all others, and this takes a lot of CPU power.</p>
|
||
<p>If all you need to find is exact duplicates, just use the standard mode of dupeGuru with the
|
||
Contents scan method. If your photos have EXIF tags, you can also try the “EXIF” scan method which
|
||
is much faster.</p>
|
||
</div>
|
||
<div class="section" id="where-are-user-files-located">
|
||
<h2><a class="toc-backref" href="#id19">Where are user files located?</a><a class="headerlink" href="#where-are-user-files-located" title="Permalink to this headline">¶</a></h2>
|
||
<p>For some reason, you’d like to remove or edit dupeGuru’s user files (debug logs, caches, etc.).
|
||
Where they’re located depends on your platform:</p>
|
||
<ul class="simple">
|
||
<li>Linux: <code class="docutils literal notranslate"><span class="pre">~/.local/share/data/Hardcoded</span> <span class="pre">Software/dupeGuru</span></code></li>
|
||
<li>Mac OS X: <code class="docutils literal notranslate"><span class="pre">~/Library/Application</span> <span class="pre">Support/dupeGuru</span></code></li>
|
||
</ul>
|
||
<p>Preferences are stored elsewhere:</p>
|
||
<ul class="simple">
|
||
<li>Linux: <code class="docutils literal notranslate"><span class="pre">~/.config/Hardcoded</span> <span class="pre">Software/dupeGuru.conf</span></code></li>
|
||
<li>Mac OS X: In the built-in <code class="docutils literal notranslate"><span class="pre">defaults</span></code> system, as <code class="docutils literal notranslate"><span class="pre">com.hardcoded-software.dupeguru</span></code></li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
</div>
|
||
<div class="bottomnav" role="navigation" aria-label="bottom navigation">
|
||
|
||
<p>
|
||
«  <a href="reprioritize.html">Re-Prioritizing duplicates</a>
|
||
  ::  
|
||
<a class="uplink" href="index.html">Contents</a>
|
||
  ::  
|
||
<a href="developer/index.html">Developer Guide</a>  »
|
||
</p>
|
||
|
||
</div>
|
||
|
||
<div class="footer" role="contentinfo">
|
||
© Copyright 2016, Hardcoded Software.
|
||
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.7.1.
|
||
</div>
|
||
</body>
|
||
</html> |