Skip to content

RDP Wrapper Auto-Update Script #3879

Description

@ricardo404

This project contains a set of scripts to automate the process of updating RDP Wrapper offsets every time a Windows Update breaks its functionality.

Motivation

This script was created out of personal necessity. With each new Windows security update, the termsrv.dll file is modified, which invalidates the offsets in the rdpwrap.ini file. The manual process of stopping the service, running RDPWrapOffsetFinder, copying and pasting the new values into the .ini file, and restarting the service was repetitive.

The goal of this script is to turn this entire process into a single-click task.

How It Works

The script automates the following steps:

  1. Stops the Remote Desktop Services (TermService).
  2. Executes RDPWrapOffsetFinder.exe to get the new offsets for the current system version.
  3. Parses the program's text output.
  4. Safely appends the new configuration sections (offsets and SLInit) to the end of the rdpwrap.ini file.
  5. Starts the TermService again.

⚠️ Important Disclaimer

  • Tested System: This script was developed and tested on Windows 11 Home Edition (64-bit), build 10.0.26100.6899.
  • Compatibility: While it should work on other Windows versions (10/11) and builds, it has not been formally tested. Use at your own risk.
  • Backup: The script automatically creates a timestamped backup of your rdpwrap.ini file before making any changes.

How to Use

There are two ways to use this solution:

Option 1: Complete Folder (Recommended)

RDP Wrapper.zip

  1. Download the complete ZIP file from this repository.
  2. Extract the folder to any location on your computer (e.g., C:\Tools\RDPWrap).
  3. After a Windows Update breaks RDP Wrapper, navigate to the folder, right-click on "Update RDP Wrapper Offsets.bat", and select "Run as administrator".

Option 2: Manual Install**

If you already have an RDP Wrapper folder set up:

Script Only.zip

  1. Download the ZIP containing only the two script files (Update RDP Wrapper Offsets.bat and Update-RDPWrap.ps1).
  2. Drag and drop these two files into your main RDP Wrapper folder.
  3. Important: Ensure that the RDPWrapOffsetFinder files are also located in this same folder.
Image
  1. Run Update RDP Wrapper Offsets.bat as administrator whenever an update is needed.

A Note on Development

This script was developed with AI assistance to accelerate the creation of the text-parsing logic in PowerShell. It is an open-source project and can be freely modified, improved, and expanded by the community.

Credits & Resources

This solution is only possible thanks to the RDPWrapOffsetFinder tool. If you need a newer version or a 32-bit version, you can find it at its official repository:

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions