v1.5.0

This release focuses on making the tool more user-friendly, especially for script execution and installation, while also improving documentation, dependencies, and Kerberos support.

Highlights of v1.5.0

New Features

• runps Command: Added a new runps command to execute local PowerShell scripts directly in the interactive shell (4061d9f).
• SVG Logo: Added an SVG logo for the project (8fdfb92).

Improvements

• Command Suggestions: Enhanced the load_ps function to provide feedback and update command suggestions when new scripts are loaded (9028fc8, 2ef47c7).
• Tab Completion: Added support for tab completion of executable files in the current remote directory (3040293).
• Argument Parsing: Refactored argument parsing to ensure named arguments with values are presented first (3d2416c).
• Path Handling: Improved handling of user directories in file upload and local path suggestions (8b67476, cdca7b9).
• Kerberos: Improved Kerberos credential handling for compatibility with updated gssapi (0283b9b).

Documentation & Installation

• Installation Guide: Added a dedicated installation guide and linked it in the README (866793d, 65193b0).
• Installation Instructions: Updated and clarified installation instructions, including correct formatting for GitHub package installation and optional Kerberos dependency (7135372, d23250e, 0ef9875).
• Documentation Updates: Improved documentation for runps, added an Install section, and renamed kb to knowledgebase (ae2677a, deeb377, 363a13e, 95e75f6).

Maintenance

• Dependencies: Updated prompt_toolkit version to 3.0.52 (536cb3c).
• GitHub Actions: Added a workflow for publishing the wiki (b9a803a).

---

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.5.0/

pip install evil-winrm-py==1.5.0

Full Changelog: v1.4.1...v1.5.0

v1.4.1

This is a maintenance release that fixes a dependency issue from the previous version, making the installation process smoother for users not requiring Kerberos authentication.

Highlights of v1.4.1

Dependency Fix

• This resolves a ModuleNotFoundError that occurred on default installations for users who did not have the necessary system-level Kerberos libraries. (e457323)

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.4.1/

pip install evil-winrm-py==1.4.1

Full Changelog: v1.4.0...v1.4.1

v1.4.0

This release brings significant enhancements to Kerberos authentication, improves the interactive shell experience, and adds more robust error handling.

Highlights of v1.4.0

Kerberos Authentication Enhancements

• Optional Username: The -u/--user argument is now optional. When using ticket-based Kerberos authentication, the username is automatically retrieved from the GSSAPI credentials cache (b3ea0b2, 856052a).
• Improved Error Handling: Error messaging for Kerberos and SPNEGO has been made more specific and helpful (3eb8c4a, c3f301c).
• Credential Warnings: A clear warning is now shown if a Kerberos credential cache is not found (27c8f7c).
• Debug Logging: Kerberos trace logging is now automatically enabled when running in --debug mode (b551c19).
• Documentation: The documentation for Kerberos usage has been clarified, highlighting the importance of SPN case sensitivity (b480d33, 9711985).

Interactive Shell & Usability Improvements

• User Path Expansion: Local path arguments now support tilde (~) expansion, allowing you to easily reference files in your home directory (e.g., upload ~/file.txt .) (d5fc44b, 918c9ad).
• Graceful Exit: The shell now handles Ctrl+C more gracefully, especially if the remote prompt is slow to respond (5bdf804).
• Cleaner Output: The initial connection message now only shows the username if it was explicitly provided (33dc4f1).

Enhanced Error Handling

• Connection Errors: Error messages for connection failures are now more descriptive (1bc77a3).
• Logging Permissions: The application now handles permission errors gracefully when trying to create a log file (e1ba8b2).

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.4.0/

pip install evil-winrm-py[kerberos]==1.4.0

Full Changelog: v1.3.0...v1.4.0

v1.3.0

This release introduces the powerful loadps command, allowing you to source local PowerShell scripts directly into your remote session. This is complemented by major improvements to tab completion to make using this new feature seamless.

Highlights of v1.3.0

Introducing loadps

• Load Local PowerShell Scripts: A new loadps command has been added to load functions from a local .ps1 script into the remote PowerShell session (dc1ac8d). The command validates the script's existence and extension before loading (c9d6449).
• New Documentation: The README and usage documentation have been updated to cover this new feature (beef131, 184241d).

