https://github.com/tksh164/alter-rdp-client
Alter is a remote desktop client application.
https://github.com/tksh164/alter-rdp-client
rdp rdp-client remote-desktop windows
Last synced: 8 months ago
JSON representation
Alter is a remote desktop client application.
- Host: GitHub
- URL: https://github.com/tksh164/alter-rdp-client
- Owner: tksh164
- License: mit
- Created: 2023-04-30T14:20:16.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-15T19:28:14.000Z (about 2 years ago)
- Last Synced: 2024-06-15T20:35:05.289Z (about 2 years ago)
- Topics: rdp, rdp-client, remote-desktop, windows
- Language: C#
- Homepage:
- Size: 569 KB
- Stars: 9
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/tksh164/alter-rdp-client/releases/latest).
2. Unblock the downloaded zip file by check **Unblock** from the zip file's property or using the [Unblock-File](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/unblock-file) cmdlet.
```powershell
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](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.archive/expand-archive) cmdlet.
```powershell
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:] [-port:] [-username:] [-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\\setting.db`. The `setting.db` file is a SQLite database file.
## 🔨 Build from the source
You can build the project using [Visual Studio 2022](https://visualstudio.microsoft.com/).
## ⚖️ License
Copyright (c) 2023-present Takeshi Katano. All rights reserved. This software is released under the [MIT License](https://github.com/tksh164/alter-rdp-client/blob/main/LICENSE).
Disclaimer: The codes stored herein are my own personal codes and do not related my employer's any way.