WinRun4j is a java launcher for windows. It is an alternative to javaw.exe and provides the following benefits:

• Uses an INI file for specifying classpath, main class, vm args, program args.
• Custom executable name that appears in task manager.
• Additional JVM args for more flexible memory use.
• Built-in icon replacer for custom icon.
• Pre-JVM splash screen with auto-hide.
• DDE implementation for file assocations.
• Windows NT Service wrapper.
• Windows EventLog API
• Console version
• JNI library for INI access, splash screen, logger, registry, shell.
• Support for 64-bit JVM.
• Supports embedding (inside the executable) the INI file. See Embedded Resources section below.
• Supports embedding a splash image.
• Supports embedding JAR files. These will be included in the classpath (without extraction). This is currently BETA quality.
• Eclipse Plugin for integrated launching, debugging and exporting as an executable bundle.

WinRun4J is licensed under the Common Public License (CPL).

The latest download is available from the Project Page.

The latest version of the Eclipse Plugin for WinRun4J can be downloaded from within Eclipse using the following Update URL:

http://winrun4j.sourceforge.net/

The launcher is designed to be used as follows:

1. Copy WinRun4J.exe to [YourApp].exe
2. Create [YourApp].ini (in the same directory)
3. Customize [YourApp].ini (see the table below for information)
4. Create [YourApp].ico (in the same directory)
5. Run RCEDIT.exe /I [YourApp].exe [YourApp].ico (this will inject your icon into the executable).
6. Launch [YourApp].exe

The INI file accepts the following settings:

Key	Description
working.directory	This will be the current directory for the app. It can be relative to your executable.
classpath.1, classpath.2, ..., classpath.n	Classpath entries. These will be relative to the working directory above. They can be wildcards (eg. *.jar)
main.class	This is the java class that will be run
vmarg.1, vmarg.2, ..., vmarg.n	Java VM args. These will be passed on to the VM.
vm.version.max	The maximum allowed version (1.0, 1.1, 1.2, 1.3, 1.4, 1.5).
vm.version.min	The minimum allowed version (1.0, 1.1, 1.2, 1.3, 1.4, 1.5).
vm.version	Specify an exact version to use (eg. 1.5.0_07).
vm.location	Specify the location of the JVM dll you want to use. This is useful when you package your own JRE with your app.
vm.heapsize.max.percent	Specify a proportion of the available physical memory to use (ie. relates to -Xmx arg). For example, vm.heapsize.max.percent=75. Note that this will use the maximum memory possible.
vm.heapsize.min.percent	Specify a proportion of the available physical memory to use as the minimum starting heap size (ie. relates to -Xms arg).
vm.heapsize.preferred	Specify a preferred amount (in MB) for the heap size (ie. relates to -Xmx arg). If this amount is not available it will use the maximum amount possible given the physical memory available.
arg.1, arg.2, ..., arg.n	Program arguments. These will be sent before any command line arguments.
log	Standard out and error streams will be redirected to this file (including launcher messages and JNI logging).
log.level	Specify the logging level. One of "info", "warning", "error", "none". Default is "info".
log.overwrite	Set to "true" to cause the log file to be overwritten each time the application/service is launched.
log.file.and.console	Set to "true" to output to the console and the log file (if present). Note: this only applies to WinRun4J log messages and Java logging using the Log class.
log.roll.size	A decimal value in megabytes for the max log size before rolling. Old logs are moved to logname-[timestamp].extension.
log.roll.prefix	Customizes the rolled log file prefix to [prefix]-[timestamp].extension
log.roll.suffix	Customizes the rolled log file suffix to [prefix]-[timestamp][suffix]
splash.image	The name of the splash image file to display (This can be gif, jpg or bmp). This will auto-hide itself when it detects the first application window.
splash.autohide	A flag to disable the splash screen autohide feature ("true").
dde.enabled	This flag needs to be set to "true" to enable DDE.
dde.class	Optional flag to send execute commands to your class.
dde.server.name, dde.topic, dde.window.class	Override the DDE server name, topic and window class.
single.instance	This will detect another instance of the application running and will shutdown if one is found. It takes the following options: "process", this will simply detect if a process for the same executable is present and shutdown. "window", this will detect if a process for the same executable is present and if there is a visible window - if this is the case it will set the window to the front and then shutdown. "dde", this will simply detect if a process for the same executable and if dde is enabled it will fire a dde activation call (and then shutdown), which can be picked up by the other process. If dde is not enabled it will simply defer to the "window" method.
process.priority	This is can be one of "idle", "below_normal", "normal", "above_normal", "high", "realtime".
service.class	This is the java class that will be run (for a service)
service.id	This is the ID of the service (used for registration)
service.name	The name of the service. This will appear in the service control panel.
service.description	The description on the service. This will appear in the service control panel.
service.controls	The control commands accepted by the service. This can one or multiple of "stop", "shutdown", "pause", "param", "netbind", "hardward", "power", "session". For multiple simply OR together (eg. service.controls=stop|shutdown). The default is "stop|shutdown".
service.startup	Can be one of "auto", "boot", "demand", "disabled", "system". The default is "demand"
service.dependency.1, service.dependency.2, ....	Specifies a set of services that this service depends on.
service.loadordergroup	Specifies the service's load order group.
service.user	Specifies the account to run the service under.
service.password	Specifies the password for the user account.

Error messages emitted by the launcher can be customized via the INI file. These can be placed in an "[ErrorMessages]" section:

Key	Description
java.not.found	This message will be displayed as a message box popup when the launcher cannot find an appropriate JVM to load.
java.failed	This message will be displayed as a message box popup when the JVM fails to startup, for example if invalid VM args are entered in the INI file

[ErrorMessages]
java.not.found=A suitable version of Java could not be found on your system. Please contact VendorX.
java.failed=Java failed to startup successfully. Please contact VendorX.
		

