Skip to main content

Utilities to support code signing Windows executable files

Project description Documentation Status

winsign is a python module for signing and manipulating Authenticode signatures in PE and MSI files.

  • Works on Python 3.6 and up.

  • Free software: MPL2


Most dependencies are specified in requirements/base.txt, however, currently you also need osslsigncode installed to perform signing. This utility can be fetched from your distribution’s package repository, or from e.g.

Signing MSIX/APPX files currently requires Mozilla’s fork of msix-packaging.


pip install winsign

CLI Usage

usage: winsign [-h] --certs CERTS --key PRIV_KEY [-n COMMENT] [-i URL] -d
               {sha1,sha256} [-t {old,rfc3161}] [-v] [-q]
               infile [outfile]

positional arguments:
  infile            unsigned file to sign
  outfile           where to write output to. defaults to infile

optional arguments:
  -h, --help        show this help message and exit
  --certs CERTS     certificates to include in the signature
  --key PRIV_KEY    private key used to sign
  -n COMMENT        comment to include in signature
  -i URL            url to include in signature
  -d {sha1,sha256}  digest to use for signing. must be one of sha1 or sha256
  -t {old,rfc3161}
  -v, --verbose
  -q, --quiet

Future plans

  • Stop using osslsigncode for PE signatures

  • Refactor code so that osslsigncode functionality is in its own module

  • Add python support for MSI, then we can drop dependency on osslsigncode


Highly recommended to create a virtualenv, then run:
  • python develop

  • make your changes to the source files

  • run local tests: tox

upon successful r+ and merging to master branch, you need to release a new version on PyPi.
  • edit to adjust the version

  • generate .whl file locally: python bdist_wheel

  • file will exist in: ./dist/winsign-{version}-py3-none-any.whl

  • (assuming you have pypi access to upload)

  • upload to pypi: twine upload –verbose dist/winsign-{version}-py3-none-any.whl



2.2.2 (2021-10-20)

  • make CAfile an argument to sign_file

  • small tweaks to readme, history, version number

2.2.0 (2021-10-13)

  • Added support for osslsigncode 2.1+ (required -CAfile cli)

  • updated documentation for packaging and ownership

2.1.0 (2021-07-14)

  • Added support for MSIX/APPX signing

2.0.0 (2019-10-17)

  • Breaking API: Some functions are now async. In particular, the top-level sign_file function is now an async function.

  • Restructured module layout

  • Added docs

1.3.0 (2019-09-12)

  • Fixed old style timestamp generation

  • Added signature verification code

  • Removed autograph support. Client code can implement their own autograph signing hooks for winsign.sign.sign_file

1.2.0 (2019-09-10)

  • Updated logging so that is_signed doesn’t produce error logs when files aren’t signed

1.1.0 (2019-09-05)

  • Added is_signed method to check if files are signed

1.0.0 (2019-08-30)

  • First release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

winsign-2.2.2-py3-none-any.whl (27.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page