Alter is a remote desktop client application.

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

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.

• 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

• 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.

You can build the project using Visual Studio 2022.

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

Disclaimer: The codes stored herein are my own personal codes and do not related my employer's any way.