DSOAL_Alchemy

Recreate in powershell the creative alchemy application but for usage with DSOAL (https://github.com/kcat/dsoal). French and English version avalaible.

What is different from creative alchemy ?

   *  Registry path are checked in both X86 and X86-64 path.
   *  Install dsoal.dll and dsoal-aldrv.dll to game folder detected.
   *  Support for x64 Wrapper and drivers

Prerequesites

DSOAL : https://github.com/kcat/dsoal binaries.

Installation

• Copy the script dsoal_alchemy.ps1 and language (culture) folder into a folder of your choise.
• Download dsoal (https://github.com/kcat/dsoal)
• Copy the dsound.dll 64bits version of the DSOAL wrapper into the X86-64 folder
• Copy the dsound.dll 32bits version of theDSOAL wrapper into the X86 folder
• Copy the dsoal-aldrv.dll 64bits version of the DSOAL wrapper into the X86-64 folder
• Copy the dsoal-aldrv.dll 32bits version of the DSOAL wrapper into the X86 folder

A Correct installation should look like this

DSOAL_Alchemy-main
    |
    |--dsoal_alchemy.ps1        the script itself
    |--Games.template           Default gamelist use to generate the dsoal_alchemy.ini gamelist, if creative alchemy is not installed.
    |--dsoal_alchemy.ico        Icon file used by Gui.
    | 
    |-- en-US                   and/or any other language culture folder (fr-FR)
    |    |--dsoal_alchemy.psd1  Contains all texts related to the script
    | 
    |-- configs                 Folder where you put specific openalsoft (ini file) configurations you want to use/deploy
    |
    |-- x86-64
    |    |--dsoal-aldrv.dll     64 bits version of openal soft driver
    |    |--dsound.dll          64 bits version of dsoal
    |
    |-- x86
         |--dsoal-aldrv.dll     32 bits version of openal soft driver
         |--dsound.dll          32 bits version of dsoal

Note :

Creative alchemy and DSOAL Alchemy
If you already have creative alchemy installed, the script will automatically use your alchemy.ini to create the Dsoal_alchemy.ini gamelist.
If you don't have creative alchemy, the script will use the Games.template file to generate one.
If the games.template file is deleted, the Dsoal_alchemy.ini will be empty.

Openalsoft configurations
You can copy openalsoft configurations you want to use into the configs folder, it should be a .ini file
When the setting is selected in Dsoal_alchemy, the script will automatically copy the selected configuration as alsoft.ini into game folder(s).

launch the script

Create a shortcut with following command:

.\powershell.exe -WindowStyle Hidden -ep bypass -file "C:\XXXX\DSOAL_Alchemy-main\Dsoal_alchemy.ps1"

To remove the minimized windows behind the Gui, set in the properties of the shortcut Run=minimized

How to use

When launched, Dsoal ALchemy application will search the system for supported
DirectSound3D enabled games. All the games found will be listed in the left panel (titled "Installed Games").
The right pane (titled "DSOAL-enabled Games”) will show any games which have already been converted to use DSOAL.

• To enable DSOAL support for a particular game, select it from the left panel, and press the “>>” button.
• To undo DSOAL support, select the game from the right panel and press the “<<” button. You can select multiple games at once and then use the directional arrow buttons to update them all.

Buttons and checkbox have tooltip when you place your mouse cursor on them.

The script will create and use Dsoal_alchemy.ini to store games and options in the script folder.