The following shows the help information for RCEDIT, the resource editor included in the download:

WinRun4J Resource Editor v1.0 (winrun4j.sf.net)

Edits resources in executables (EXE) and dynamic link-libraries (DLL).

RCEDIT <option> <exe/dll> [resource]

  filename      Specifies the filename of the EXE/DLL.
  resource      Specifies the name of the resource to add to the EXE/DLL.
  /I            Set the icon as the default icon for the executable.
  /A            Adds an icon to the EXE/DLL.
  /N            Sets the INI file.
  /J            Adds a JAR file.
  /E            Extracts a JAR file from the EXE/DLL.
  /S            Sets the splash image.
  /C            Clears all resources from the EXE/DLL.
  /L            Lists the resources in the EXE/DLL.
  /P            Outputs the contents of the INI file in the EXE.

Note:

• The embedded INI entries are overwridden by an external INI file (if present).
• Any JARs added to the executable will automatically be added to the classpath (before all classpath entries specified in the INI file and in the order in which they are embedded). They don't need to be specified in the INI file.
• If an embedded splash image is present it will automatically appear (it doesn't need to be specified in the INI file).

The javadoc for the JNI library can be found here.

An example INI file (included in the download) is:

classpath.1=*.jar
main.class=org.boris.winrun4j.WinRunTest

An example INI file to run eclipse is:

working.directory=.
main.class=org.eclipse.equinox.launcher.Main
classpath.1=plugins\org.eclipse.equinox.launcher*
arg.1=-showsplash				
vm.heapsize.percent=80

The download includes an alternative launcher for Eclipse that enables DDE. This allows the user to double-click on a java file in Windows explorer and have the file open in the currently opened workspace.

To setup this example:

1. In your eclipse directory rename eclipse.exe to eclipse.exe.old and rename eclipse.ini to eclipse.ini.old.
2. Copy WinRun4J.exe, EcliseDDE.jar, eclipse.ico and eclipse.ini from to downloaded zip file to your eclipse directory.
3. Rename WinRun4J.exe to eclipse.exe.
4. Run RCEDIT.exe /I eclipse.exe eclipse.ico. This will change the exectable icon to the eclipse icon.
5. Run eclipse.exe --WinRun4J:RegisterFileAssociations. This will register java files to be associated with eclipse.

You should now be able to double-click on java files in Windows.

The following shows the INI file setup:

working.directory=.
main.class=org.boris.winrun4j.EclipseDDE
classpath.1=EclipseDDE.jar
classpath.2=plugins\org.eclipse.equinox.launcher*
vmarg.1=-Xmx512M
vmarg.2=-XX:MaxPermSpace=256M
arg.1=-showsplash
dde.enabled=true
dde.class=org.boris.winrun4j.EclipseDDE

[FileAssociations]
file.1.extension=.java
file.1.name=EclipseJavaFile
file.1.description=Java Source File

The download contains a simple example of a windows service. Its only function is to log to the Windows Event Log every five minutes. To run the example:

1. Create a test directory C:/test.
2. Copy WinRun4Jc.exe to C:/test and rename to service.exe.
3. Copy service.ini to C:/test.
4. Copy WinRun4JTest.jar to C:/test.
5. Run service.exe --WinRun4J:RegisterService.
6. To start/stop the service use the control panel services console (The service name will be "WinRun4J Test Service")
7. To unregister run service.exe --WinRun4J:UnregisterService.

The following shows the included example of a basic Service implementation.

package org.boris.winrun4j.test;

import org.boris.winrun4j.AbstractService;
import org.boris.winrun4j.EventLog;
import org.boris.winrun4j.ServiceException;

/**
 * A basic service.
 */
public class ServiceTest extends AbstractService
{
    public int serviceMain(String[] args) throws ServiceException {
        int count = 0;
        while (!shutdown) {
            try {
                Thread.sleep(6000);
            } catch (InterruptedException e) {
            }

            if (++count % 10 == 0)
                EventLog.report("WinRun4J Test Service", EventLog.INFORMATION, "Ping");
        }

        return 0;
    }
}

The INI file for this service looks like this:

service.class=org.boris.winrun4j.test.ServiceTest
service.id=ServiceTest
service.name=WinRun4J Test Service
service.description=An example service using WinRun4J.

classpath.1=*.jar

vmarg.1=-Xdebug
vmarg.2=-Xnoagent
vmarg.3=-Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n

V0.3.3

• Moved service name, description and controls accepted to INI file
• Refactored Service interface and added AbstractService helper class
• Implemented FileAssociations helper class
• Greatly improved the Registry API
• Option to log to console and file
• Log file rolling
• Fix for relative log file path

V0.3.2

• Implemented --WinRun4J:ExecuteINI built-in command - allows the launcher to execute abitrary INI files
• Fix for splash.autohide enable/disable option.
• Fix for service startup args
• Fix for dde activate thread hang

V0.3.1

• Fixes an issue with embedded splash screens.

V0.3

• Added log.overwrite option for log files
• Fixed log file logging
• Added process.priority option to set process priority on startup
• Fixed shutdown bug on service mode
• Added ability to write text to splash screen
• Fixes for splash screen loading in 64 bit mode
• Improved window attributes on splash screen
• Further improvements to diagnostics

V0.2

• Support embedding of INI, splash and JAR files.
• Improvements to logging output format.
• Fixes for runtime library dependencies.
• Improved handling of exceptions on startup and exit.
• Built-in Icon changer moved to separate executable.
• 64-Bit console version.

Older Change History

You can find a blog about this launcher, with more information and tips at Boris Inc.

• Peter Smith
• Karl von Randow
• AquaFold, launcher used in Aqua Data Studio.
• Frederic Canut