The K-Meleon CD Browser "Kit"

This is the orignal CD Kit that resided at the now defunct: http://www.theopencd.net/~baavgai/kit/index.html. An updated version is planned. Stay tuned.

TheOpenCD is planing to make it's next CD Browser K-Meleon based. This currently involves some custom settings and custom programs. This is my attempt to document all the pieces required to make this work.

Changes Applied

profile

The browser's default/profile directory is where much custom setup is done.

It should be noted that a created profile stores absolute paths in the configuration. This is useless for a distribution whose paths are dynamic. The solution is to create an empty profile directory and point the browser at it at startup. At that point, the default profile will be used.

These files are all modified and they are the only ones included in the default profile: accel.cfg, macros.cfg, menus.cfg, mimeTypes.rdf, Prefs.js. Most of these files are stripped down, except for mimeTypes.rdf which is modified for custom program launch.

docshell.dll

This library resides in the components directory of the browser. It allows programs associated in mimeTypes.rdf to exist in relative paths. This is vital for a CD distribution to work.

Christian Biesinger (a.k.a. biesi) kindly provided this modified version.

Launch.exe

This program executes commands stored in standard .INI files.

In mimeTypes.rdf, Launch.exe is associated with .lch files. This allows the browser to execute local files.

This file must reside in the browser root.

The ini files for this program use the following format.

[Launch]
ExecuteFile=${cwd}\..\..\programs\install\setup_abiword.exe ; The fully qualified program to run
ExecuteParameters= ; Extra command line information, if there is any.
ExecuteDirectory= ; executing program home, no need to set unless different than program itself.
ShowCommand=0 ; for diagnostics only, displays internal variables

Start.exe

The is the startup program for the CD root. It uses the start.ini file an also creates a default profile in the user's temporary folder.

[Start]
BrowserFile=${cwd}\bin\K-Meleon\k-meleon.exe ; The browser program
PageFile=${cwd}\programs\${langalias}\menu.xml ; the startup page
PageFileDefault=${cwd}\programs\fr\menu.xml ; the startup page if requested page not found
ShowCommand=0 ; for diagnostics only, displays internal variables

Launch.exe and Start.exe Tokenizer

Both these programs allow some system values to be replaced in text at runtime. This is a list of those values:

${cwd}

The complete home path of the Launch.exe program.

${drive}

The single drive letter from ${cwd}.

${inipath}

The path of to the current .ini file.

${langid}

The international language identification for current OS. (e.g. ENU, FRA)

${langalias}

The two letter ISO language code based on ${langid}. (e.g. ENU=en, FRA=fr, FRC=fr)

Download

Download the file

Contains, Launch.exe and Start.exe with source, default K-Meleon profiles, and docshell.dll.