Alter RDP Client (Enhanced Version)

This repository is an enhanced version of the original Alter RDP Client project.

It introduces various RDP connection options that were not available in the original project.

The following features have been added:

1. Full-Screen Support The application can use the entire screen without displaying a title bar.

   Similar to the full-screen mode in the built-in Windows RDP client, a movable overlay is displayed at the top of the screen.

   • The overlay can be dragged horizontally using the mouse.
   • When the mouse pointer leaves the overlay, it automatically disappears after three seconds.
   • To display the hidden overlay again, move the mouse pointer to the area where the overlay was previously located.

2. Multi-Monitor Support RDP sessions can use all connected monitors.

3. Keyboard Input Event Configuration Additional options have been added for configuring keyboard input behavior.

This enhanced project was developed with the assistance of ChatGPT Codex 5.5. ❤️

Although Codex completed the implementation of the additional features, all reviews, validations, and final decisions regarding the modified code were performed by a human developer.

Alter (Origin Project here)

Alter is a remote desktop client application.

✨ Features

• High DPI support - Reflect to the local DPI to the remote desktop session.
• Update the resolution on the window resize.

📥 Install and uninstall

1. Download the app's latest release zip file.

2. Unblock the downloaded zip file by check Unblock from the zip file's property or using the Unblock-File cmdlet.

   Unblock-File alter-x.y.z.zip

3. Extract files from the downloaded zip file. You can extract files by the Extract All... context menu in the File Explorer or using the Expand-Archive cmdlet.

   Expand-Archive alter-x.y.z.zip

4. Put the extracted folder alter-x.y.z anywhere you like.

5. Run the alter.exe in the extracted folder.

6. If you don't need this app anymore, you can uninstall this app by deleting the alter-x.y.z folder.

📋 Supported operating systems

• Alter is tested on the latest version of Windows 11 with latest updates.
• Alter may also work on the following OSs:
  • Windows 11 with latest updates
  • Windows 10 x64/x86 with latest updates
  • Windows Server 2022 with latest updates
  • Windows Server 2019 with latest updates
  • Windows Server 2016 with latest updates
  • Windows Server 2012 R2 with latest updates

Tips

• Command-line options

  Alter.exe [-host:<RemoteHost>] [-port:<Port>] [-username:<UserName>] [-title:<Title>] [-autoconnect]
  

  • -host - Specify the remote host's DNS name or IP address to which you want to connect.

    • Example: -host:host1.example.com
    • Example: -host:198.51.100.123

  • -port - Specify the remote port to which you use to connect. Use the default port (3389) if not specified.

    • Example: -port:12345

  • -username - Specify the user name that you want to use to connect to the remote host. Enclose the user name in double quotes if it has whitespaces.

    • Example: -username:UserName
    • Example: -username:"User Name"

  • -title - Specify the title for the connection. Enclose the title in double quotes if it has whitespaces.

    • Example: -title:JumpboxServer
    • Example: -title:"Jumpbox Server"

  • -autoconnect - If specify this option, will automatically start the connection.

• If you want to store your credentials, check the Remember me when you enter the credentials at the first time. Then you can skip enter credentials next time.

• You can get the detailed connection status information by clicking the message that at center bottom of the Alter's window. Click again to back the original message.

  • Example: Clicking the Remote disconnect by user message then showing detailed connection information that Reason: 0x2 (RemoteByUser), ExtendedReason: 0xB (RpcInitiatedDisconnectByUser).

• The Alter's setting file is located at %LocalAppData%\AlterRDClient\<Version>\setting.db. The setting.db file is a SQLite database file.

🔨 Build from the source

You can build the project using Visual Studio 2022.

Projects License (Origin/Enhanced Ver.)

alter-rdp-client Copyright (c) 2023-present Takeshi Katano. All rights reserved. This software is released under the MIT License.

AlterRDP Enhanced Copyright (c) 2026-present Takeshi Katano. All rights reserved. This software is released under the MIT License