From 6f07bb9cba669eb3f5495995fa38614dce3d4771 Mon Sep 17 00:00:00 2001
From: Quality App Developer <dev@quality-app.local>
Date: Thu, 5 Feb 2026 16:46:16 +0200
Subject: [PATCH] Update: add Python version compatibility notes (3.14 may have
 issues)

---
 BUILD_ON_WINDOWS.md | 15 +++++++++++++--
 build_windows.bat   |  5 +++--
 build_windows.ps1   |  5 +++--
 3 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/BUILD_ON_WINDOWS.md b/BUILD_ON_WINDOWS.md
index 3eaef52..c024f6f 100644
--- a/BUILD_ON_WINDOWS.md
+++ b/BUILD_ON_WINDOWS.md
@@ -4,8 +4,9 @@ This guide explains how to build a standalone `LabelPrinter.exe` single-file exe
 
 ## Prerequisites
 
-1. **Python 3.10 or higher** - Download from https://www.python.org/
+1. **Python 3.10, 3.11, 3.12, or 3.13** - Download from https://www.python.org/
    - ⚠️ **IMPORTANT**: Check "Add Python to PATH" during installation
+   - ⚠️ **Note**: Python 3.14+ may have compatibility issues with Kivy 2.2.1
    - Verify: Open Command Prompt and type `python --version`
 
 2. **Git** (optional, for cloning the repository)
@@ -127,7 +128,17 @@ You can:
 - Make sure dependencies installed correctly: `pip install kivy==2.2.1`
 - Check internet connection
 
-### Error: "LabelPrinter.exe won't start"
+### Python 3.14 Compatibility Issues
+If you have Python 3.14 installed and get errors like:
+- `ModuleNotFoundError: No module named 'kivy'`
+- `ImportError: DLL load failed`
+- PyInstaller compatibility errors
+
+**Solution:**
+- Install Python 3.11, 3.12, or 3.13 instead
+- Download from: https://www.python.org/downloads/
+- Uninstall Python 3.14 first
+- Then use one of the recommended versions
 - Make sure all files are in the project folder:
   - `label_printer_gui.py`
   - `print_label.py`
diff --git a/build_windows.bat b/build_windows.bat
index 7300d3b..b44421e 100644
--- a/build_windows.bat
+++ b/build_windows.bat
@@ -1,7 +1,8 @@
 @echo off
 REM Label Printer - Windows Build Script (Single File EXE)
 REM This script builds a standalone LabelPrinter.exe on Windows
-REM Requirements: Python 3.10+ installed and in PATH
+REM Requirements: Python 3.10-3.13 installed and in PATH
+REM Note: Python 3.14+ may have compatibility issues
 
 setlocal enabledelayedexpansion
 
@@ -16,7 +17,7 @@ REM Check if Python is installed
 python --version >nul 2>&1
 if errorlevel 1 (
     echo ERROR: Python is not installed or not in PATH
-    echo Please install Python 3.10+ from https://www.python.org/
+    echo Please install Python 3.10-3.13 from https://www.python.org/
     echo Make sure to check "Add Python to PATH" during installation
     pause
     exit /b 1
diff --git a/build_windows.ps1 b/build_windows.ps1
index ee60d16..51aee15 100644
--- a/build_windows.ps1
+++ b/build_windows.ps1
@@ -1,6 +1,7 @@
 # Label Printer - Windows Build Script (Single File EXE)
 # This script builds a standalone LabelPrinter.exe on Windows
-# Requirements: Python 3.10+ installed and in PATH
+# Requirements: Python 3.10-3.13 installed and in PATH
+# Note: Python 3.14+ may have compatibility issues
 
 Write-Host ""
 Write-Host "========================================================"
@@ -17,7 +18,7 @@ try {
     }
 } catch {
     Write-Host "ERROR: Python is not installed or not in PATH" -ForegroundColor Red
-    Write-Host "Please install Python 3.10+ from https://www.python.org/"
+    Write-Host "Please install Python 3.10-3.13 from https://www.python.org/"
     Write-Host "Make sure to check 'Add Python to PATH' during installation"
     Read-Host "Press Enter to exit"
     exit 1