Win96 Run Time

Win96 Run Time, sometimes abbreviated as WRT, is the runtime behind the Windows 96 binaries.

Features

A script executed with the WRT will behave differently than a normal script. Firstly, this script will be able to use FS, FSUtil, WApplication, StandardWindow, registerApp and deregisterApp without having to use the w96 namespace before. these script will also be able to use the WRT module API where the module object is available for exporting data and include for getting module exported data. Scripts executed with the WRT will also be executed in an asyncronous context, so it is possible to use top-level await.

Usage

To execute a script using the WRT, there are 2 options:

• Start the script with the following shebang: //!wrt
• Run the wrtrun command with the path to the script

History

The Windows Runtime was introduced in Windows 96 v2 Service Pack 2.

"A set of APIs which allow you to easily make apps and include modules, without worrying about the filesystem and stuff like that." Windows 96 devs in the rel2sp2 changelog.

Shebang

The shebang is the first line of a binary. The WRT shebang starts with //!wrt. The shebang denotes that this regular file is a WRT bin, and must be the very first line in any WRT application.

The binary specification (BSPEC)

The binary specification (BSPEC) is a way to describe metadata for a WRT bin. It always follows the shebang on the same line, where the cumulative line size must not exceed 256 characters.

The BSPEC is a simple JSON object prefixed with $BSPEC: and contains the following fields:

• icn - The name of the icon to use.
• cpr - The copyright holder of the application.
• dsc - A basic description of the application.
• frn - The display name of the application.
• aut - The application author.
• ssy - The subsystem to use for this application. Can either be gui or cli.
• ver - The version of the application.

Below is an example of a binary specification declaration for the File Explorer application.

//!wrt $BSPEC:{"icn":"apps/explorer","cpr":"Copyright (C) Windows 96 Team 2021.","dsc":"System File Explorer","frn":"Explorer","ver":1}