Smarter Tab Completion

• Dynamic Command Suggestions: Functions from scripts loaded with loadps are now automatically available for tab completion in the shell (ef6806d).
• Path Completion for loadps: The loadps command now supports tab completion for local file paths, filtering specifically for .ps1 files to make loading scripts easier (0758517, a5092d3, 3c6f30b).

Other Improvements

• Robust Password Prompt: The application now correctly handles Ctrl+C if it's pressed during the password prompt (4dd4941).
• Enhanced Exception Handling: More exceptions are now caught to improve application stability (a2a8b47).

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.3.0/

pip install evil-winrm-py[kerberos]==1.3.0

Full Changelog: v1.2.0...v1.3.0

v1.2.0

Happy SysAdminDay 🙌

This version introduces a significant architectural change by overriding core components of the pypsrp library to fix critical bugs and enhance functionality. This release directly addresses long-standing issues with session stability and Kerberos authentication.

Highlights of v1.2.0

Core Transport Overhaul (Fixes #3)

• Fix for Inactivity Errors: To resolve WinRM transport errors that occurred after periods of inactivity, WSMan and _TransportHTTP from the pypsrp library have been overridden. This provides more robust session handling and gracefully manages invalid session errors (2137ffa, 1d197e2, 1ee4f2e).
• Customizable User-Agent: The WinRM client User-Agent is now customizable via the --user-agent argument. It defaults to a standard Microsoft WinRM Client User-Agent for better compatibility (9a5c39a, ad24e99, 3b0cff3).

Kerberos Fixes (Fixes #9)

• Improved SPN Handling: A default SPN prefix of "http" is now automatically used if one isn't provided, which helps resolve "Server not found in Kerberos database" errors (a2c543e).
• Updated Kerberos Configuration: The sample krb5.conf documentation was updated to prevent common DNS lookup issues (aae8b03).

Usability & Other Improvements

• New Entry Point: The tool can now be invoked with the shorter ewp command in addition to evil-winrm-py (5b20ce5).
• New Banner: A cleaner, more standard banner is now displayed on startup (755b651).
• Enhanced Help: The command-line help text (-h/--help) is now more descriptive (ad1b59f).

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.2.0/

pip install evil-winrm-py[kerberos]==1.2.0

Full Changelog: v1.1.2...v1.2.0

v1.1.2

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.1.2/

pip install evil-winrm-py==1.1.2

Full Changelog: v1.1.1...v1.1.2

v1.1.1

Changes in this release:

• Keeps WinRM session alive to prevent timeouts (background thread added). Fixes #3
• Code refactor for interactive shell and version bump to 1.1.1.

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.1.1/

pip install evil-winrm-py==1.1.1

Full Changelog: v1.1.0...v1.1.1

v1.1.0

Changes in this release:

• Added detailed documentation in the new docs/ directory, including a comprehensive usage guide.
• Introduced a --debug flag for enhanced debug logging.
• Improved error handling, logging, and user-facing error messages.
• Updated the interactive shell for better file transfer and error feedback.
• Minor UI tweaks in README.md (new screenshot, stargazer chart).
• Removed requirements-dev.txt.
• Internal code cleanup and version bump to 1.1.0.

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.1.0/

pip install evil-winrm-py==1.1.0

Full Changelog: v1.0.0...v1.1.0

v1.0.0

This release marks the first stable version of evil-winrm-py.

Key Features:

• Interactive Shell: Provides a command-line interface for executing commands on remote Windows systems.
• Multiple Authentication Methods: Supports NTLM, Pass-the-Hash, Certificate, and Kerberos authentication.
• Secure Communication: Offers SSL support for encrypted connections.
• File Transfer: Allows uploading and downloading files between the local and remote machines.
• User-Friendly Enhancements: Includes features like tab completion for paths, command history, and colorized output for better readability.
• Cross-Platform: Compatible with both Windows and Linux environments.

Changes in this release:

This initial release includes the core functionality of the tool, a comprehensive README with installation and usage instructions, and supporting documentation for development and knowledge base.

Download:
PyPI - https://pypi.org/project/evil-winrm-py/1.0.0/

pip install evil-winrm-py==1.0.0

Full Changelog: 8cc37a3...v1.0.0