evil-winrm-py 0.0.4

Rewrite of popular tool evil-winrm in python

evil-winrm-py

Rewrite of popular tool evil-winrm in python

Motivation

The original evil-winrm is written in Ruby, which can be a hurdle for some users. Rewriting it in Python makes it more accessible and easier to use, while also allowing us to leverage Python’s rich ecosystem for added features and flexibility.

I also wanted to learn more about winrm and its internals, so this project will also serve as a learning experience for me.

Installation (on Linux)

pipx install evil-winrm-py

or if you want to install with latest commit from the main branch you can do so by cloning the repository and installing it with pipx:

git clone https://github.com/adityatelange/evil-winrm-py
cd evil-winrm-py
pipx install .

Update

pipx upgrade evil-winrm-py

Uninstall

pipx uninstall evil-winrm-py

Features

• Run commands on remote Windows machines.
• Interactive shell.
• Logging and debugging options.
• Command history.
• Colorized output.
• Remote Path(files/directories) Completion.

Usage

usage: evil-winrm-py [-h] -i IP -u USER [-p PASSWORD] [-H HASH] [--port PORT] [--version]

options:
  -h, --help            show this help message and exit
  -i IP, --ip IP        remote host IP or hostname
  -u USER, --user USER  username
  -p PASSWORD, --password PASSWORD
                        password
  -H HASH, --hash HASH  nthash
  --port PORT           remote host port (default 5985)
  --version             show version

Credits

• Original evil-winrm project - https://github.com/Hackplayers/evil-winrm
• PowerShell Remoting Protocol for Python - https://github.com/jborean93/pypsrp