dupeguru /

Filename Size Date modified Message
cocoalib [b68cc628471d]
hsdocgen [8c94ba7bea60]
hsgui [34a645503d66]
hsmedia [51b7b39ee7c0]
hsutil [bcc904c1a8ba]
qtlib [7d24a308dc0a]
335 B
245 B
291 B
745 B
1.7 KB
3.2 KB
3.6 KB
1.4 KB
2.8 KB
1.2 KB

This package contains the source for dupeGuru. To learns how to build it, refer to the "Build dupeGuru" section. Below is the description of the various subfolders:

- core: Contains the core logic code for dupeGuru. It's Python code written in TDD style.
- core_*: Edition-specific-cross-toolkit code written in Python.
- cocoa: UI code for the Cocoa toolkit. It's Objective-C code.
- qt: UI code for the Qt toolkit. It's written in Python and uses PyQt. Before redistributing changes in this part of the code, read the "qt/WARNING" file.
- images: Images used by the different UI codebases.

There are also other sub-folder that comes from external repositories (automatically checked out
with svn:externals):

- hsutil: A collection of helpers used across HS applications.
- hsdocgen: An ad-hoc document generation used across HS project (used for help files)
- hsmedia: A library to read audio file metadata, used in dupeGuru ME.
- cocoalib: A collection of helpers used across Cocoa UI codebases of HS applications.
- qtlib: A collection of helpers used across Qt UI codebases of HS applications.

dupeGuru Dependencies

Before being able to build dupeGuru, a few dependencies have to be installed:

General dependencies

- Python 2.6 (
- lxml, to read and write XML files. (
- Mako, to generate help files. (
- PyYaml, for help files and the build system. (
- Nose, to run unit tests. (

OS X prerequisites

- XCode 3.1 (
- Sparkle (
- PyObjC 2.2. (
- py2app (

Windows prerequisites

- Visual Studio 2008 (Express is enough) is needed to build C extensions. (
- PyQt 4.6 (
- Python Imaging Library for dupeGuru PE. (
- PyInstaller, if you want to build a exe. You don't need it if you just want to run dupeGuru. (
- Advanced Installer, if you want to build the installer file. (

Building dupeGuru

First, make sure you meet the dependencies listed in the section above. Then you need to configure your build with:

If you want, you can specify a UI to use with the `--ui` option. So, if you want to build dupeGuru with Qt on OS X, then you have to type `python --ui=qt`. You can also use the `--dev` flag to indicate a dev build (it will build `dg_cocoa.plugin` in alias mode and use the "dev" config in XCode).

Then, just build the thing and then run it with:


If you want to create ready-to-upload package, run:


64-bit on OS X

The "release" configuration of dupeGuru's XCode project build with archs "i386 x86_64 ppc". However there are currently problems with py2app and 64 bit. If you want to correctly build 64-bit apps, refer to .