Portable CDex Launcher 0.4.1.4
============================
Written Tuxmouraille

Website: http://wiki.framasoft.info/Portables


ABOUT PORTABLE CDex
===================
The Portable CDex Launcher allows you to run CDex from a removable drive whose letter changes as you move it to another computer.  The program can be entirely self-contained on the drive and then used on any Windows computer.
In this new version you can recompil it with easily choosing your own "My documents" and "My music" names, with changing MYMUSICDIRECTORY and MYDOCUMENTSDIRECTORY !define entries.

LICENSE
=======
This code is released under the GPL.  The full code is included with this package as PortableCDex.nsi.


INSTALLATION / DIRECTORY STRUCTURE
==================================
By default, the program expects one of 5 directory structures:

-\ <--- Directory with PortableCDex.exe
  +\CDex\
  +\Ma musique\

OR

-\ <--- Directory with PortableCDex.exe
  +\PortableCDex\
    +\CDex\
    +\Ma musique\

OR

-\ <--- Directory with PortableCDex.exe
  +\PortableApps\
    +\PortableCDex\
      +\CDex\
      +\Ma musique\

OR

-\ <--- Directory with PortableCDex.exe (PortableApps, for instance)
  +\Apps\
    +\PortableCDex\
      +\CDex\
  +\Data\
    +\Ma musique\

OR

-\ <--- Directory with PortableCDex.exe (PortableApps, for instance)
  +\Apps\
    +\PortableCDex\
      +\CDex\
  +\Data\
    +\UserProfile\
       +\Mes documents\
          +\Ma musique\

OR

-\ <--- Directory with PortableCDex.exe (PortableApps, for instance)
  +\Apps\
    +\PortableCDex\
      +\CDex\
  +\Data\
    +\UserProfile\
       +\MyMusicDirectory=\  <-- here you can choose your documents directory name with your, see bottom on MyMusic.ini section for more explanation


Note: In the last scenario, either UserProfile and his subdirectories may be shared with other applications.

It can be used in other directory configurations by including the PortableCDex.ini file in the same directory as PortableCDex.exe and configuring it as details in the INI file section below.  The INI file may also be placed in a subdirectory of the directory containing PortableCDex.exe called PortableCDex  or 2 directories deep in PortableApps\PortableCDex or Data\PortableCDex.  All paths in the INI should remain relative to the EXE and not the INI.


PORTABLECDex.INI CONFIGURATION
==============================
The Portable CDex Launcher will look for an ini file called PortableCDex.ini within its directory.  If you are happy with the default options, it is not necessary, though.  The INI file is formatted as follows:

[PortableCDex]
CDexDirectory=CDex
MyMusicDirectory=
AdditionalParameters=
WaitForCDex=false
CDexExecutable=CDex.exe
DisableSplashScreen=false


The CDexDirectory and MyMusicDirectory entries should be set to the *relative* path to the appropriate directories from the current directory.  All must be a subdirectory (or multiple subdirectories) of the directory containing PortableCDex.exe.  The default entries for these are described in the installation section above.

The AdditionalParameters entry allows you to pass additional commandline parameter entries to CDex.exe.  Whatever you enter here will be appended to the call to CDex.exe.

The WaitForCDex entry allows you to set the Portable CDex Launcher to wait for CDex to close before it closes.  This option is mainly of use when PortableCDex.exe is called by another program that awaits it's conclusion to perform a task.

The CDexExecutable entry allows you to set the Portable CDex Launcher to use an alternate EXE call to launch CDex.  This is helpful if you are using a machine that is set to deny CDex.exe from running.  You'll need to rename the CDex.exe file and then enter the name you gave it on the CDexexecutable= line of the INI.

The DisableSplashScreen entry allows you to disable the splash screen by setting it to true (lowercase).


MyMusic.INI explanation:
=======================

[MusicMyMusic]
MyMusicDirectory=

To use the ini file you must put it in the same directory like PortableCDex.exe.
The MyMusicDirectory entry should be set o the *relative* path to the appropriate directories from the current directory.   All must be a subdirectory (or multiple subdirectories) of the directory containing PortableCDex.exe.  The default entries for these are described in the installation section above.
You can choose his name with using PortableCDex.ini, like that if you use the sixth sstructure:

[MyMusic]
MyMusicDirectory=XXX

equivalent to:

-\ <--- Directory with PortableCDex.exe (PortableApps, for instance)
  +\Apps\
    +\PortableCDex\
      +\CDex\
  +\Data\
    +\UserProfile\
       +\XXX\
          +\My Music\


or like that, if you want to choose all locations entries:

[MyMusic]
MyMusicDirectory=Data\XXX

equivalent to :

-\ <--- Directory with PortableCDex.exe
   +\Data\
      +\XXX\


When you use the fifth directory structure (only when windows language is french) or sixth directory structure, with choosing to use the default windows language translation of "My document".
You will have a PortableCDex more intégrated in windows, explanation is this; when you want to open something with CDex and you choose "My Music" (or translation) it will open you MyMusicDirectory on your Drive and the "My Music" directory on local machine.
Conclusion, it's fun ;-)