KAPE Builder Reference

Introduction

KAPE has been designed to simplify and automate the manual process of building WinPE environments. The normal process of managing a WinPE environment generally requires the use of scripts and utilities such as copype.cmd, peimg.exe, dism.exe, imageX, among others. KAPE helps to simplify this process by automating these steps within a standard GUI to create the WinPE project, mount the .wim file, add packages and drivers, and even create the final ISO file.

Project Based

KAPE manages each separate WinPE environment as a project. When a new KAPE project is started, a new folder will be created (named after the project name), and all necessary files and folders will be established in this folder, including the iso folder containing the standard WinPE files.

Please note, KAPE will utilize a single Wim file for the entire project, and is located at project_folder\working\ISO\sources\boot.wim.

Installation

No installation is required. Simply unzip the contents of the zip file into a new folder, and double-click kape.exe to start building your first project. KAPE maintains all configuration options in a single text file named kape.app, stored in the same folder as the executable. Additionally, several sub-folders will be created to manage projects, ISO files, and pre-built WIM files to simplify future projects.

Initialization

The first time KAPE is run, a preferences window will be displayed requesting the configuration of the following settings:

  • Auto open last project at program start
  • Auto mount the WIM file when the project opens
  • Default KAPE project folder- Default location to create new projects. This location is also used to list existing projects when opening or deleting projects.
  • Default ISO folder- Default folder in which to create new ISO files.
  • Default WIM location- Specifies a folder which may contain pre-configured custom WIM files. When creating a new project from an existing WIM, KAPE will default to this folder for the custom files.
  • Windows AIK location- The folder where the WAIK is installed. This location will be auto-detected.

New Project

Upon selecting a new project, the following options are presented:

  • Project name- A unique name by which to identify this project.
  • Project folder- The complete path to the folder specified for the project. A default folder will be specified based on the default project folder and project name, but this location can be changed. The specified folder will be created.
  • Platform- Specifies whether to create a 32 or 64 bit project
  • Custom WIM- By default, a standard WinPE Wim file will be utilized for the new project. By checking this box and selecting an existing wim file, KAPE will use the custom wim file instead.
Once the Create button is clicked, the project folder will be created, the project files will be copied or created in this folder, and the Wim file will be automatically mounted.

Project Options

  • Packages- Allows for the installation of one or more of the following packages: HTA, MDAC, WSH, WMI, XML, ImageX
  • Drivers- Provides for the installation of a single, or multiple Windows drivers into the WinPE environment. A history of installed drivers is maintained in Default Project Folder\misc\driverlist.txt.
  • Boot Info- Press any key boot prompt, CD volume label
  • Config Files- Enables direct editing of basic configuration files, such as startnet.cmd and winpeshl.ini.
  • Execute- Provides user configurable task execution in the following instances: after the Wim file is dismounted, directly before the ISO is created, and after the ISO is created.
  • Background- Allows for the selection of a custom background in the WinPE environment

Menu/Toolbar Items

  • Open Project- Lists the existing projects under the Default Project Folder, and allows the user to select and open an existing project.
  • Create ISO- Creates an ISO file from the currently loaded project. Any mounted WIM file will be automatically unmounted before creating the ISO. The ISO file will be saved in the Default ISO location, and will be named after the project.
  • Project Folder- Opens Windows Explorer and lists the folder associated with the project.

Folder Structure

The following folder structure is created for each KAPE project:
-Working
  - ISO - The standard WinPE ISO folder containing boot, sources, etc.
  - Mount - The files/folders in the Wim file will be avaialble when mounted
-Log - All log files will be stored in this folder
-Misc - Stores persistent files required for project management.
-Temp - Used for temp files, specifically for temporary mount files

Requirements

  • KAPE supports operating under all Windows operating systems starting with Windows XP.
  • All versions of the Windows AIK are supported, including Windows Vista/2008 and Window 7 versions.

Troubleshooting

For difficulties or problems with KAPE, please visit the KAPE support page for common problems, or you may contact us, including as much information as possible, such as:

  • Operating system under which you are running KAPE, eg. Windows XP SP2
  • Specific version of the Windows AIK
  • Process being attempted when the problem occurred
  • Any error messages displayed by KAPE