Brattoo Propaganda Software®

Duplicate Annihilator – Edition User Guide rev 1.0.0 (2010-03-09)

©2010 Brattoo Propaganda Software®. All rights reserved. Duplicate Annihilator – User Guide ©2009 Brattoo Propaganda Software®. All rights reserved. Apple, Mac, , Mac OS, OS X and iPhoto are either registered trademarks or trade- NOTICE: This publication and the information herein is furnished AS IS, is subject to change marks of Apple Computer, Inc., registered in the United States and other countries. without notice, and should not be construed as a commitment by Brattoo Propaganda Software®. Brattoo Propaganda Software® assumes no responsibility or liability for any errors All other trademarks are the property of their respective owners. or inaccuracies, makes no warranty of any kind (express, implied, or statutory) with respect to this publication, and expressly disclaims any and all warranties of merchantability, fitness Please note that the content in this guide is protected under copyright law for particular purposes, and noninfringement of third party rights. The content of this guide is furnished for informational use only, is subject to change without Any references to company names in sample templates are for demonstration purposes only notice, and should not be construed as a commitment by Brattoo Propaganda Software®. and are not intended to refer to any actual organization. Brattoo Propaganda Software® assumes no responsibility or liability for any errors or inac- curacies that may appear in the informational content contained in this guide. Brattoo Propaganda Software® and Duplicate Annihilator are either registered trademarks or trademarks of Brattoo Propaganda Software® in the United States and/or other countries. Brattoo Propaganda Software®, [email protected], http://brattoo.com/propaganda Duplicate Annihilator – User Guide

Table of Contents

Overview ...... 4 Install Duplicate Annihilator ...... 5 Registering/Purchasing ...... 6 Annihilating duplicates ...... 7 Using the compare images tab ...... 10 Preferences ...... 11 Thumbnail Annihilator ...... 14 Frequently Asked Questions ...... 15 License ...... 18 Overview Key features Duplicate Annihilator is the leading application for dealing with iPhoto • Easily find and annihilate duplicates created during import. duplicates now it is available in a version for Aperture 3: • Compare master images using different algorithms to detect and Duplicate Annihilator – Aperture Edition. understand differences. • Detect duplicates using effective algorithms using electronic check- The easy way to find duplicates in Aperture sums like MD5 and CRC32. Duplicate Annihilator - Aperture Edition takes on the time consuming • Detect duplicates by using file specific meta data such as filename, task comparing the Master images in your Aperture database using effec- dimensions, file size, Exif creation date or date of creation. tive algorithms to make sure that no duplicates escape. When a duplicate • Marks versions keyword of your choice to make them easy to find is found the versions of that master be marked with a keyword of your using Aperture features like search or smart folders. choice to make it easy to locate and delete. • Makes your Aperture slimmer and faster. • Free updates!

4 Duplicate Annihilator – User Guide Install Duplicate Annihilator – Aperture Edition To install Duplicate Annihilator – Aperture Edition simply follow those steps:

1. Download Duplicate Annihilator – Aperture Edition from http://brattoo.com/propaganda 2. Unzip and mount the downloaded package. This is normally done automagically. 3. A window will appear where you can drag the application Duplicate Annihilator – Aperture Edition to your Applications folder. 4. Drag the application to the Applications folder 5. The application is now installed and you may run it from your Ap- plications folder located on your hard drive.

Updates? You may always download the latest version of Duplicate Annihilator – Aperture Edi- tion from http://brattoo.com/propaganda Duplicate Annihilator – Aperture edition will ? automatically check for updates online and notify if there is an update available.

Duplicate Annihilator – User Guide 5 Registering/Purchasing 4. Click on the register button Duplicate Annihilator – Aperture Edition is shareware which means that 5. Duplicate Annihilator is now unlocked and fully functional to be able to fully utilize it you need to purchase a license (currently The serial number will be verified by our online serial number verifica- $7.95). If you decide to run Duplicate Annihilator – Aperture edition in tion servers. demo mode it will be limited to only scan through the first 500 images of your iPhoto library.

To purchase a license simply go to our site at http://brattoo.com/propaganda and click on any of the ”buy” or ”purchase now” buttons and you will be taken to our online store. The purchase will be done through the secure servers provided by Esellerate. net. For further information regarding security and online purchasing please visit http://shopper.esellerate.net/ics/support/default.asp?deptID=5620

