Unzip the RAPR binary in to any folder.
RAPR interacts with Windows “driver store”. Under Windows Vista+, this needs ADMIN rights. RAPR can be started in ADMIN mode in 2 ways:
Right click on RAPR.exe and choose “Run as Administrator”
- Open a CMD prompt in ADMIN mode (by right clicking on CMD and choosing “Run ad Administrator”)
- In the cmd prompt, go to the folder where RAPR.exe is stored. Start RAPR by typing “rapr.exe” in the cmd prompt.
Note that, RAPR can be started in non-admin mode too. In non-admin mode, it allows you to only “Enumerate” the driver store. It disables all the other features and shows the following popup.
Understanding the UI capabilities:
RAPR updates the last action result in the status bar. Messages are color coded, as shown below. Info messages don’t have any color.
The header fields can be rearranged. Note that the header field positions are not persisted across runs. They always start at their default position.
You can choose the header fields shown by RAPR. Right-click on the header control (any field name) to open up the customization menu.
You can sort on any field by clicking on the corresponding header field.
For “Delete” operations, RAPR allows you to choose more than one driver package in the main window. Select the checkbox next to each driver entry that you want to be deleted.
Right clicking on the driver entries list to bring up a menu where you can either select all the entries or unselect all the entries.
RAPR shows a progress bar in the main window, when it is performing a time-intensive background operation (like “addition of a driver package”). This is not visible when RAPR is idle.
This is the default screen, when you invoke RAPR. Note that some of the screen shots used below were taken using RAPR 0.1, but the same UI components are present in RAPR 0.5 too (albeit with some minor cosmetic changes)
Click on “Enumerate” to load the current driver store entries.
Adding a Driver Package:
First step is to assemble your driver package. Usually the driver package will have the SYS file, INF, CAT and any co-installer DLLs & other EXE utils (for use by the co-installer). Make sure you have all these in the same folder.
Click on “Add a driver” in RAPR ["Add package" in RAPR 0.5]. This opens up the “Select the INF” dialog box. Browse to your package folder and choose the INF.
Note that the above step only adds the selected driver package to the driver store (this process is called “staging”).
To install the driver (for ex, if your driver package has a non-pnp component), select the “Install” checkbox ["Install driver" in RAPR 0.5] before clicking on “Add a driver” ["Add package" for RAPR 0.5]. RAPR
will add and install in this case.
Deleting driver package(s):
Select one or more packages listed. Click on “Delete” ["Delete package" for RAPR 0.5] to remove those packages.
If RAPR couldn’t delete the package(s), it will throw an error dialog (like shown above). Usually the status bar will have more details.
You can retry deleting that package, by “forcing” deletion. Select the check box “Force deletion” before clicking on “Delete”.
Exporting the drivers list:
RAPR supports exporting the driver store entries to CSV. Right click on the drivers list to open the context menu. Choose "Export". You need to provide a filename for the CSV output.
Debugging RAPR failures:
RAPR produces a log of all its operations. This is stored in “debug.log”. You can find this file in the same folder as RAPR.exe (provided RAPR has WRITE access to that folder).