No description
Find a file
2023-08-14 17:54:28 +02:00
.github/workflows Factorize Github actions and run checks for Python 3.11 2023-08-06 01:39:57 +02:00
assets Add a custom icon to the executable 2023-08-14 16:39:53 +02:00
unlicense Adjust IAT search heuristics to avoid missing certain IAT ranges 2023-08-14 02:57:36 +02:00
.gitignore Add base code for OEP, IAT detection and IAT unwrapping 2021-08-18 13:32:01 +02:00
CHANGELOG.md Bump project to version 0.4.0, update CHANGELOG 2023-08-14 17:54:28 +02:00
LICENSE Add LICENSE and update README 2021-08-23 01:13:06 +02:00
poetry.lock Bump frida to version 16.1.3 2023-08-05 19:22:59 +02:00
pyproject.toml Bump project to version 0.4.0, update CHANGELOG 2023-08-14 17:54:28 +02:00
README.md Add a custom icon to the executable 2023-08-14 16:39:53 +02:00
unlicense.spec Add a custom icon to the executable 2023-08-14 16:39:53 +02:00

Unlicense

GitHub release Minimum Python version CI status

A Python 3 tool to dynamically unpack executables protected with Themida/WinLicense 2.x and 3.x.

Warning: This tool will execute the target executable. Make sure to use this tool in a VM if you're unsure about what the target executable does.

Note: You need to use a 32-bit Python interpreter to dump 32-bit executables.

Features

  • Handles Themida/Winlicense 2.x and 3.x
  • Handles 32-bit and 64-bit PEs (EXEs and DLLs)
  • Handles 32-bit and 64-bit .NET assemblies (EXEs only)
  • Recovers the original entry point (OEP) automatically
  • Recovers the (obfuscated) import table automatically

Known Limitations

  • Doesn't handle .NET assembly DLLs
  • Doesn't produce runnable dumps in most cases
  • Resolving imports for 32-bit executables packed with Themida 2.x is pretty slow
  • Requires a valid license file to unpack WinLicense-protected executables that require license files to start

How To

Download

You can either download the PyInstaller-generated executables from the "Releases" section or fetch the project with git and install it with pip:

pip install git+https://github.com/ergrelet/unlicense.git

Use

If you don't want to deal the command-line interface (CLI) you can simply drag-and-drop the target binary on the appropriate (32-bit or 64-bit) unlicense executable (which is available in the "Releases" section).

Otherwise here's what the CLI looks like:

unlicense --help
NAME
    unlicense.exe - Unpack executables protected with Themida/WinLicense 2.x and 3.x

SYNOPSIS
    unlicense.exe PE_TO_DUMP <flags>

DESCRIPTION
    Unpack executables protected with Themida/WinLicense 2.x and 3.x

POSITIONAL ARGUMENTS
    PE_TO_DUMP
        Type: str

FLAGS
    --verbose=VERBOSE
        Type: bool
        Default: False
    --pause_on_oep=PAUSE_ON_OEP
        Type: bool
        Default: False
    --no_imports=NO_IMPORTS
        Type: bool
        Default: False
    --force_oep=FORCE_OEP
        Type: Optional[Optional]
        Default: None
    --target_version=TARGET_VERSION
        Type: Optional[Optional]
        Default: None
    --timeout=TIMEOUT
        Type: int
        Default: 10

NOTES
    You can also use flags syntax for POSITIONAL ARGUMENTS