When you have made your purchase you will receive an email contain- ing your serial number. Please note that this is an automatic process so if you have a spam filter you will have to make sure that the email can get through to your mailbox.

To register/unlock Duplicate Annihilator – Aperture Edition with your serial number simply follow those steps: 1. Open Duplicate Annihilator – Aperture Edition 2. Click on the register tab If you encounter problems please contact us at 3. Fill out the form with your serial number [email protected]

6 Duplicate Annihilator – User Guide Annihilating duplicates cal and are therefor not compared. Since all versions of a master To locate and annihilate duplicates in iPhoto use the Find duplicates tab images are marked when a duplicate is detected one reported detection in Duplicate Annihilator – Aperture edition. When you click on the Find in Duplicate annihilator can result in numerous marked version images in and annihilate duplicates button the annihilation process will begin Aperture. based on the settings in the Preferences tab. See the preferences section of this document for a better understanding of the different settings and The Aperture library database can also contain master images that are options. not represented by a version in the Aperture application. This can result in that one reported found duplicate may not be represented bay version The concept image in the Aperture application. Duplicate Annihilator - Aperture Edition scans the Aperture library database for master images, compares them and then marks all versions Basic Mode vs. Magic mode When running in Magic mode Duplicate Annihilator analyses the master of the duplicates masters by assigning a keyword to them. The keyword images in the Aperture data base ”on the fly” to be able to use the most is defined in Duplicate Annihilator. There is also an option to mark the effective detection algorithms. When using Magic mode Duplicate Anni- versions of the original master image by another keyword. hilator – Aperture edition ignores the user selected detection algorithms. Magic mode might run slightly slower than Classic mode. To use user All shown images in Aperture are versions of the imported master image, selected detection algorithms use Classic mode. one master can result in numerous versions but those are not real physi-

IMPORTANT! Do not start Aperture during the annihilation process. Interference may cause unex- pected results and corrupt the Aperture data base. Therefor, always wait for Duplicate ! Annihilator to finish or cancel before using Aperture. Duplicate Annihilator – User Guide 7 ”On finish” actions Since it can take quite some time to process large Aperture databases Duplicate Annihilator – Aperture Edition is equipped with a series of ”on finish” actions. Those ”on finish” actions can be used to either set the com- puter to sleep or shut it down when the duplicate annihilation process has finished. The ”on finish” actions may be selected and/or changed by the user during a duplicate annihilation in progress.

8 Duplicate Annihilator – User Guide Hints to consider when annihilating duplicates try this: Sometimes the default settings in Duplicate Annihilator – Aperture 1. Open Aperture Edition just isn’t enough so here are a few hints on how to handle those 2. Create a smart album that lists images whose album name is situations. empty and has the keyword ”duplicate”. This album will show all images that have the ”duplicate” keyword and is not used in The MD5 checksum simply wasn’t enough, all duplicates wasn’t any album. found. 3. Select the images in the smart album and choose File->Delete Even the slightest modification to an image will cause it to result in Master Image and All versions. a completely different MD5 checksum so two images that might be 4. Your duplicates that is not being used in any album have now identical to the eye might not be identical to Duplicate Annihila- been moved to the Aperture trash can. tor – Aperture Edition. You will therefor have to try a different set of detection algorithms. A popular set of detection algorithms is the Exif creation date combined with the first XX characters of the filename. The Exif creation date is the date and time stored by your within the actual images file and this date and time is preserved when duplicating and/or modifying an image. For more information see the Preferences section of this document.

Some duplicates might be used in Aperture albums and I don’t want those duplicates to be deleted. This is a problem with duplicates, you never know where you have used them. If you think that you might have duplicates that are be- ing used in an album and you don’t want them to be deleted then

Duplicate Annihilator – User Guide 9 Preferences The Preferences tab in Duplicate Annihilator – Aperture Edition allows you to change the behaviour of Duplicate Annihilator – Aperture Edi- tion according to your needs.

Algorithms Duplicate Annihilator features a series of detection algorithm, each with it’s own benefits and drawbacks. The algorithms can be combined so that one or many of them have to match for two images to be con- sidered duplicates.

