ProgramVer

A Python version of Microsoft's winver — a copyright and licence window you drop into your own program.

Status • Key Features • Installation • Usage • Documentation • Support • Contributing • Credits • License

Status

2.0.0 — rewritten as a real package. ProgramVer is now programver, an importable package built around a VersionDialog class, instead of a single file meant to be copied into your project. The issues that made 1.9.0 unable to start (missing imgs/dfdlogo.gif, missing LICENSE.txt/EULA.txt) are resolved — see docs/internal/known-issues.md for the detailed before/after on each one.

The rest of docs/ still describes the pre-2.0 flat main.py layout and is being updated incrementally; treat it as historical until noted otherwise on each page.

Key Features

• A winver-style window: logo, program name and version, trademark notice, licence blurb.
• Open License and Open EULA buttons that display the full text in their own windows.
• A VersionDialog class you construct with your own name, version, and file paths — no editing library internals.
• Works standalone (creates its own window) or embedded in an existing Tkinter app (opens a Toplevel instead of taking over the event loop).
• Python-Powered badge included.
• Pure standard library — Tkinter only.
• Cross-platform.

Installation

pip install programver

Or from source:

git clone https://github.com/willtheorangeguy/ProgramVer
cd ProgramVer
python main.py   # runs the bundled demo

Usage

from programver import VersionDialog

dialog = VersionDialog(
    app_name="YourApp",
    version="1.0.0",
    copyright_text="Copyright (C) 2026 You. All rights reserved.",
    license_path="LICENSE.md",
    eula_path="EULA.md",
)
dialog.show()

See main.py in this repository for a complete, runnable example, including an optional logo and license blurb.

Documentation

Full documentation lives in docs/: Quickstart · Installation · Configuration · Architecture · Development · Testing · FAQ · Troubleshooting · Roadmap

Support

Open a GitHub Discussion, file an issue, or join the Discord.

Contributing

Please contribute using GitHub Flow. Create a branch, add commits, and open a pull request.

See the org-wide Contributing Guide and Code of Conduct.

Credits

This software uses the following open source packages, projects, services or websites:

GitHub	Python Software Foundation	Windows
Web - Plans	Web - Donate	Web

Sponsor @willtheorangeguy on PayPal.

License

MIT — see LICENSE.md.

Note main.py's demo window displays a GPL blurb and a different copyright holder on purpose, to show that this text is meant to be replaced per project — it does not describe this repository's own licence. python -m programver shows this repository's actual MIT notice. See docs/internal/known-issues.md.