installer-brand.nsi is the main installation file.
Most of branding options (like application name, skin, codecs order etc) are specified inside this file.
This is a regular text file. You can open it with the help of any text editor, for example:
- Notepad (available on Windows)
- Notepad++ (http://notepad-plus.sourceforge.net). This editor has syntax highlighting. Highly recommeded.
- HM NIS EDIT (http://hmne.sourceforge.net). This editor has syntax highlighting. It is included into Brand Builder bundle (see directory Tools\NSIS\Bin\NISEdit).
Open installer-brand.nsi file in any text editor and edit appropriate values.
This file has a special format (NSIS), which is described in details on an official web-site (http://nsis.sourceforge.net). Fortunately, you will change only a few things, which are very straightforward, so you don't need to learn the format in details.
An example of this file is shown on a screen-shot below:
Important for Windows 7 and Vista users!
If you have Windows 7 and Vista and install Brand Builder into C:\Program Files directory, then you will have to start text editor As Administrator (click on text editor icon with right mouse click and choose from menu "Run As Adminstrator"). Otherwise it will not be possible to save your changes in the file. By default Windows 7 and Vista doesn't allow to change files inside "Program Files" directory for regular users.
As an option, you can install Brand Builder to other direcory, for example, "C:\Brand Builder". In this case the mentioned restrictions will not apply to that directory. You can edit file without admin rights.
Format of installer-brand.nsi file
There is a number of configurable parameters, which are possible to change.
Each parameter formatted in following manner:
!define <VARIABLE-NAME> <VALUE>
For example:
!define PRODUCT_NAME "MiaPhone"
where:
PRODUCT_NAME is a variable name;
"MiaPhone" is a value of variable.
Most of variables are strings, so they are double-quoted.
Some of variables are integers, like:
!define SHOW_APP_TITLE 1
!define SIP_REGISTRAR_PORT 5060
Some of configurable parameters have boolean meaning (TRUE or FALSE).
In this case 1 means TRUE and 0 means FALSE.
For example:
!define SHOW_APP_TITLE 1
... means "Show application title".
!define SHOW_APP_TITLE 0
... means "Do not show application title"
The installation script contains comments with description for amost every configuraiton parameter.
Also, you can check this document for the detailed explanation of a meaning of each parameter.
If the string starts with semicolon (;) or hash (#) symbols, then the whole string is interpreted as a comment.
This means that such string is ignored during building of the installation distributive.
Examples of comment:
; !define SHOW_APP_TITLE 1
# !define SHOW_APP_TITLE 1