MD5 checksum This detection algorithm calculates a digital checksum (fingerprint) us- ing the commonly used MD5 checksum algorithm. The checksum is cal- culated based on the content of the actual image file and two images will have to be identical down to the very bit for them to be considered duplicates. This is the default and recommended detection algorithm.

CRC32 checksum This detection algorithm works exactly as the MD5 checksum but uses a different algorithm when calculating the checksum.

10 Duplicate Annihilator – User Guide Creation date Process Order The creation date and time of the image file. This is not always the same Duplicate Annihilator – Aperture edition consider the first encountered as the date and time when the picture was taken. master image with a unique detection algorithm value to be the original, all master images that follows with the same detection algorithm value Exif creation date are the duplicates. Therefor Duplicate Annihilator – Aperture Edition has This is the date and time stored by your digital camera within the meta an option that let you decide if Duplicate Annihilator – Aperture Edition data part of the actual image file. This date is usually preserved when should start at the beginning and walk forward or from the end and walk making modifications and/or duplicates of an image and can therefor be backward through the iphoto library. a very useful algorithm when hunting down duplicates. Forward First XX characters in filename When walking from the start(forward) of the Aperture masters database This detection algorithm is used to compare the first characters of the the oldest (first added to Aperture) copy of a series of duplicates will be filenames, how many of the first characters that should be compared is the original. up to you. Backward Width When walking from the end(backward) of the Aperture masters database This is simply the pictures’ width in pixels. the newest (latest import to Aperture) copy of a series of duplicates will be the original. Height This is simply the pictures’ height in pixels.

File size This is the size of the file in bytes.

Duplicate Annihilator – User Guide 11 Actions When a duplicate is found all versions of that Master images will get a keyword of your choice attached to them. Optionally also the origi- nals master versions can get a keyword. If the keywords, as defined in Duplicate Annihilator – Aperture Edition, does not exist in the Aperture keyword database then they will be created.

12 Duplicate Annihilator – User Guide Frequently Asked Questions Q: I have selected all the detection algorithms and Duplicate Annihi- Q: I’ve lost my serial nuber where can I get it? lator – Aperture Edition does not find a single duplicate. What went A: To get your serial number simply go to http://brattoo.com/propa- wrong? ganda/support.php and use the online lost serial number form. A: Don’t select all the algorithms. Selecting multiple detection algo- rithms will cause those to be combined in to a single search for each Q: I have entered my serial number but Duplicate Annihilator – Aper- image. Multiple algorithms will narrow the search result and will ture Edition fails to register. Why? result in fewer found duplicates. Multiple algorithms will also cause A: By default Duplicate Annihilator – Aperture Edition tries to vali- the detection process to run much slower since more meta data has date your serial number online so you need to have Internet access. to be collected from each image. If you do not have Internet access please contact us and we will help you to solve this. Q: I have used the default preferences in Duplicate Annihilator – Aperture Edition and it says that it found XXXX duplicates but the Q: Which detection algorithm should I use in Classic Mode? Aperture Library seems to be intact. Why? A: By default Duplicate Annihilator – Aperture Edition uses the MD5 A: That is correct, Duplicate Annihilator – Aperture Edition does NOT digital checksum algorithm which is a quick and effective method delete the found duplicates but assigns a keyword to them. You may to detect duplicates. If a duplicate has been modified in any way the then locate those duplicates in Aperture simply by using the search duplicate will render a different digital checksum and will there for field in Aperture and search for the keyword ”duplicate”. not be detected as a duplicate. Do I have to pay for future updates of Duplicate Annihilator – Aper- Q: I have used the MD5 algorithm but Duplicate Annihilator – Aperture ture Edition? Edition failed to detect all the duplicates. What should I do? No, upgrades are free of charge, even for major upgrades. A: Sometimes there are what-seems-to-be-duplicates left in your iPhoto Library. The most probably cause is that the images are slightly We are an organization, school, workplace etc. and we would like to get a modified in some way. A popular combination of detection algorithms volume discount. Is that possible? is the Exif creation date combined with First XX characters of filenames. Yes, contact us at [email protected] and we’ll work something out.

Duplicate Annihilator – User Guide 13 14 Duplicate Annihilator – User Guide Need further assistance? Check out our online support at http://brattoo.com/propaganda/support.php there you will find the latest version of this document and our online FAQ that updates fre- ? quently. Or contact us directly at [email protected]

