================================================================================
              PYI-Maker Studio Pro   v 2 . 6 . 4
================================================================================

  Professional GUI frontend for PyInstaller
  Copyright (c) 2026 - Timothy Vercoe
  https://quakehub.online

================================================================================
  WHAT IT DOES
================================================================================

  PYI-Maker Studio Pro is a full-featured graphical interface for packaging
  Python applications into standalone executables with PyInstaller.

  Key features:
  - Live PyInstaller command preview (updates as you change settings)
  - Multi-tab configuration (Target, Files, Imports, Optimization, OS, AST)
  - Advanced AST Script Inspector (detects star imports, relative imports,
    GUI frameworks, and packages that need --collect-all)
  - Build console with live output, progress phases, and Kill Build button
  - JSON project profiles (save / load full build configurations)
  - Version-aware update checker
  - Consistent app icon on main window and all dialogs
  - Dark theme UI (CustomTkinter)

  Supports both --onedir and --onefile modes, Windows / macOS options,
  hidden imports, data files, binaries, UPX, and more.

================================================================================
  PYTHON VERSION REQUIRED
================================================================================

  Minimum recommended : Python 3.10
  Fully tested with   : Python 3.11, 3.12, 3.13, 3.14

  Download Python from the official site:

      https://www.python.org/downloads/

  Important on Windows:
  - Tick "Add python.exe to PATH" during installation
  - Prefer the official installer from python.org (not the Microsoft Store
    version if you want the cleanest packaging experience)

================================================================================
  REQUIRED PIP PACKAGES
================================================================================

  Install the dependencies with:

      pip install customtkinter pillow requests pyinstaller

  Or one-by-one:

      pip install customtkinter
      pip install pillow
      pip install requests
      pip install pyinstaller

  Optional (only if you use UPX compression):

      Download UPX from https://upx.github.io/
      Then set the UPX folder path inside the app (Tab 4)

================================================================================
  HOW TO RUN
================================================================================

  1. Make sure Python and the packages above are installed
  2. Place app_icon.ico (optional but recommended) next to the script
  3. Run:

      python PYI-Maker-Studio-Pro-v2.6.4.py

  Or on Windows:

      py PYI-Maker-Studio-Pro-v2.6.4.py

================================================================================
  HOW TO BUILD THE APP ITSELF
================================================================================

  You can use PYI-Maker Studio Pro to package itself.

  Recommended settings:
  - Bundle mode     : --onedir
  - Window mode     : --windowed
  - Collect All     : customtkinter
  - Hidden imports  : customtkinter , PIL._tkinter_finder , pkg_resources
  - Add Data        : app_icon.ico;.

  Then click "VALIDATE & BUILD EXECUTABLE NOW".

================================================================================
  FILE STRUCTURE (typical)
================================================================================

  PYI-Maker-Studio-Pro-v2.6.4.py   <- main application
  app_icon.ico                     <- window + about icon (optional)
  README.txt                       <- this file
  pyi_maker_settings.json          <- auto-saved settings (created on first run)

================================================================================
  LICENSE / CREDIT
================================================================================

  Copyright (c) 2026 Timothy Vercoe
  Built with CustomTkinter + PyInstaller

  Free for personal and commercial use.
  Attribution appreciated but not required.

================================================================================
  SUPPORT
================================================================================

  Project page / downloads:
  https://quakehub.online/downloads/

================================================================================
