IronRDP/crates/ironrdp-client
Benoît Cortier 9c99133569
Some checks are pending
CI / Web Client (push) Blocked by required conditions
CI / Fuzzing (push) Blocked by required conditions
CI / Check formatting (push) Waiting to run
CI / Check typos (push) Waiting to run
CI / Checks [linux] (push) Blocked by required conditions
CI / Checks [macos] (push) Blocked by required conditions
CI / Checks [windows] (push) Blocked by required conditions
CI / FFI (push) Blocked by required conditions
CI / Success (push) Blocked by required conditions
Coverage / Coverage Report (push) Waiting to run
Release crates / Open release PR (push) Waiting to run
Release crates / Release crates (push) Waiting to run
refactor(client): remove redundant value_parser option (#853)
This option is only relevant when specifying a value parser different
than the default one.
2025-07-03 10:09:45 +00:00
..
src refactor(client): remove redundant value_parser option (#853) 2025-07-03 10:09:45 +00:00
Cargo.toml feat(dvc): add DVC named pipe proxy support (#791) 2025-06-17 10:16:41 +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.