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.17

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.17
File Size Uploaded Provenance Actions
aardwolf-0.2.17.tar.gz 1.0 MB Without provenance Details for aardwolf-0.2.17.tar.gz

Built distributions (wheels)

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

Total release size: 7.4 MB

Release files / aardwolf-0.2.17.tar.gz

Download URL aardwolf-0.2.17.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
42ee9e8d457e11b2bb8dc1400268c39c5898cc7b1fa9c3735a43ee2ee28505e0
BLAKE2b-256 checksum
How to use checksums
6c2160829e9ab5fcc41b32886d80ad8fbe86e56ade3c68086aab0cef5cd30df7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

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

Download URL aardwolf-0.2.17-cp311-abi3-win_amd64.whl
Size 2.0 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
4bb4f16f2acc3292a507197a35923a89763f7a173538c46d089e242b8f106910
BLAKE2b-256 checksum
How to use checksums
0c9eb8d7b3cbd9b3f10d453c212069cfb53cd13f8025034b14bf07ac9bcb15e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

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

Download URL aardwolf-0.2.17-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
8a2fc66cb4c32ff5ede8f9a157e4b7f6f62ca34ca86a2b8443879ac963f34642
BLAKE2b-256 checksum
How to use checksums
bbfa1b8c4c3b2cc0abc4da838f5a02974eea4991eec1f52d9b487dbc68bb6b0c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

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

Download URL aardwolf-0.2.17-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
24387eaa8a730e9317c5141b8e9fa41324e4a8ee2d21267d62af4b933c7195bf
BLAKE2b-256 checksum
How to use checksums
65b9622f084b4d5f5f00516c7a565388583b5e47c4f842a244ac619cd51f3052
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for aardwolf 0.2.17

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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