What Is RDP Wrapper Library?
RDP Wrapper Library (often called RDPWrap) is an open-source project that enables Remote Desktop Host functionality on editions of Windows that don’t natively support it—like Windows Home—and allows multiple simultaneous RDP sessions on Windows Pro and Enterprise without modifying system files.
It works by acting as a layer between the Service Control Manager and the Terminal Services service (termsrv.dll), intercepting calls and applying patches in memory rather than on disk.
Important Disclaimer
Using RDP Wrapper may conflict with Microsoft’s licensing terms for certain Windows editions. This guide is intended for homelab and educational purposes. Always review the licence agreement for your edition of Windows before proceeding.
Step 1 – Download RDP Wrapper
Head to the RDP Wrapper releases page on GitHub and download the latest RDPWrap-vX.X.zip. Extract the archive to a folder such as C:RDPWrap.
Files in the Archive
install.bat– Installs the wrapper service.uninstall.bat– Removes it cleanly.update.bat– Updates therdpwrap.iniconfiguration.RDPConf.exe– GUI tool to check status and tweak settings.RDPCheck.exe– Quick local RDP connection test.
Step 2 – Install RDP Wrapper
- Right-click
install.batand select Run as administrator. - A Command Prompt window will flash briefly as the wrapper service registers itself.
- Run
RDPConf.exeto verify the installation. You should see green [Installed], [Running], and [Listening] indicators.
Step 3 – Update rdpwrap.ini
After major Windows updates, the termsrv.dll version changes and RDP Wrapper may show [not supported] in RDPConf. To fix this:
- Download the latest
rdpwrap.inifrom the community-maintained repository at sebaxakerhtc/rdpwrap.ini. - Copy it to
C:Program FilesRDP Wrapperrdpwrap.ini, replacing the existing file. - Restart the Terminal Services service: open an elevated Command Prompt and run
net stop termservice && net start termservice. - Re-open
RDPConf.exeand confirm all indicators are green.
Step 4 – Test Multiple Sessions
Open RDPCheck.exe or use the built-in Remote Desktop Connection (mstsc.exe) from another machine to connect. While you’re logged in locally, a second user should now be able to connect via RDP simultaneously without disconnecting your session.
Troubleshooting Common Issues
“Not Supported” After a Windows Update
This is the most frequent issue. Follow Step 3 above to replace rdpwrap.ini with the latest community version. The ini file contains offsets specific to each termsrv.dll build, so it must match your exact Windows version.
“Listener State: Not Listening”
Check whether another application is using port 3389. Run netstat -ano | findstr 3389 to identify conflicts. Also ensure the Windows Firewall allows inbound connections on that port.
Wrapper Service Not Starting
Some antivirus products flag RDP Wrapper as a potentially unwanted program. Add an exclusion for the C:Program FilesRDP Wrapper directory and re-run install.bat.
Security Considerations
- Use strong passwords on all accounts that can log in via RDP.
- Enable Network Level Authentication (NLA) – RDPConf has a toggle for this.
- Limit access by IP using Windows Firewall rules so only trusted machines can connect.
- Consider a VPN – Never expose RDP directly to the internet. Use WireGuard, Tailscale, or an SSH tunnel instead.
- Keep Windows updated – Ironically, updates break RDPWrap, but they also patch critical RDP vulnerabilities (e.g., BlueKeep).
How to Uninstall
If you no longer need concurrent sessions, run uninstall.bat as administrator. The wrapper service will be removed and RDP will revert to its default behaviour. No system files are modified, so uninstallation is clean.
Conclusion
RDP Wrapper Library is a powerful homelab tool that unlocks multi-session remote desktop on consumer and pro editions of Windows. Keep the rdpwrap.ini file updated after Windows patches, follow basic security hygiene, and you’ll have a reliable remote access setup without needing a Windows Server licence.
Recommended Hardware & Hosting
Build your homelab with hardware tested and used by our team.
Affiliate links — we may earn a small commission at no extra cost to you.