1
0
mirror of https://github.com/arsenetar/dupeguru.git synced 2026-01-22 14:41:39 +00:00

Update documentation

This commit is contained in:
Virgil Dupras
2016-06-06 20:48:26 -04:00
parent 13fb06a693
commit 668821301c
14 changed files with 108 additions and 1380 deletions

View File

@@ -2,13 +2,45 @@ Folder Selection
================
The first window you see when you launch dupeGuru is the folder selection window. This windows
contains the list of the folders that will be scanned when you click on **Scan**.
contains the basic input dupeGuru needs to start a scan:
This window is quite straightforward to use. If you want to add a folder, click on the **+** button.
If you added folder before, a popup menu with a list of recent folders you added will pop. You can
click on one of them to add it directly to your list. If you click on the first item of the popup
menu, **Add New Folder...**, you will be prompted for a folder to add. If you never added a folder,
no menu will pop and you will directly be prompted for a new folder to add.
* An Application Mode selection
* A Scan Type selection
* Folders to scan
Application Mode
----------------
dupeGuru had three main modes: Standard, Music and Picture.
Standard is for any type of files. This makes this mode the most polyvalent, but it lacks
specialized features other modes have.
Music mode scans only music files, but it supports tags comparison and its results window has many
audio-related informational columns.
Picture mode scans only pictures, but its contents scan type is a powerful fuzzy matcher that can
find pictures that are similar without being exactly the same.
Choosing an application mode not only changes available scan types in the selector below, but also
changes available options in the preferences panel. Thus, if you want to fine tune your scan, be
sure to open the preferences panel **after** you've selected the application mode.
Scan Type
---------
This selector determines the type of the scan we'll do. See :doc:`scan` for details about scan
types.
Folder List
-----------
To add a folder, click on the **+** button. If you added folder before, a popup
menu with a list of recent folders you added will pop. You can click on one of
them to add it directly to your list. If you click on the first item of the
popup menu, **Add New Folder...**, you will be prompted for a folder to add. If
you never added a folder, no menu will pop and you will directly be prompted
for a new folder to add.
An alternate way to add folders to the list is to drag them in the list.
@@ -37,31 +69,8 @@ folder if you want to be sure that you won't delete any file from it.
When you set the state of a directory, all subfolders of this folder automatically inherit this
state unless you explicitly set a subfolder's state.
.. _iphoto:
Scan
----
iPhoto and Aperture libraries
-----------------------------
dupeGuru Picture Edition supports iPhoto and Aperture, which means that it knows how to read these
libraries and how to communicate with iPhoto and Aperture to remove photos from them. To use this
feature, use the special "Add iPhoto Library" and "Add Aperture Library" buttons in the menu that
pops up when you click the "+" button. This will then add a special folder for those libraries.
When duplicates are deleted (sent to trash) from an iPhoto library, it's sent to iPhoto's
trash.
When duplicates are deleted (sent to trash) from an Aperture library, it unfortunately can't
send it directly to trash, but it creates a special project called "dupeGuru Trash" in Aperture
and send all photos in there. You can then send this project to the trash manually.
iTunes library
--------------
dupeGuru Music Edition supports iTunes, which means that it knows how to read its libraries and how
to communicate with iTunes to remove songs from it. To use this feature, use the special
"Add iTunes Library" button in the menu that pops up when you click the "+" button. This will
then add a special folder for those libraries.
When duplicates are deleted from an iTunes library, it's sent to the system trash, like a
normal file, but it's also removed from iTunes, thus avoiding ending up with missing entries
(entries with the "!" logo next to them).
When you're ready, click on the **Scan** button to initiate the scanning process. When it's done,
you'll be shown the :doc:`results`.