Skip to content

v0.3.1 — first public release

Choose a tag to compare

View all tags
@djdarcy djdarcy released this 08 Jul 05:37
v0.3.1
This tag was signed with the committer’s verified signature.
djdarcy Dustin
GPG key ID: CD4385E7B7BA3529
Verified
Learn about vigilant mode.
bfe3410
This commit was signed with the committer’s verified signature.
djdarcy Dustin
GPG key ID: CD4385E7B7BA3529
Verified
Learn about vigilant mode.

Rescue the RDP session Windows would make you destroy.

wtf-rdp installs an autonomous SYSTEM watchdog that detects an RDP / console session wedged or blocked by Local Session Manager (LSM) and non-destructively reconnects it via tscon and locks it — before Windows can garbage-collect your work. It runs as LocalSystem, so it needs no changes to the machine's admin/token model.

This is the first public release.

Install

pip install wtf-rdp

Then, in an elevated PowerShell on the RDP host (the machine that wedges):

rdp install -TargetUser $env:USERNAME   # deploy + start the watchdog, scoped to you
rdp status                              # confirm it's Running as SYSTEM

The sessfix kit — seven tools

  • status / query — watchdog + live session state; query flags stranded / wedge candidates
  • install / uninstall — NSSM LocalSystem watchdog service (fetches a checksum-verified NSSM; the wheel stays pure-Python)
  • recover — manual one-shot reconnect + lock right now (self-elevates to SYSTEM)
  • logs — view the watchdog log (-Tail / -Follow / -Full)
  • config — show / change poll interval, wedge-confirm window, target user

Highlights

  • Non-destructive — reconnects via tscon, never signs the session out; running work survives
  • Autonomous — a SYSTEM service detects the wedge and rescues it on its own, then locks the box
  • Event-driven detection — keys on the real LSM wedge signature, not just "disconnected", so it stays quiet on normal idle disconnects
  • No OS changes — no LocalAccountTokenFilterPolicy, no enabled built-in Administrator
  • Universal -h / --help / /? on every tool

See the CHANGELOG for full 0.3.0 / 0.3.1 detail. Windows 10 / 11.

Assets 2
Loading