Skip to content

Latest commit

 

History

History
82 lines (53 loc) · 3.62 KB

README.md

File metadata and controls

82 lines (53 loc) · 3.62 KB
Raw

Alter

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.

⚖️ License

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.