Compiling WombatShare (For windows under Visual Studio)

Required 3rd party libraries

• P-Types C++ Portable Types Library
• zLib The zLib compression library

Installation instructions

• Setup a top-level folder, for ease we'll call this c:\Development

• Extract the ptypes archive into c:\development.
  This should create the folder c:\development\ptypes-xxxx

• Create a folder c:\development\zlib and extract the zlib source into here.

• Download the WombatShare source and plugins sources and extract them to c:\development
  This should create two sub-folders c:\development\WombatShare and c:\development\plugins

• Unfortunately ptypes currently has a bug in it so you'll need to browse to c:\development\ptypes-xxxx\win32\PTypes_Lib.dsp and convert this file to use dos style linefeeds'. I use UltraEdit to do this.

• zLib doesn't come with a project file suitable for use by VC. I've written a quick one that you can get from http://www.wombatinvasion.com/oss/zlib.zip

Download and extract this file and save it into c:\development\zlib

• If you're intending to build the winamp plugin you will need the Winamp 5 SDK available here(http://www.nunzioweb.com/daz/winamp/wa502_sdk.exe(approve sites)).
  Download and install somewhere sensible. For this example I'll use c:\winamp5sdk

• If you're intending to build the foobar2000 plugin you will need the foobar2000 SDK available here(http://www.foobar2000.org/0.8.1-SDK.7z).
  Download and install somewhere sensible. For this example I'll use c:\foobar2000sdk

Compilation instructions

Visual Studio Setup

Common Configuration (note this only has to be done once)

• Navigate the Visual Studio Menu, Tools->options->Directories.

• Select 'Show directories for Include Files'

• Add a directory for the WombatShare include files: "c:\development\WombatShare"

• Add a directory for the ptypes include files: "c:\development\ptypes-xxx\include"

• Add a directory for the zlib include files: "c:\development\zlib"

• Add a directory for the Winamp sdk : "c:\winampsdk"

• Add a directory for the foobar2000 sdk : "c:\foobarsdk"

Compiling the Winamp Plugin

• Load the file c:\development\plugins\winamp5\winamp5.dsw

• The first time you do this it may ask for the locations of all its dependancies you should point it to the files in the relevant directories we created earlier.

• Right click the 'winamp5' project and choose 'set as active project'

• Navigate to Build->Build ml_Wbtshare.dll

• If you get a big chunk of build errors, navigate to project->settings->C/C++ and select the "Code Generation" category.
  Make sure that for 'Use run-time library' every project in the left hand pane is set to the same option, I use 'MultiThreaded?' in Release mode and 'Debug MultiThreaded?' in debug mode.

• It should now compile correctly. Just copy the dll file into the Winamp plugins directory and startup winamp.

Compiling the foobar2000 plugin

• Load the file c:\development\plugins\foobar2000\foo_wbtshare.dsw

• The first time you do this it may ask for the locations of all its dependancies you should point it to the files in the relevant directories we created earlier.
  The foobar2000 plugin is dependant on several projects that are located in the foobar2000 SDK directory so you'll need to browse in there to find the foo_* dependancies.

• Right click the 'foo_wbtshare.dll' project and 'set as active project'

• Follow the same steps for compiling as in the winamp plugin.

• Copy the resulting dll into the foobar2000 components directory and it should all be working.

Compiling WombatShare (For Linux)

Well, there is a makefile, but its not ready yet ;) I'm trying to provide a test console app to demonstrate it.

Problems/Questions

Please send an email to JavaJunky if you have any problems/queries with regards to this issue.

Thanks.

-JavaJunky

<< | Documentation | >>