Duplicate Annihilator – User Guide 15 LICENSE 2. DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS. This End-User License Agreement (”EULA”) is a legal agreement between a) Limitations on Reverse Engineering, Decompilation, and Disassem- you (either an individual or a single entity) and Brattoo Propaganda bly – You may NOT reverse engineer, decompile, or disassemble the Software® for the Duplicate Annihilator accompanying this EULA, which SOFTWARE PRODUCT, except and only to the extent that such activity is includes computer software and may include associated media, printed expressly permitted by applicable law notwithstanding this limitation. materials, and ”online” or electronic documentation (”SOFTWARE PROD- b) Separation of Components – The SOFTWARE PRODUCT is licensed as UCT” or ”SOFTWARE”). a single product -- Its component parts may not be separated for use on By exercising your rights to use the SOFTWARE PRODUCT, you agree to more than one computer. be bound by the terms of this EULA. c) Software Transfer – You may permanently transfer all of your rights If you do not agree to the terms of this EULA, you may not use the under this EULA, provided the recipient agrees to the terms of this EULA. SOFTWARE PRODUCT. Such transfer must include any and all copies of the SOFTWARE PROD- UCT and its component parts. SOFTWARE PRODUCT LICENSE d) Termination – Without prejudice to any other rights, Brattoo Propa- The SOFTWARE PRODUCT is protected by copyright laws and interna- ganda Software, may terminate this EULA if you fail to comply with the tional copyright treaties, as well as other intellectual property laws and terms and conditions of this EULA. treaties. The SOFTWARE PRODUCT is licensed, not sold. In such event, you must destroy all copies of the SOFTWARE PRODUCT and all of its component parts. 1. GRANT OF LICENSE. This EULA grants you the following rights: 3. COPYRIGHT. Installation and Use – You may install and use a single copy of the All title and copyrights in and to the SOFTWARE PRODUCT (including, SOFTWARE PRODUCT. but not limited to, any images, photographs, animations, video, audio, Reproduction and Distribution – You may NOT reproduce or distribute , text, and ”applets” incorporated into the SOFTWARE PRODUCT), copies of the SOFTWARE PRODUCT or its component parts, except and the accompanying printed materials, and any copies of the SOFTWARE only to the extent that such activity is expressly permitted by applicable PRODUCT are owned by Brattoo Propaganda Software, or its suppliers. law notwithstanding this limitation.

16 Duplicate Annihilator – User Guide The SOFTWARE PRODUCT is protected by copyright laws and internation- 6. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. al treaty provisions. Therefore, you must treat the SOFTWARE PRODUCT In no event shall Brattoo Propaganda Software®, or its suppliers be liable like any other copyrighted material. for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business informa- 4. U.S. GOVERNMENT RESTRICTED RIGHTS. tion, or any other pecuniary loss) arising out of the use of or inability to The SOFTWARE PRODUCT and documentation are provided with RE- use this Brattoo Propaganda Software®, product, even if Brattoo Propa- STRICTED RIGHTS. ganda Software®, has been advised of the possibility of such damages. Use, duplication, or disclosure by the Government is subject to restric- Because some states/jurisdictions do not allow the exclusion or limita- tions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data tion of liability for consequential or incidental damages, the above limita- and Computer Software clause at DFARS 252.227-7013 or subparagraphs tion may not apply to you. (c)(1) and (2) of the Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable. 7. MISCELLANEOUS. Manufacturer is: Brattoo Propaganda Software If you acquired this product in the United States, this EULA is governed by the laws of the State of California. 5. LIMITED WARRANTY. NO WARRANTIES. If this product was acquired outside the United States, then local laws Brattoo Propaganda Software, expressly disclaims any warranty for the may apply. SOFTWARE PRODUCT. As the user, I agree that I am responsible for my own actions using Du- The SOFTWARE PRODUCT and any related documentation is provided plicate Annihilator. I agree that I will not use Duplicate Annihilator to in- ”as is” without warranty of any kind, either express or implied, including, fringe on copyright laws. I also agree that Brattoo Propaganda Software® without limitation, the implied warranties or merchantability, for a will not be responsible for anything I do with Duplicate Annihilator. particular purpose, or noninfringement. The entire risk arising out of use or performance of the SOFTWARE PRODUCT remains with you.

Duplicate Annihilator – User Guide 17