v2.0 · Python · Windows · Security

Windows security testing,
focused.

WinRaider 2.0 is a Python-based Windows security assessment and penetration-testing toolkit for authorized testing, research, and educational lab environments.

01 · Capabilities

One CLI. Seven services.

WinRaider combines service discovery, authenticated assessment, vulnerability checks, credential auditing, and optional Metasploit integration.

Network scanning

Scans ports 445, 3389, 5985, 5986, 139, 135, and 22 across common Windows/network services.

Authenticated testing

Supports authorized SMB file access, RDP GUI, WinRM shell, and SSH shell testing with supplied credentials.

Vulnerability assessment

Checks for EternalBlue/MS17-010, BlueKeep/CVE-2019-0708, SMBGhost/CVE-2020-0796, WinRM weaknesses, NetBIOS disclosure, and SSH vulnerabilities.

Credential testing

Accepts username and password wordlists for controlled credential-security assessments.

Metasploit integration

Can integrate with a locally available msfconsole for supported security-testing workflows.

Professional CLI

Banner, quiet mode, verbose mode, target parsing, credentials, wordlists, logging, reports, and Metasploit configuration.

02 · Installation

Install locally.

Windows + Python 3.x are required. Metasploit is optional.

git clone https://github.com/Nullit13/winraider/
cd winraider

python -m venv .venv
.venv\Scripts\Activate.ps1

pip install -r requirements.txt
python main.py --help
Use a dedicated virtual environment and run WinRaider only against systems you are explicitly authorized to assess.
03 · Usage

Command-line workflows.

The examples below use documentation IP space and are intended for an isolated authorized lab.

.\winraider.exe -t 192.0.2.10
.\winraider.exe -t 192.0.2.10 -v
.\winraider.exe -t 192.0.2.10 -q
.\winraider.exe -t 192.0.2.10 -u administrator -p "<PASSWORD>"
.\winraider.exe -t 192.0.2.10 --users users.txt -w passwords.txt
.\winraider.exe -t 192.0.2.10 --msfpath "C:\path\to\msfconsole.exe"
04 · CLI reference

Every flag at a glance.

-t, --target

Required target IP address for target-based operations.

--discover

Discover Windows devices on the local network.

-u, --username

Username for authenticated testing.

-p, --password

Password for authenticated testing.

-w, --wordlist

Password wordlist. Defaults to wordlists/passwords.txt.

--users

Username wordlist. Defaults to wordlists/users.txt.

--threads

Number of threads used by credential-testing workflows. Default: 10.

--msfpath

Path to Metasploit msfconsole.

--lhost

Local host IP for supported Metasploit workflows.

-v, --verbose

Verbose output.

-q, --quiet

Quiet mode with minimal output.

--log

Write activity to winraider.log.

--report

Save assessment results to a report file.

--scan

Run port scanning only.

--zero

Run vulnerability checks without credentials.

--creds

Run authorized testing with supplied credentials.

--brute

Run authorized credential wordlist testing.

05 · Service matrix

Supported ports.

PortServiceAssessment types
445SMBDiscovery · authenticated access · SMB vulnerability checks · credential testing
3389RDPDiscovery · authenticated RDP testing · BlueKeep assessment · credential testing
5985WinRM HTTPDiscovery · authentication testing · configuration/security checks
5986WinRM HTTPSDiscovery · authenticated WinRM testing · configuration/security checks
139NetBIOSDiscovery · information-disclosure assessment · credential testing
135MSRPCDiscovery · RPC-related security assessment
22SSHDiscovery · authenticated SSH testing · SSH security/vulnerability checks · credential testing
06 · Wordlists

Plain text. One entry per line.

WinRaider accepts simple text wordlists. Avoid blank lines and keep credential testing within your authorization scope.

users.txt

administrator
admin
guest
test
user

passwords.txt

password123
Password123!
Winter2026!
ExamplePassword
07 · Safe testing

Use an isolated lab.

For development and education, dedicate virtual machines to testing and isolate them from networks you do not control.

┌───────────────────────┐
│    WinRaider Host     │
│       Windows         │
└───────────┬───────────┘
            │
      Isolated Lab Network
            │
┌───────────▼───────────┐
│   Windows Test VM     │
│  SMB · RDP · WinRM    │
│  NetBIOS · MSRPC · SSH│
└───────────────────────┘
09 · Project

Author.

AA
Abed (Nullit13)
GitHub: @Nullit13 · WinRaider · Python · v2.0
10 · Release

What changed in v2.0.

Discovery

Windows device discovery is available through --discover for local authorized lab networks.

Assessment modes

Separate scan, vulnerability, authenticated, and credential-testing modes make workflows easier to control.

Reporting

Activity logging and report output can be enabled with --log and --report.

11 · License

MIT License.

WinRaider is released under the MIT License. Keep the repository's LICENSE file alongside the project.

MIT License

Copyright (c) 2026 Abed (Nullit13)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files, to deal in the Software
without restriction, subject to the conditions of the MIT License.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.