feat: Phase 3 - Polish & Academic Aesthetic

- Add app icon (book with flowing document design)
- Add window icon and taskbar icon
- Add animated glow effects on drop zone
- Add pulse animation for idle drop zone
- Add click-to-browse functionality
- Add system tray integration with minimize-to-tray
- Add tray menu with watch folder toggle
- Update PyInstaller spec with icon

Author: logando-al

biblioflow.spec

@@ -17,7 +17,9 @@ a = Analysis(
     pathex=[project_root],
     binaries=[],
     datas=[
-        ('src/assets/styles.qss', 'src/assets'),
+        ('src/assets/styles.qss', 'assets'),
+        ('src/assets/icon.png', 'assets'),
+        ('src/assets/icon.ico', 'assets'),
     ],
     hiddenimports=[
         'PyQt6.QtCore',
@@ -62,6 +64,6 @@ exe = EXE(
     target_arch=None,
     codesign_identity=None,
     entitlements_file=None,
-    icon=None,  # Add icon path here when available
+    icon='src/assets/icon.ico',
     version=None,  # Can add version info file
 )

setup.ps1

@@ -21,7 +21,7 @@ Write-Host "[3/4] Installing dependencies..." -ForegroundColor Yellow
 pip install -r requirements.txt -r requirements-dev.txt --quiet
 
 Write-Host "[4/4] Verifying installation..." -ForegroundColor Yellow
-python -c "import PyQt6; print('PyQt6:', PyQt6.__version__)"
+python -c "from PyQt6.QtCore import PYQT_VERSION_STR; print('PyQt6:', PYQT_VERSION_STR)"
 
 Write-Host "`n Setup complete!" -ForegroundColor Green
 Write-Host "`nTo run the app:" -ForegroundColor Cyan

src/assets/icon.ico

@@ -25,6 +25,7 @@
 from .settings import SettingsPanel
 from .queue_widget import QueueWidget
 from .preview_card import PreviewCard
+from .system_tray import SystemTray
 
 
 class UpdateWorker(QThread):
@@ -67,6 +68,7 @@ def __init__(self):
         super().__init__()
         self.setWindowTitle(f"{APP_NAME} v{__version__}")
         self.setMinimumSize(1000, 700)
+        self._set_window_icon()
 
         # Initialize core components
         self.config = ConfigManager()
@@ -82,10 +84,27 @@ def __init__(self):
         self._apply_styles()
         self._connect_signals()
         self._setup_watcher()
+        self._setup_system_tray()
 
         if self.config.get("check_updates_on_startup", True):
             self._check_for_updates()
 
+    def _set_window_icon(self):
+        """Set the application window icon."""
+        import sys
+        from PyQt6.QtGui import QIcon
+        if getattr(sys, 'frozen', False):
+            # Running as compiled executable
+            import os
+            base_path = sys._MEIPASS
+            icon_path = os.path.join(base_path, 'assets', 'icon.png')
+        else:
+            # Running from source
+            import os
+            icon_path = os.path.join(os.path.dirname(__file__), '..', 'assets', 'icon.png')
+        if os.path.exists(icon_path):
+            self.setWindowIcon(QIcon(icon_path))
+
     def _setup_ui(self):
         """Initialize UI components."""
         central = QWidget()
@@ -235,6 +254,51 @@ def _setup_watcher(self):
                 self.watcher.start()
                 self._show_status(f"Watching: {path}")
 
+    def _setup_system_tray(self):
+        """Setup system tray icon."""
+        self.system_tray = SystemTray(self)
+        self.system_tray.show_window.connect(self._show_from_tray)
+        self.system_tray.quit_app.connect(self._quit_app)
+        self.system_tray.toggle_watch.connect(self._on_tray_watch_toggled)
+        self.system_tray.set_watch_enabled(self.config.is_watch_folder_enabled())
+        if self.system_tray.is_available:
+            self.system_tray.show()
+
+    def _show_from_tray(self):
+        """Show window from system tray."""
+        self.showNormal()
+        self.activateWindow()
+        self.raise_()
+
+    def _quit_app(self):
+        """Quit the application."""
+        self.system_tray.hide()
+        QApplication.quit()
+
+    def _on_tray_watch_toggled(self, enabled: bool):
+        """Handle watch folder toggle from tray."""
+        if enabled:
+            path = self.config.get_watch_folder_path()
+            if path and os.path.isdir(path):
+                self.watcher.set_watch_path(path)
+                self.watcher.start()
+                self.system_tray.show_message("Watch Folder", f"Watching: {path}")
+        else:
+            self.watcher.stop()
+            self.system_tray.show_message("Watch Folder", "Disabled")
+
+    def closeEvent(self, event):
+        """Minimize to tray instead of closing."""
+        if self.system_tray.is_available:
+            event.ignore()
+            self.hide()
+            self.system_tray.show_message(
+                "BiblioFlow",
+                "Running in background. Double-click tray icon to restore."
+            )
+        else:
+            event.accept()
+
     def _switch_view(self, index: int):
         """Switch to a different view."""
         self.content_stack.setCurrentIndex(index)

src/assets/icon.png

@@ -1,48 +1,96 @@
 """
 Drag-and-Drop Zone Widget
 
-Handles PDF file drops for processing.
+Handles PDF file drops with animated glow effects.
 """
-from PyQt6.QtWidgets import QWidget, QVBoxLayout, QLabel
-from PyQt6.QtCore import Qt, pyqtSignal
-from PyQt6.QtGui import QDragEnterEvent, QDropEvent
+from PyQt6.QtWidgets import QWidget, QVBoxLayout, QLabel, QGraphicsDropShadowEffect, QFileDialog
+from PyQt6.QtCore import Qt, pyqtSignal, QPropertyAnimation, QEasingCurve, QTimer, pyqtProperty
+from PyQt6.QtGui import QDragEnterEvent, QDropEvent, QColor, QMouseEvent
 import qtawesome as qta
 
 
 class DropZone(QWidget):
-    """Widget for drag-and-drop PDF files."""
+    """Widget for drag-and-drop PDF files with animated glow effects."""
 
     files_dropped = pyqtSignal(list)  # List of file paths
 
     def __init__(self):
         super().__init__()
         self.setAcceptDrops(True)
+        self._glow_intensity = 0.0
         self._setup_ui()
+        self._setup_glow_effect()
+        self._setup_animations()
 
     def _setup_ui(self):
         """Initialize UI."""
         layout = QVBoxLayout(self)
         layout.setAlignment(Qt.AlignmentFlag.AlignCenter)
 
         # Icon
-        icon_label = QLabel()
-        icon_label.setPixmap(qta.icon('fa5s.cloud-upload-alt', color='#3B82F6').pixmap(64, 64))
-        icon_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
-        layout.addWidget(icon_label)
+        self.icon_label = QLabel()
+        self.icon_label.setPixmap(qta.icon('fa5s.cloud-upload-alt', color='#3B82F6').pixmap(64, 64))
+        self.icon_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        layout.addWidget(self.icon_label)
 
         # Text
-        text = QLabel("Drop PDF files here")
-        text.setStyleSheet("font-size: 18px; color: #A0A0A0; margin-top: 10px;")
-        text.setAlignment(Qt.AlignmentFlag.AlignCenter)
-        layout.addWidget(text)
+        self.text_label = QLabel("Drop PDF files here")
+        self.text_label.setStyleSheet("font-size: 18px; color: #A0A0A0; margin-top: 10px;")
+        self.text_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        layout.addWidget(self.text_label)
 
-        subtext = QLabel("or click to browse")
-        subtext.setStyleSheet("font-size: 14px; color: #666;")
-        subtext.setAlignment(Qt.AlignmentFlag.AlignCenter)
-        layout.addWidget(subtext)
+        self.subtext_label = QLabel("or click to browse")
+        self.subtext_label.setStyleSheet("font-size: 14px; color: #666;")
+        self.subtext_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        layout.addWidget(self.subtext_label)
 
         self._apply_styles()
 
+    def _setup_glow_effect(self):
+        """Setup the glow drop shadow effect."""
+        self.glow_effect = QGraphicsDropShadowEffect(self)
+        self.glow_effect.setBlurRadius(0)
+        self.glow_effect.setColor(QColor(59, 130, 246, 180))  # #3B82F6 with alpha
+        self.glow_effect.setOffset(0, 0)
+        self.setGraphicsEffect(self.glow_effect)
+
+    def _setup_animations(self):
+        """Setup glow animations."""
+        # Glow pulse animation for idle state
+        self.pulse_timer = QTimer(self)
+        self.pulse_timer.timeout.connect(self._pulse_glow)
+        self.pulse_direction = 1
+        self.pulse_timer.start(50)  # 50ms intervals for smooth animation
+
+        # Drag hover animation
+        self.glow_animation = QPropertyAnimation(self, b"glowIntensity")
+        self.glow_animation.setDuration(200)
+        self.glow_animation.setEasingCurve(QEasingCurve.Type.OutCubic)
+
+    def _pulse_glow(self):
+        """Subtle idle pulse effect."""
+        if hasattr(self, '_is_dragging') and self._is_dragging:
+            return  # Don't pulse during drag
+
+        current = self.glow_effect.blurRadius()
+        step = 0.5 * self.pulse_direction
+
+        if current >= 15:
+            self.pulse_direction = -1
+        elif current <= 5:
+            self.pulse_direction = 1
+
+        self.glow_effect.setBlurRadius(max(0, current + step))
+
+    @pyqtProperty(float)
+    def glowIntensity(self):
+        return self._glow_intensity
+
+    @glowIntensity.setter
+    def glowIntensity(self, value):
+        self._glow_intensity = value
+        self.glow_effect.setBlurRadius(value)
+
     def _apply_styles(self):
         """Apply drop zone styles."""
         self.setStyleSheet("""
@@ -54,30 +102,65 @@ def _apply_styles(self):
             }
             DropZone:hover {
                 border-color: #60A5FA;
+                background-color: #1E293B;
+            }
+            DropZone[dragging="true"] {
+                border: 3px solid #60A5FA;
                 background-color: #1E3A5F;
             }
         """)
 
+    def _animate_glow_in(self):
+        """Animate glow when dragging over."""
+        self.glow_animation.stop()
+        self.glow_animation.setStartValue(self.glow_effect.blurRadius())
+        self.glow_animation.setEndValue(40)
+        self.glow_animation.start()
+        self.glow_effect.setColor(QColor(96, 165, 250, 220))  # Brighter blue
+
+    def _animate_glow_out(self):
+        """Animate glow back to normal."""
+        self.glow_animation.stop()
+        self.glow_animation.setStartValue(self.glow_effect.blurRadius())
+        self.glow_animation.setEndValue(10)
+        self.glow_animation.start()
+        self.glow_effect.setColor(QColor(59, 130, 246, 180))
+
     def dragEnterEvent(self, event: QDragEnterEvent):
-        """Handle drag enter."""
+        """Handle drag enter with glow animation."""
         if event.mimeData().hasUrls():
-            # Check if any URLs are PDFs
             for url in event.mimeData().urls():
                 if url.toLocalFile().lower().endswith('.pdf'):
                     event.acceptProposedAction()
+                    self._is_dragging = True
                     self.setProperty("dragging", True)
                     self.style().polish(self)
+                    self._animate_glow_in()
+                    # Update icon color
+                    self.icon_label.setPixmap(
+                        qta.icon('fa5s.cloud-upload-alt', color='#60A5FA').pixmap(72, 72)
+                    )
                     return
 
     def dragLeaveEvent(self, event):
         """Handle drag leave."""
+        self._is_dragging = False
         self.setProperty("dragging", False)
         self.style().polish(self)
+        self._animate_glow_out()
+        self.icon_label.setPixmap(
+            qta.icon('fa5s.cloud-upload-alt', color='#3B82F6').pixmap(64, 64)
+        )
 
     def dropEvent(self, event: QDropEvent):
         """Handle file drop."""
+        self._is_dragging = False
         self.setProperty("dragging", False)
         self.style().polish(self)
+        self._animate_glow_out()
+        self.icon_label.setPixmap(
+            qta.icon('fa5s.cloud-upload-alt', color='#3B82F6').pixmap(64, 64)
+        )
 
         pdf_files = []
         for url in event.mimeData().urls():
@@ -87,3 +170,15 @@ def dropEvent(self, event: QDropEvent):
 
         if pdf_files:
             self.files_dropped.emit(pdf_files)
+
+    def mousePressEvent(self, event: QMouseEvent):
+        """Handle click to open file dialog."""
+        if event.button() == Qt.MouseButton.LeftButton:
+            files, _ = QFileDialog.getOpenFileNames(
+                self,
+                "Select PDF Files",
+                "",
+                "PDF Files (*.pdf)"
+            )
+            if files:
+                self.files_dropped.emit(files)