← Back to dashboard

One-time setup: atc-rdp:// opens Remote Desktop

Browsers cannot start mstsc.exe directly. This dashboard uses a small custom URL scheme (atc-rdp://host:port) that runs a short PowerShell helper on your PC to launch Remote Desktop—no .rdp file download each time, after you register the handler once.

1. Download the launcher script: Open-AtcRdp.ps1
2. Save it to a folder that won’t move (example: C:\Tools\atc-rdp\Open-AtcRdp.ps1).
3. Copy register-atc-rdp.reg.template, open it in Notepad, replace REPLACE_WITH_FOLDER with your folder (double backslashes), save as .reg, then double-click to import. Template file: register-atc-rdp.reg.template
4. Alternatively, run once in an elevated PowerShell (adjust paths):

   Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
   New-Item -Path 'HKCU:\Software\Classes\atc-rdp' -Force | Out-Null
   New-ItemProperty -Path 'HKCU:\Software\Classes\atc-rdp' -Name '(Default)' -Value 'URL:ATC RDP' -PropertyType String -Force
   New-ItemProperty -Path 'HKCU:\Software\Classes\atc-rdp' -Name 'URL Protocol' -Value '' -PropertyType String -Force
   New-Item -Path 'HKCU:\Software\Classes\atc-rdp\shell\open\command' -Force | Out-Null
   $cmd = 'powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "C:\Tools\atc-rdp\Open-AtcRdp.ps1" "%1"'
   New-ItemProperty -Path 'HKCU:\Software\Classes\atc-rdp\shell\open\command' -Name '(Default)' -Value $cmd -PropertyType String -Force

5. Return to the dashboard and use Remote Desktop — choose Open Remote Desktop (or copy the mstsc command if the protocol is not registered yet).