fix: Ensure telegram_selector module is included in PyInstaller builds

- Move telegram_selector import to top of widgets/__init__.py
- Add explicit imports in main.py and app/gui/main.py
- Create PyInstaller hook file for telegram_selector module
- Add BUILD_INSTRUCTIONS.md with PyInstaller build guidance
- Fixes 'No module named app.gui.widgets.telegram_selector' error in executables

Author: VoxHash

BUILD_INSTRUCTIONS.md

@@ -0,0 +1,62 @@
+# Build Instructions for PyInstaller
+
+## Including telegram_selector Module
+
+The `telegram_selector` module must be explicitly included when building with PyInstaller.
+
+### Option 1: Use the Hook 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:
+
+```bash
+pyinstaller --additional-hooks-dir=hooks main.py
+```
+
+### Option 2: Use Hidden Imports
+
+Alternatively, you can use the `--hidden-import` flag:
+
+```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:
+
+```python
+# -*- mode: python ; coding: utf-8 -*-
+
+a = Analysis(
+    ['main.py'],
+    pathex=[],
+    binaries=[],
+    datas=[],
+    hiddenimports=['app.gui.widgets.telegram_selector'],
+    hookspath=['hooks'],
+    ...
+)
+```
+
+Then build with:
+```bash
+pyinstaller main.spec
+```
+
+## Complete Build Command Example
+
+```bash
+pyinstaller \
+    --name=telegram-multi-account-sender \
+    --onefile \
+    --windowed \
+    --icon=assets/icons/favicon.ico \
+    --additional-hooks-dir=hooks \
+    --hidden-import=app.gui.widgets.telegram_selector \
+    --add-data "app/translations;app/translations" \
+    --add-data "assets;assets" \
+    main.py
+```
+

app/gui/main.py

@@ -14,6 +14,8 @@
 from ..services import get_settings, get_logger
 from ..services.translation import get_translation_manager, _
 from .theme import ThemeManager
+# Explicitly import telegram_selector to ensure PyInstaller includes it
+from .widgets.telegram_selector import TelegramSelectorDialog
 from .widgets import AccountWidget, CampaignWidget, LogWidget, RecipientWidget, SettingsWidget, DashboardWidget, PluginWidget
 from .widgets.about_widget import AboutWidget
 

app/gui/widgets/__init__.py

@@ -2,6 +2,9 @@
 Reusable GUI widgets for the application.
 """
 
+# Import telegram_selector first to ensure PyInstaller includes it
+from .telegram_selector import TelegramSelectorDialog
+
 from .account_widget import AccountWidget, AccountListWidget
 from .campaign_widget import CampaignWidget, CampaignListWidget
 from .template_widget import TemplateWidget, TemplateListWidget
@@ -10,7 +13,6 @@
 from .log_widget import LogWidget, LogViewer
 from .settings_widget import SettingsWidget
 from .dashboard_widget import DashboardWidget
-from .telegram_selector import TelegramSelectorDialog
 from .plugin_widget import PluginWidget, PluginListWidget
 
 __all__ = [

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

@@ -0,0 +1,17 @@
+"""
+PyInstaller hook for app.gui.widgets.telegram_selector module.
+
+This ensures the telegram_selector module is included in PyInstaller builds.
+"""
+
+from PyInstaller.utils.hooks import collect_all
+
+# Collect all dependencies for the telegram_selector module
+datas, binaries, hiddenimports = collect_all('app.gui.widgets.telegram_selector')
+
+# Explicitly add the module to hidden imports
+hiddenimports += [
+    'app.gui.widgets.telegram_selector',
+    'app.gui.widgets.telegram_selector.TelegramSelectorDialog',
+]
+

main.py

@@ -13,6 +13,8 @@
 sys.path.insert(0, str(app_dir))
 
 from app.services import initialize_database, get_settings, get_logger, initialize_plugins
+# Explicitly import telegram_selector early to ensure PyInstaller includes it
+from app.gui.widgets.telegram_selector import TelegramSelectorDialog
 from app.gui.main import MainWindow
 
 # Import all models to ensure they are registered with SQLModel