Contents
Installation
Install maketool helper from PyPI with following command:
pip install maketool
Requires Python 3.7+, PySide6, and PyInstaller 5.8+
Why Use maketool?
maketool is a command-line utility and helper module that simplifies running and building PySide6 Python 3.7+ applications into EXE using PyInstaller 5.8.0. Note: Windows only
If you build windows desktop apps using PySide6, then maketool can save you a lot of time:
- Automates repetitive tasks like running, compiling, cleanup and more
- Greatly simplifies EXE creation of your python program (uses PyInstaller with no need to create tedious spec file)
- Automatically converts all
.uiand.qrcfiles recursively when running or compiling. - Command-line interface for
.bator.shworkflow automation - Supports custom
.icoicons for your EXE - Supports optional resource embedding so you can embed extra files your EXE may need (ie. images, dlls, etc)
- Supports EXE version stamping
- Define pyside6 dlls to exclude from EXE in order to minimize EXE size
Commands
1. run
Purpose: Compile .ui and .qrc files recursively (using pyside6-uic.exe and pyside6-rcc.exe), then run the Python program using pythonw.exe.
ONLY out-of-date pyside components are rebuilt, so we don't waste time rebuilding ui/qrc files if they are unchanged.
Usage:
maketool-run [-h] file
Parameters:
file python file to run
-h, --help show this help message and exit
2. clean
Purpose: Remove build artifacts, caches, generated UI files, PyInstaller output, and spec files.
Removes:
- pycache folders
- *_ui.py, *_rc.py, *.pyc, *.pyo
- PyInstaller build/ and dist/ folders
- .spec files in the current directory
Usage: maketool-clean
3. compile
Purpose: Build an EXE using PyInstaller, including UI/QRC compilation, icon embedding, version stamping, and resource embedding.
Features:
- Supports onefile/onedir/console modes
- Auto-generates a PyInstaller .spec file
- Handles .ui/.qrc compilation automatically
- Supports embedding arbitrary files (DLLs, images, data assets, etc.)
Usage:
maketool-compile [-h] --file FILE --type {onefile,onedir,console}
[--icon ICON] [--embed EMBED]
[--exclude EXCLUDE]
Parameters:
-h, --help show this help message and exit
--file FILE python file to compile to EXE
--type {onefile,onedir,console}
type of EXE to build
--icon ICON ico file
--embed EMBED comma delimited list of files to embed
--exclude EXCLUDE comma-delimited list of DLLs to exclude.
"" means exclude nothing.
If omitted, maketool uses its internal default list.
Exclude:
PyInstaller often bundles Qt/OpenSSL DLLs that your application never actually touches at runtime. This is a well-known PySide6/PyInstaller pain point and can significantly inflate the size of your final EXE.
To address this, maketool-compile uses an internal list of commonly unused PySide6/Qt/OpenSSL DLLs and excludes them by default. This can dramatically shrink the size of the generated EXE.
If your EXE crashes or is strangely missing functionality, try --exclude="" so nothing is excluded. If your EXE still crashes then the bug is in your code.
Version:
You can define your EXE version using __version__ in your Python code. (optional)
__version__ = "3.7.2"
Exclude Default
If --exclude parameter is not defined, then the following DLLs are automatically excluded:
qdirect2d.dll,qpdf.dll,opengl32sw.dll,Qt6Network.dll,Qt6Pdf.dll,Qt6QmlModels.dll,Qt6Qml.dll,libssl-3.dll,Qt6Quick.dll,Qt6Svg.dll,libcrypto-3.dll,QtNetwork.pyd,Qt6VirtualKeyboard.dll,qtuiotouchplugin.dll,qsvgicon.dll,qnetworklistmanager.dll,qtvirtualkeyboardplugin.dll,qwindowsvistastyle.dll,qcertonlybackend.dll,qopensslbackend.dll,qschannelbackend.dll,Qt6OpenGL.dll
Exclude nothing (keep all DLLs that PyInstaller bundles for PySide6)
--exclude=""
Exclude only specified dlls
--exclude="Qt6Svg.dll,Qt6Qml.dll"
Extras
4. sublime
WARNING: This will overwrite existing custom key bindings.
Purpose: Install custom Sublime Text 4 shortcuts and commands.
Future: planned support of vscode editor.
Shortcuts installed:
- CTRL+BACKSPACE - delete line
- CTRL+ALT+E - open windows explorer where current file is located
- CTRL+0 - reset font size
- F1 - insert print statement for variable where cursor is located
- F5 - run pyflakes on current python source
- F6 - maketool-refscan - scan for unused/orphan files in the project
- F7 - build (runs maketool-run on current script via the build system)
- F10 - insert current date/day
Usage:
maketool-sublime [-h] --path PATH
Parameters:
-h, --help show this help message and exit
--path PATH sublime text - data/package/user path
5. refscan
Purpose: Scan for unused/orphan files using string-based heuristics.
This is especially useful for catching forgotten assets like .ui, .qss, .ico, images, etc.
"Unused" means "no string reference found anywhere in .py files".
Default behavior:
maketool-refscan
Show both used and unused:
maketool-refscan --show-used
Write a CSV report:
maketool-refscan --csv refscan-report.csv
Notes:
- This is heuristic (string-based). It may miss dynamically constructed paths/imports and may produce false positives.
- For best results, run it from your project root.
Changelog
[1.1.0] - 2026-07-23
- Initial release
[1.0.2] - 2026-03-02
maketool-refscancommand for detecting unused/orphan project files
[1.0.1] - 2026-01-20
- Fixed
maketool-cleannot removing.specfiles in nested directories
[1.2.1] - 2026-08-04
- Added
maketool-unusedfor finding unused functions in python source
License
MIT License
Copyright 2026 Alan Lilly
Metadata
Release files for maketool 1.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| maketool-1.2.1.tar.gz | 24.1 kB | Without provenance | Details for maketool-1.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| maketool-1.2.1-py3-none-any.whl | Python 3 | none | any | Details for maketool-1.2.1-py3-none-any.whl |
Total release size: 49.0 kB
Release files / maketool-1.2.1.tar.gz
| Download URL | maketool-1.2.1.tar.gz |
|---|---|
| Size | 24.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d75cd4adcee665e16cab56c886608867902cd09a98fec4329fde28ebc9f400c6
|
|
BLAKE2b-256 checksum How to use checksums |
1eacf715dae108c282929a18e18761948ce92013b249abb3c6dc73d73f022316
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.2
|
Release files / maketool-1.2.1-py3-none-any.whl
| Download URL | maketool-1.2.1-py3-none-any.whl |
|---|---|
| Size | 25.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9f21f068ebc6262e4ee3a1007e3174584591d95b448e992cbe8d3fdc5607377c
|
|
BLAKE2b-256 checksum How to use checksums |
1feae673e21ab9eb17bb951fb2351907edc6f337151ee031b23cfef3e044d27b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.2
|
Security for maketool 1.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.