Instructions for building ExQueues Shell Queue GPL by Slain Jamison Wilde

A number of other GPL, Public Domain, and other open license software are included in the source folders themselves. Special thanks go out to Bjarke Viksoe (viksoe.dk) for all of his WTL examples and classes/widgets, many of which are used in their original forms or were modified by me to provide the functionality needed by ExQueues. Also special thanks to Kristen Wegner for creating pugxml, the Pug XML Parser, and to Neville Franks for maintaining and enhancing it. I use a simplified memory management version of pugxml I created in this application, so don't blame them if your mileage and in particular performance with my version varies. I am using modified versions of some of the Azureus toolbar icons (drop shadows added, some color alterations, and alpha channel added), which I hope isn't a problem with the Azureus developers/designers, since these icons seemed like the perfect starting point for queue icons.

3rd Party Software Requirements (not included):

***********************************************

• Subversion (SVN) client using (recommended) TortoiseSVN at http://tortoisesvn.tigris.org/
• Microsoft Visual Studio 2003
• Windows Template Library (WTL) 7.5 or newer at http://sourceforge.net/projects/wtl
• Votive & Windows Installer XML SDK(Votive & WiX) at http://sourceforge.net/projects/wix You only need to download and install Votive, as it contains the WiX SDK.
• UnRarDLL Header and Dynamic Link Library at http://www.rarlab.com/rar/unrardll.exe Optional:
• UnAceDLL (not yet supported, and has weird licensing so that the headers cannot be included in SVN)

After installing the software listed above:

*******************************************

• Use TortoiseSVN to checkout the ExQueues source code. Right Click in the location you wish the project to be located, and choose SVN Checkout. https://svn.sourceforge.net/svnroot/shellqueue is the repository url. See the sourceforge Subversion instructions for further information.
• Add the WTL include directory path to the Visual Studio VC include directories list. (Tools->Options->Projects->VC++ Directories)
• Create a directory called exqueues/bin (in the same folder level as exqueues/src). Copy unrar.dll to that folder. Copy the latest unrar.h into the exqueues/src/common folder.

Finally:

********

• Build the ExQueues project.
• In the exqueues/src/ExQueues directory, using a command prompt, run 'nmake ExQueuesps.mk'. This will create the proxy/stub DLL for interprocess COM (used by ExQueues to handle dynamic context menu generation). Copy the resulting 'ExQueuesps.dll' to the bin directory. Run 'regsrv32 ...\exqueues\bin\ExQueuesps.dll' (replacing ... with your location) to register the proxy/stub DLL. This should only be done once, unless you change the ExQueues IDL for the CXQMenuServer class.
• Build the XQContextMenu project. Please note that building XQContextMenu.dll registers the shell extension, and terminates the Desktop Explorer for debugging purposes. Use Task Manager to restart explorer, which will include the newly created shell extension. You may comment out this Explorer-killing code in XQContextExt.cpp->DLLRegisterServer() at the PostMessage() line.

Special Debugging Information:

******************************

To debug the XQContextMenu shell extension, after having registered the DLL (automatically when building) and restarting explorer, you may run the extension in the debugger, which will launch a new Explorer window. To get breakpoints to work properly, it is probably a good idea to add a breakpoint in XQContext.cpp to the DLLGetClassObject function. You then simply right click on an appropriate file in explorer and begin debugging.

Special Directory Opus Instructions:

************************************

If you are using Directory Opus for drag and drop support (highly recommended), or some other DDE enabled application, you need to add some additional settings to DOpus.

I use shift-drag and drop to queue actions in ExQueues. You may choose some other method, such as ctrl-drag and drop. In DOpus, under Settings->File Types->All Files and FolderS, select 'dropshift' and press [Edit]. Replace the existing information with the following (replacing with your actual installation destination if necessary, patrticularly if debugging):

ddeexec [queue( {destpath} {allfilepath} )]
ddeapp EXQUEUES
ddetopic ExQueues
"c:\Program Files\ExQueues\ExQueues.exe" /dde