fix: Add PyInstaller spec file and improve telegram_selector inclusion

- Create main.spec file with explicit hidden imports
- Improve hook file to use collect_submodules
- Add try/except fallback in widgets __init__.py
- Update BUILD_INSTRUCTIONS.md with spec file as recommended method
- Ensures telegram_selector is always included in PyInstaller builds

Author: VoxHash

BUILD_INSTRUCTIONS.md

@@ -4,59 +4,60 @@
 
 The `telegram_selector` module must be explicitly included when building with PyInstaller.
 
-### Option 1: Use the Hook File (Recommended)
+### Option 1: Use the Spec File (Recommended)
 
-The project includes a PyInstaller hook file at `hooks/hook-app.gui.widgets.telegram_selector.py`.
-
-When building with PyInstaller, use the `--additional-hooks-dir` flag:
+The project includes a `main.spec` file that explicitly includes all necessary modules.
 
+Build with:
 ```bash
-pyinstaller --additional-hooks-dir=hooks main.py
+pyinstaller main.spec
 ```
 
-### Option 2: Use Hidden Imports
+For Windows (console version), edit `main.spec` and change `console=False` to `console=True`.
 
-Alternatively, you can use the `--hidden-import` flag:
+### Option 2: Use the Hook File
 
-```bash
-pyinstaller --hidden-import=app.gui.widgets.telegram_selector main.py
-```
-
-### Option 3: Create a Spec File
-
-Create a `main.spec` file with hidden imports:
+The project includes a PyInstaller hook file at `hooks/hook-app.gui.widgets.telegram_selector.py`.
 
-```python
-# -*- mode: python ; coding: utf-8 -*-
+When building with PyInstaller, use the `--additional-hooks-dir` flag:
 
-a = Analysis(
-    ['main.py'],
-    pathex=[],
-    binaries=[],
-    datas=[],
-    hiddenimports=['app.gui.widgets.telegram_selector'],
-    hookspath=['hooks'],
-    ...
-)
+```bash
+pyinstaller --onefile --noconsole --additional-hooks-dir=hooks --hidden-import=app.gui.widgets.telegram_selector main.py
 ```
 
-Then build with:
+### Option 3: Use Hidden Imports Only
+
 ```bash
-pyinstaller main.spec
+pyinstaller --onefile --noconsole --hidden-import=app.gui.widgets.telegram_selector main.py
 ```
 
-## Complete Build Command Example
+## Complete Build Command Example (Windows)
 
 ```bash
 pyinstaller \
     --name=telegram-multi-account-sender \
     --onefile \
-    --windowed \
+    --noconsole \
     --icon=assets/icons/favicon.ico \
     --additional-hooks-dir=hooks \
     --hidden-import=app.gui.widgets.telegram_selector \
+    --hidden-import=PyQt5 \
+    --hidden-import=PyQt5.QtCore \
+    --hidden-import=PyQt5.QtGui \
+    --hidden-import=PyQt5.QtWidgets \
     --add-data "app/translations;app/translations" \
     --add-data "assets;assets" \
     main.py
 ```
 
+## Troubleshooting
+
+If you still get the "No module named 'app.gui.widgets.telegram_selector'" error:
+
+1. **Use the spec file**: `pyinstaller main.spec` (most reliable)
+2. **Check the hooks directory**: Ensure `hooks/hook-app.gui.widgets.telegram_selector.py` exists
+3. **Verify the file exists**: Check that `app/gui/widgets/telegram_selector.py` exists
+4. **Clean build**: Delete `build/` and `dist/` directories, then rebuild
+5. **Check PyInstaller version**: Ensure you're using a recent version of PyInstaller
+
+

app/gui/widgets/__init__.py

@@ -2,8 +2,12 @@
 Reusable GUI widgets for the application.
 """
 
-# Import telegram_selector first to ensure PyInstaller includes it
-from .telegram_selector import TelegramSelectorDialog
+# Import telegram_selector first using absolute import to ensure PyInstaller includes it
+try:
+    from app.gui.widgets.telegram_selector import TelegramSelectorDialog
+except ImportError:
+    # Fallback for relative import if absolute fails
+    from .telegram_selector import TelegramSelectorDialog
 
 from .account_widget import AccountWidget, AccountListWidget
 from .campaign_widget import CampaignWidget, CampaignListWidget

hooks/hook-app.gui.widgets.telegram_selector.py

@@ -4,7 +4,7 @@
 This ensures the telegram_selector module is included in PyInstaller builds.
 """
 
-from PyInstaller.utils.hooks import collect_all
+from PyInstaller.utils.hooks import collect_all, collect_submodules
 
 # Collect all dependencies for the telegram_selector module
 datas, binaries, hiddenimports = collect_all('app.gui.widgets.telegram_selector')
@@ -13,5 +13,10 @@
 hiddenimports += [
     'app.gui.widgets.telegram_selector',
     'app.gui.widgets.telegram_selector.TelegramSelectorDialog',
+    'telegram_selector',  # Also try without full path
 ]
 
+# Collect any submodules
+hiddenimports += collect_submodules('app.gui.widgets.telegram_selector')
+
+