Skip to main content

Supported Python versions Twitter

🚩 Sponsors

If you like this project, consider purchasing licenses of OctoPwn, our full pentesting suite that runs in your browser!
For notifications on new builds/releases and other info, hop on to our Discord

AARDWOLF - Asynchronous RDP/VNC client in Python (headless)

This project is aimed to play around the RDP and VNC protocols.
Project contains no GUI, for a GUI client please check out aardwolfgui

🚩 Runs in the browser

This project, alongside with many other pentester tools runs in the browser with the power of OctoPwn!
Check out the community version at OctoPwn - Live

Important

This is a headless client, for GUI functionality use the aardwolfgui package.

Features

  • Supports credssp auth via NTLM/Kerberos.
  • Built-in proxy client allows SOCKS/HTTP proxy tunneling without 3rd part software
  • PtH via CredSSP+Restricted admin mode
  • Scriptable Keyboard, Mouse input and Clipboard input/output
  • Can run in headless mode, no GUI required (read: no need for Qt)
  • Support for Duckyscript files to emulate keystrokes

Example scripts

  • ardpscan Multi-purpose scanner for RDP and VNC protocols. (screenshot/capabilities/login scanner)

URL format

As usual the scripts take the target/scredentials in URL format. Below some examples

  • rdp+kerberos-password://TEST\Administrator:Passw0rd!1@win2016ad.test.corp/?dc=10.10.10.2&proxytype=socks5&proxyhost=127.0.0.1&proxyport=1080
    CredSSP (aka HYBRID) auth using Kerberos auth + password via socks5 to win2016ad.test.corp, the domain controller (kerberos service) is at 10.10.10.2. The socks proxy is on 127.0.0.1:1080
  • rdp+ntlm-password://TEST\Administrator:Passw0rd!1@10.10.10.103
    CredSSP (aka HYBRID) auth using NTLM auth + password connecting to RDP server 10.10.10.103
  • rdp+ntlm-password://TEST\Administrator:<NThash>@10.10.10.103
    CredSSP (aka HYBRID) auth using Pass-the-Hash (NTLM) auth connecting to RDP server 10.10.10.103
  • rdp+plain://Administrator:Passw0rd!1@10.10.10.103
    Plain authentication (No SSL, encryption is RC4) using password connecting to RDP server 10.10.10.103
  • vnc+plain://Passw0rd!1@10.10.10.103
    VNC client with VNC authentication using password connecting to RDP server 10.10.10.103
  • vnc+plain://Passw0rd!1@10.10.10.103
    VNC client with VNC authentication using password connecting to RDP server 10.10.10.103
  • vnc+plain://:admin:aaa@10.10.10.103
    VNC client with VNC authentication using password admin:aaa connecting to RDP server 10.10.10.103. Note that if the password contains : char you will have to prepend the password with :

Kudos

  • Sylvain Peyrefitte (@citronneur) rdpy. The decompression code and the QT image magic was really valuable.
  • Marc-André Moreau (@awakecoding) for providing suggestions on fixes

Metadata

Release files for aardwolf 0.2.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aardwolf 0.2.16
File Size Uploaded
aardwolf-0.2.16.tar.gz 1.0 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for aardwolf 0.2.16
File Interpreter ABI Platform
aardwolf-0.2.16-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details
aardwolf-0.2.16-cp311-abi3-manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.28+ x86-64 Details
aardwolf-0.2.16-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details

Total release size: 7.4 MB

Release files / aardwolf-0.2.16.tar.gz

Download URL aardwolf-0.2.16.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
52cba79817af963108dcd39e82513deec742387f2fab01a9138abe56f94e7ad2
BLAKE2b-256 checksum
How to use checksums
710f79f2acb31e1144a3895d17ad9136272d2b75ed3bd24eb1c415129d5e089d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / aardwolf-0.2.16-cp311-abi3-win_amd64.whl

Download URL aardwolf-0.2.16-cp311-abi3-win_amd64.whl
Size 2.0 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
b4d6032110ee238cf11c1f5efa86636462d7dc2e972b8464e949da82df58f3a6
BLAKE2b-256 checksum
How to use checksums
7143b51e73133aae6a3e56bfb79174e8a4edc99f8ef051202b0e7173053a0886
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / aardwolf-0.2.16-cp311-abi3-manylinux_2_28_x86_64.whl

Download URL aardwolf-0.2.16-cp311-abi3-manylinux_2_28_x86_64.whl
Size 2.2 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
69bedfad4b68b855a9d0df928c78eb0bbdc642c22f9845778c9df77a8fe9c259
BLAKE2b-256 checksum
How to use checksums
157b079c9087a742763141d3e2e4b000f34c3962aa6cb67599158fcb08c9aaaa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / aardwolf-0.2.16-cp311-abi3-macosx_11_0_arm64.whl

Download URL aardwolf-0.2.16-cp311-abi3-macosx_11_0_arm64.whl
Size 2.2 MB
Tags CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
fbde3046d4cdd3a5596dfcc988965b85527632cee46db2522961893d101fcbc7
BLAKE2b-256 checksum
How to use checksums
6c8da0cfa361e4077c56bcda4b820c462dbea4a11ff60110bc8486c1f051b660
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.2.16 This release

4 release files

0.2.14

1 release file

0.2.10

1 release file

0.2.9

6 release files

0.2.8

9 release files

0.2.6

9 release files

0.2.5

9 release files

0.2.2

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.0.8

6 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page