IronRDP/crates/ironrdp-client
2025-04-16 04:23:49 -04:00
..
src fix(client)!: fix name of client address field (#754) 2025-04-16 04:23:49 -04:00
Cargo.toml feat(client): add support for RDCleanPath (#745) 2025-04-14 13:08:44 +00:00
README.md docs: add project links to READMEs for consistency 2024-10-29 19:14:20 +09:00

IronRDP client

Portable RDP client without GPU acceleration.

This is a a full-fledged RDP client based on IronRDP crates suite, and implemented using non-blocking, asynchronous I/O. Portability is achieved by using softbuffer for rendering and winit for windowing.

Sample usage

ironrdp-client <HOSTNAME> --username <USERNAME> --password <PASSWORD>

Configuring log filter directives

The IRONRDP_LOG environment variable is used to set the log filter directives.

IRONRDP_LOG="info,ironrdp_connector=trace" ironrdp-client <HOSTNAME> --username <USERNAME> --password <PASSWORD>

See tracing-subscribers documentation for more details.

Support for SSLKEYLOGFILE

This client supports reading the SSLKEYLOGFILE environment variable. When set, the TLS encryption secrets for the session will be dumped to the file specified by the environment variable. This file can be read by Wireshark so that in can decrypt the packets.

Example

SSLKEYLOGFILE=/tmp/tls-secrets ironrdp-client <HOSTNAME> --username <USERNAME> --password <PASSWORD>

Usage in Wireshark

See this awakecoding's repository explaining how to use the file in wireshark.

This crate is part of the IronRDP project.