Skip to main content

A python wrapper for the winsparkle project

Project description

About pywinsparkle

An auto-update framework for frozen Python applications on Windows.

Pywinsparkle is a wrapper for the WinSparkle project originally developed by Vaclav Slavik. WinSparkle is an update framework for Windows.

The original WinSparkle project is located here:


The current version of PyWinSparkle includes WinSparkle 0.6.0

Note: This is package is not affiliated with the original developer Vaclac Slavik and is therefore technically unofficial.


pip install pywinsparkle

Wheels are built for 32bit and 64bit versions of Windows, covering Python 2.7 and all python version after 3.3

Note: If you are using one of the above versions pip throws and errror, consider upgrading pip with pip install --upgrade pip


All of the API function wrapper names are the same as the original WinSparkle project. The only difference is in the argument types which are either python strings or integers. For the callback functions, just the function object is required (ie, the name of the function without the parenthesis).

In pywinsparkle, I have not tested created Windows Resource files, instead I have just been using win_sparkle_set_app_details() function. The Windows Resource files should work though. It is also necessary to set the appcast url with win_sparkle_set_appcast_url().

Basic Example:

from pywinsparkle import pywinsparkle
import os

def no_update_found():
    """ when no update has been found, close the updater"""
    print("No update found")
    print("Setting flag to shutdown PassagesUpdater")

def found_update():
    """ log that an update was found """
    print("New Update Available")

def encountered_error():
    print("An error occurred")

def update_cancelled():
    """ when the update was cancelled, close the updater"""
    print("Update was cancelled")
    print("Setting flag to shutdown PassagesUpdater")

def shutdown():
    """ The installer is being launched signal the updater to shutdown """

    # actually shutdown the app here
    print("Safe to shutdown before installing")

def main():

    # register callbacks

    # set application details
    update_url = ""
    pywinsparkle.win_sparkle_set_app_details("VendorName", "TestApp1", "1.0.0")

    if os.path.isfile('dsa_pub.pem'):
        with open('dsa_pub.pem', 'r') as file:
            pub_key =

    # initialize

    # check for updates

    # alternatively you could check for updates in the
    # background silently

    # dont do it this way, just an example to keep the thread running
    while True:

if __name__ == "__main__":

API Documentation

The documentation for the API can be found at:

Freezing with Pyinstaller

Add an entry to .SPEC in Analysis for binaries.

Assuming you are using a virtual environment and it is called “venv” it would look like this:

import platform

if architecture == "64bit":
    winsparkle = 'venv\\Lib\\site-packages\\pywinsparkle\\libs\\x64\\WinSparkle.dll'
    winsparkle = 'venv\\Lib\\site-packages\\pywinsparkle\\libs\\x86\\WinSparkle.dll'

a = Analysis(['Updater\\src\\'],
             binaries=[(winsparkle, '.')],

The package contains DLL’s for both 64bit and 32bit versions of python. Adding the preceding code snippet makes it possible to switch between versions of python seamlessly.

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 Distributions

pywinsparkle-1.6.0-cp37-cp37m-win_amd64.whl (2.1 MB view hashes)

Uploaded CPython 3.7m Windows x86-64

pywinsparkle-1.6.0-cp37-cp37m-win32.whl (2.1 MB view hashes)

Uploaded CPython 3.7m Windows x86

pywinsparkle-1.6.0-cp36-cp36m-win_amd64.whl (2.1 MB view hashes)

Uploaded CPython 3.6m Windows x86-64

pywinsparkle-1.6.0-cp36-cp36m-win32.whl (2.1 MB view hashes)

Uploaded CPython 3.6m Windows x86

pywinsparkle-1.6.0-cp35-cp35m-win_amd64.whl (2.1 MB view hashes)

Uploaded CPython 3.5m Windows x86-64

pywinsparkle-1.6.0-cp35-cp35m-win32.whl (2.1 MB view hashes)

Uploaded CPython 3.5m Windows x86

pywinsparkle-1.6.0-cp34-cp34m-win_amd64.whl (2.1 MB view hashes)

Uploaded CPython 3.4m Windows x86-64

pywinsparkle-1.6.0-cp34-cp34m-win32.whl (2.1 MB view hashes)

Uploaded CPython 3.4m Windows x86

pywinsparkle-1.6.0-cp33-cp33m-win_amd64.whl (2.1 MB view hashes)

Uploaded CPython 3.3m Windows x86-64

pywinsparkle-1.6.0-cp33-cp33m-win32.whl (2.1 MB view hashes)

Uploaded CPython 3.3m Windows x86

pywinsparkle-1.6.0-cp27-cp27m-win_amd64.whl (2.1 MB view hashes)

Uploaded CPython 2.7m Windows x86-64

pywinsparkle-1.6.0-cp27-cp27m-win32.whl (2.1 MB view hashes)

Uploaded CPython 2.7m Windows x86

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