tbr-deal-finder 0.3.1__tar.gz → 0.3.3__tar.gz

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/.github/workflows/build-release-dmg.yml

@@ -13,11 +13,12 @@ jobs:
     env:
       HAS_MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE != '' }}
       HAS_MACOS_CERTIFICATE_PASSWORD: ${{ secrets.MACOS_CERTIFICATE_PASSWORD != '' }}
-    
+      VERSION: ${{ github.event.release.tag_name }}
+
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-        
+
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -25,7 +26,7 @@ jobs:
 
     - name: Install uv
       uses: astral-sh/setup-uv@v5
-        
+
     - name: Install project dependencies
       run: |
         uv sync
@@ -34,7 +35,7 @@ jobs:
       uses: maxim-lobanov/setup-xcode@v1
       with:
         xcode-version: latest-stable
-        
+
     - name: Set up CocoaPods
       uses: maxim-lobanov/setup-cocoapods@v1
       with:
@@ -43,44 +44,76 @@ jobs:
     - name: Import Code Signing Certificate (if available)
       if: ${{ env.HAS_MACOS_CERTIFICATE == 'true' && env.HAS_MACOS_CERTIFICATE_PASSWORD == 'true' }}
       run: |
+        set -e  # Exit on any error
+        
         # Create temporary keychain
-        security create-keychain -p "temp_keychain_password" temp.keychain
-        security default-keychain -s temp.keychain
-        security unlock-keychain -p "temp_keychain_password" temp.keychain
+        KEYCHAIN_PASSWORD="temp_keychain_password"
+        KEYCHAIN_NAME="temp.keychain-db"
+        
+        security create-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN_NAME"
+        security default-keychain -s "$KEYCHAIN_NAME"
+        security unlock-keychain -p "$KEYCHAIN_PASSWORD" "$KEYCHAIN_NAME"
+        security set-keychain-settings -t 3600 -u "$KEYCHAIN_NAME"
         
-        # Import certificate
+        # Decode PKCS12 certificate
         echo "${{ secrets.MACOS_CERTIFICATE }}" | base64 --decode > certificate.p12
-        security import certificate.p12 -k temp.keychain -P "${{ secrets.MACOS_CERTIFICATE_PASSWORD }}" -T /usr/bin/codesign
+        
+        # Verify file exists and has content
+        if [ ! -s certificate.p12 ]; then
+            echo "❌ Certificate file is empty or missing"
+            exit 1
+        fi
+        
+        # Import PKCS12 to keychain (specifying format explicitly is required)
+        echo "Importing certificate..."
+        security import certificate.p12 \
+            -k "$KEYCHAIN_NAME" \
+            -P "${{ secrets.MACOS_CERTIFICATE_PASSWORD }}" \
+            -f pkcs12 \
+            -T /usr/bin/codesign
         
         # Allow codesign to access the certificate
-        security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "temp_keychain_password" temp.keychain
+        security set-key-partition-list \
+            -S apple-tool:,apple:,codesign: \
+            -s \
+            -k "$KEYCHAIN_PASSWORD" \
+            "$KEYCHAIN_NAME" 2>/dev/null || true
         
         # Set code signing identity
         if [ -n "${{ secrets.CODESIGN_IDENTITY }}" ]; then
-            # Use provided identity name
             echo "CODESIGN_IDENTITY=${{ secrets.CODESIGN_IDENTITY }}" >> $GITHUB_ENV
             echo "✅ Code signing certificate imported: ${{ secrets.CODESIGN_IDENTITY }}"
         else
             # Auto-detect identity from certificate
-            CERT_IDENTITY=$(security find-identity -v -p codesigning temp.keychain | head -1 | grep -o '"[^"]*"' | tr -d '"')
+            CERT_IDENTITY=$(security find-identity -v -p codesigning "$KEYCHAIN_NAME" | grep -v "0 valid identities" | head -1 | awk -F'"' '{print $2}')
+            if [ -z "$CERT_IDENTITY" ]; then
+                # Fallback to any identity if no codesigning specific one found
+                CERT_IDENTITY=$(security find-identity -v "$KEYCHAIN_NAME" | grep -v "0 valid identities" | head -1 | awk -F'"' '{print $2}')
+            fi
+            
+            if [ -z "$CERT_IDENTITY" ]; then
+                echo "❌ No signing identity found"
+                exit 1
+            fi
+            
             echo "CODESIGN_IDENTITY=$CERT_IDENTITY" >> $GITHUB_ENV
             echo "✅ Code signing certificate imported (auto-detected): $CERT_IDENTITY"
         fi
         
-        # Clean up certificate file
+        # Clean up
         rm -f certificate.p12
-        
+
     - name: Build DMG
       run: |
         make build-mac
-        
+
     - name: Cleanup Code Signing
       if: ${{ env.HAS_MACOS_CERTIFICATE == 'true' && env.HAS_MACOS_CERTIFICATE_PASSWORD == 'true' }}
       run: |
         # Remove temporary keychain
         security delete-keychain temp.keychain || true
         echo "🧹 Cleaned up code signing keychain"
-        
+
     - name: Find and verify DMG was created
       id: find-dmg
       run: |
@@ -95,7 +128,7 @@ jobs:
         echo "✅ DMG file created successfully: $DMG_FILE"
         echo "dmg_path=$DMG_FILE" >> $GITHUB_OUTPUT
         echo "dmg_name=$(basename $DMG_FILE)" >> $GITHUB_OUTPUT
-        
+
     - name: Get DMG info
       id: dmg-info
       run: |
@@ -103,7 +136,7 @@ jobs:
         echo "size=$DMG_SIZE" >> $GITHUB_OUTPUT
         echo "📦 DMG Size: $DMG_SIZE"
         echo "📦 DMG Name: ${{ steps.find-dmg.outputs.dmg_name }}"
-        
+
     - name: Upload DMG to Release
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -111,5 +144,4 @@ jobs:
         gh release upload ${{ github.event.release.tag_name }} \
           "${{ steps.find-dmg.outputs.dmg_path }}" \
           --clobber \
-          --repo ${{ github.repository }}
-
+          --repo ${{ github.repository }}

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/.github/workflows/build-release-exe.yml

@@ -138,7 +138,7 @@ jobs:
         DefaultGroupName=${{ env.APP_DISPLAY_NAME }}
         AllowNoIcons=yes
         OutputDir=.
-        OutputBaseFilename=${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Setup
+        OutputBaseFilename=${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Windows-Setup
         SetupIconFile=assets\icon.ico
         Compression=lzma2/normal
         SolidCompression=no
@@ -184,13 +184,13 @@ jobs:
       with:
         certificate: '${{ secrets.WINDOWS_CERTIFICATE }}'
         password: '${{ secrets.WINDOWS_CERTIFICATE_PASSWORD }}'
-        files: '${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Setup.exe'
+        files: '${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Windows-Setup.exe'
 
     - name: Upload Installer to Release
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
-        $installerFile = "${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Setup.exe"
+        $installerFile = "${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Windows-Setup.exe"
         
         gh release upload ${{ github.event.release.tag_name }} `
           $installerFile `

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/CHANGELOG.md

@@ -3,6 +3,29 @@
 
 ---
 
+## 0.3.3 (September 10, 2025)
+
+Notes: 
+* Improved updater for Mac app
+
+BUG FIXES:
+* Fixed Mac app cert 
+* Fixed issue where pricing graph points were running off graph 
+
+---
+
+## 0.3.2 (September 8, 2025)
+
+Notes: 
+* Disable nav bar buttons when performing certain operations
+* Added config check to CLI location when running the desktop app for backwards compatibility
+* Improved performance when retrieving "latest deals"
+
+BUG FIXES:
+* Fixed issue with scroll bar in the "all deals" page
+
+---
+
 ## 0.3.1 (September 5, 2025)
 
 Notes: 

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/Makefile

@@ -31,7 +31,7 @@ BUILD_SCRIPT := scripts/packaging/build_cross_platform.py
 # Build self-signed macOS DMG (recommended)
 build-mac:
 	@echo "🍎 Building app"
-	uv run flet build macos --output ${DIST_DIR}/app/
+	NONINTERACTIVE=1 NO_COLOR=1 TERM=dumb CI=true uv run flet build macos --output ${DIST_DIR}/app/
 	@echo ""
 	@echo "📦 Creating self-signed macOS DMG for app"
 	bash scripts/packaging/create_dmg.sh

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tbr-deal-finder
-Version: 0.3.1
+Version: 0.3.3
 Summary: Track price drops and find deals on books in your TBR list across audiobook and ebook formats.
 License: MIT
 License-File: LICENSE

tbr_deal_finder-0.3.3/docs/desktop-app.md

@@ -0,0 +1,133 @@
+# Desktop App Guide
+
+Everything you need to know about installing, using, and updating the TBR Deal Finder desktop application.
+
+## Installation
+
+The desktop app provides a beautiful graphical interface for managing your book deals without any command line knowledge required.
+
+### 🍎 macOS Installation
+
+#### Download & Install
+1. Go to the [latest release](https://github.com/yourusername/tbr-deal-finder/releases/latest)
+2. Download `TBRDealFinder-{version}-macOS.dmg`
+3. **Open the DMG**: Double-click the downloaded `.dmg` file
+4. **Handle Security Warning**: macOS will show "Cannot verify developer"
+   - Click Done to handle the warning before continuing with the install
+   - [Follow guide from Apple](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac)
+5. **Install**: Drag the TBR Deal Finder app to your Applications folder
+6. **Launch**: Double-click the app in Applications
+7. **Wait for loader**: The app has a special loader and can take a minute to load for the first time
+
+#### Troubleshooting macOS
+- **"App can't be opened"**: Use right-click → Open instead of double-clicking
+- **Still getting warnings**: Go to System Preferences → Security & Privacy → General → Click "Open Anyway"
+
+### 🪟 Windows Installation
+
+#### Download & Install
+1. Go to the [latest release](https://github.com/yourusername/tbr-deal-finder/releases/latest)
+2. Download `TBRDealFinder-{version}-Windows.exe`
+3. **Run the Installer**: Double-click the downloaded `.exe` file
+4. **Handle Security Warning**: Windows will show "Unknown publisher"
+   - **Solution**: Click "More info" → Click "Run anyway"
+5. **Install**: Follow the installation wizard
+6. **Launch**: The app will be available in your Start Menu or Desktop
+7. **Wait for loader**: The app has a special loader and can take a minute to load for the first time
+
+#### Troubleshooting Windows
+- **Windows Defender blocks**: Click "More info" → "Run anyway"
+- **Still blocked**: Temporarily disable real-time protection, install, then re-enable
+
+## 🎯 First Time Setup
+
+### Getting Your Reading Lists
+Before using the app, export your reading lists:
+
+#### StoryGraph Export
+1. Open [StoryGraph](https://app.thestorygraph.com/)
+2. Click your profile icon → "Manage Account"
+3. Scroll to "Manage Your Data" → "Export StoryGraph Library"
+4. Click "Generate export" → Wait and refresh → Download CSV
+
+#### Goodreads Export  
+1. Visit [Goodreads Export](https://www.goodreads.com/review/import)
+2. Click "Export Library" → Wait for email → Download CSV
+
+#### Custom CSV
+Create your own with these columns:
+- `Title` (required)
+- `Authors` (required)
+- `Read Status` (optional: set to "to-read" for tracking)
+
+### Setup Wizard
+1. **Launch the App** for the first time
+2. **Follow the Setup Wizard**:
+   - Upload your CSV file(s)
+   - Select your country/region
+   - Set maximum price for deals  
+   - Set minimum discount percentage
+3. **Start Finding Deals**: The app begins searching automatically
+
+## 🔄 Updating the Desktop App
+
+### Checking for Updates
+Currently, updates require manual download:
+1. **Check Current Version**: Look in Settings/About section
+2. **Visit Releases**: Go to [latest releases](https://github.com/yourusername/tbr-deal-finder/releases/latest)
+3. **Compare Versions**: See if a newer version is available
+
+### Installing Updates
+
+#### All Platforms
+1. **Download Latest Version**:
+   - macOS: `TBRDealFinder-{version}-macOS.dmg`
+   - Windows: `TBRDealFinder-{version}-Windows.exe`
+2. **Install Over Existing**: Follow same installation steps
+   - If prompted, choose to replace files or overwrite the existing application
+3. **Preserve Settings**: Your configuration and data are automatically preserved
+4. **Verify Update**: Check version in Settings after installation
+
+## ❓ Troubleshooting
+
+### App Won't Launch
+- **macOS**: Right-click app → Open, check Security & Privacy settings
+- **Windows**: Run as administrator, check Windows Defender
+
+### No Deals Found
+- **Check CSV Format**: Ensure titles and authors are correct
+- **Adjust Filters**: Lower discount threshold or raise price limit
+- **Wait**: Deals fluctuate - check back regularly
+
+### Performance Issues
+#### Initial Run
+When the app initially starts the app may be white up to a minute while the tbr deal finder package loads.
+
+#### Getting latest deals
+Getting pricing info for Kindle can take up to a second per book.
+It doesn't sound like a lot, but if you have 400 books in your tbr it may take around 7 minutes.
+If you're not checking for deals on Kindle, getting deals should only take a couple minutes.
+Don't close the app while getting deals or progress may be lost.
+
+#### Still having issues
+- **Restart App**: Close and reopen to clear memory
+- **Update**: Ensure you're running the latest version
+- **System**: Close other applications to free resources
+
+## 🆘 Getting Help
+
+### Community Support
+1. **GitHub Issues**: [Report bugs or ask questions](https://github.com/yourusername/tbr-deal-finder/issues)
+2. **Search First**: Someone might have had the same issue
+3. **Provide Details**: Include OS version, error messages, screenshots
+
+### What to Include in Bug Reports
+- **Operating System**: macOS 12.1, Windows 11, Ubuntu 22.04, etc.
+- **App Version**: Found in Settings/About
+- **Error Messages**: Exact text of any errors
+- **Screenshots**: Visual problems are easier to diagnose
+- **Steps to Reproduce**: What you did when the problem occurred
+
+---
+
+**Ready to discover amazing book deals? Download the desktop app and start saving money on your reading list!** 📚💰

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tbr-deal-finder"
-version = "0.3.1"
+version = "0.3.3"
 description = "Track price drops and find deals on books in your TBR list across audiobook and ebook formats."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -30,6 +30,15 @@ product = "TBR Deal Finder"
 app.module = "tbr_deal_finder"
 app.path = "."
 
+# Dependency locks
+# Fix for https://github.com/flet-dev/flet/issues/5630
+android.min_sdk_version = 24
+
+[tool.flet.flutter.pubspec.dependency_overrides]
+# Dependency locks
+# Fix for https://github.com/flet-dev/flet/issues/5630
+webview_flutter_android = "4.10.1"
+
 [tool.setuptools.package-data]
 "tbr-deal-finder" = [
     "queries/**/*.sql",

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/scripts/packaging/create_dmg.sh

@@ -13,11 +13,14 @@
 
 DIST_DIR="gui_dist"
 APP_NAME="TBR Deal Finder"
-DMG_NAME="TBR-Deal-Finder-0.2.1"
+DMG_NAME="TBR-Deal-Finder-${VERSION#v}-mac"
 VOLUME_NAME="TBR Deal Finder"
 SOURCE_APP="${DIST_DIR}/app/${APP_NAME}.app"
 OUTPUT_DMG="${DIST_DIR}/${DMG_NAME}.dmg"
 
+echo "📋 Using version: ${VERSION}"
+echo "📦 DMG name will be: ${DMG_NAME}.dmg"
+
 # Determine signing approach
 if [ -z "$CODESIGN_IDENTITY" ]; then
     # Default to ad-hoc signing for local development

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/tbr_deal_finder/__init__.py

@@ -1,5 +1,5 @@
 from pathlib import Path
 
-__VERSION__ = "0.3.1"
+__VERSION__ = "0.3.3"
 
 QUERY_PATH = Path(__file__).parent.joinpath("queries")

tbr_deal_finder-0.3.3/tbr_deal_finder/desktop_updater.py

@@ -0,0 +1,71 @@
+"""
+Desktop application update checker and handler.
+For packaged desktop applications (.dmg/.exe).
+"""
+import json
+import logging
+import os
+import platform
+import subprocess
+import tempfile
+import webbrowser
+from pathlib import Path
+from typing import Optional, Dict, Any
+
+import requests
+from packaging import version
+
+from tbr_deal_finder import __VERSION__
+
+logger = logging.getLogger(__name__)
+
+class DesktopUpdater:
+    """Handle updates for packaged desktop applications."""
+    
+    def __init__(self, github_repo: str = "WillNye/tbr-deal-finder"):
+        self.github_repo = github_repo
+        self.current_version = __VERSION__
+        self.platform = platform.system().lower()
+        
+    def check_for_updates(self) -> Optional[Dict[str, Any]]:
+        """
+        Check GitHub releases for newer versions.
+        Returns dict with update info or None if no update available.
+        """
+        try:
+            # Check GitHub releases API
+            response = requests.get(
+                f"https://api.github.com/repos/{self.github_repo}/releases/latest",
+                timeout=5
+            )
+            response.raise_for_status()
+            
+            release_data = response.json()
+            latest_version = release_data["tag_name"].lstrip("v")
+            if version.parse(latest_version) > version.parse(self.current_version):
+                download_url = release_data["html_url"]
+                if self.platform == "darwin":
+                    for asset in release_data["assets"]:
+                        if asset["browser_download_url"].endswith(".dmg"):
+                            download_url = asset["browser_download_url"]
+
+                return {
+                    "version": latest_version,
+                    "download_url": download_url,
+                    "release_notes": release_data.get("body", ""),
+                }
+                
+            return None
+            
+        except Exception as e:
+            logger.error(f"Failed to check updates for {self.github_repo}: {e}")
+            return None
+
+
+# Global instance
+desktop_updater = DesktopUpdater()
+
+
+def check_for_desktop_updates() -> Optional[Dict[str, Any]]:
+    """Convenience function to check for updates."""
+    return desktop_updater.check_for_updates()

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.3}/tbr_deal_finder/gui/main.py

@@ -1,6 +1,10 @@
 import asyncio
 import os
 import base64
+import subprocess
+import sys
+from datetime import datetime
+from pathlib import Path
 
 import flet as ft
 
@@ -17,6 +21,7 @@ from tbr_deal_finder.gui.pages.all_deals import AllDealsPage
 from tbr_deal_finder.gui.pages.latest_deals import LatestDealsPage
 from tbr_deal_finder.gui.pages.all_books import AllBooksPage
 from tbr_deal_finder.gui.pages.book_details import BookDetailsPage
+from tbr_deal_finder.utils import get_duckdb_conn, get_latest_deal_last_ran
 
 
 class TBRDealFinderApp:
@@ -26,7 +31,9 @@ class TBRDealFinderApp:
         self.current_page = "all_deals"
         self.selected_book = None
         self.update_info = None  # Store update information
-        
+        self.nav_disabled = False  # Track navigation disabled state
+        self._last_run_time = None
+
         # Initialize pages
         self.settings_page = SettingsPage(self)
         self.all_deals_page = AllDealsPage(self)
@@ -258,6 +265,16 @@ class TBRDealFinderApp:
 
     def nav_changed(self, e):
         """Handle navigation rail selection changes"""
+        # Prevent navigation if disabled
+        if self.nav_disabled:
+            # Reset to current page selection to prevent visual change
+            current_indices = {"all_deals": 0, "latest_deals": 1, "all_books": 2}
+            self.nav_rail.selected_index = current_indices.get(self.current_page, 0)
+            # Reapply disabled state after page update
+            self.nav_rail.disabled = True
+            self.page.update()
+            return
+            
         destinations = ["all_deals", "latest_deals", "all_books"]
         if e.control.selected_index < len(destinations):
             self.current_page = destinations[e.control.selected_index]
@@ -284,10 +301,26 @@ class TBRDealFinderApp:
             self.all_books_page.refresh_page_state()
     
     def refresh_all_pages(self):
-        """Refresh all pages by clearing their state and reloading data"""
+        """Refresh all pages except all_books_page by clearing their state and reloading data"""
         self.all_deals_page.refresh_page_state()
         self.latest_deals_page.refresh_page_state()
-        self.all_books_page.refresh_page_state()
+
+    def disable_navigation(self):
+        """Disable navigation rail during background operations"""
+        self.nav_disabled = True
+        if hasattr(self, 'nav_rail'):
+            self.nav_rail.disabled = True
+            self.page.update()
+
+    def enable_navigation(self):
+        """Enable navigation rail after background operations complete"""
+        if not self.nav_disabled:
+            return
+
+        self.nav_disabled = False
+        if hasattr(self, 'nav_rail'):
+            self.nav_rail.disabled = False
+            self.page.update()
 
     def get_current_page_content(self):
         """Get content for the current page"""
@@ -309,6 +342,7 @@ class TBRDealFinderApp:
 
     def get_config_prompt(self):
         """Show config setup prompt when no config exists"""
+        self.disable_navigation()
         return ft.Container(
             content=ft.Column([
                 ft.Icon(ft.Icons.SETTINGS, size=64, color=ft.Colors.GREY_400),
@@ -592,10 +626,6 @@ class TBRDealFinderApp:
         def close_dialog(e):
             dialog.open = False
             self.page.update()
-        
-        def view_release_and_close(e):
-            self.view_release_notes(e)
-            close_dialog(e)
             
         def download_and_close(e):
             self.download_update(e)
@@ -609,10 +639,13 @@ class TBRDealFinderApp:
             ], spacing=10),
             content=ft.Column([
                 ft.Text(f"Version {self.update_info['version']} is now available!"),
-                ft.Text("Would you like to download the update?", color=ft.Colors.GREY_600)
-            ], spacing=10, tight=True),
+                ft.Divider(),
+                ft.Text(
+                    self.update_info.get('release_notes', 'No release notes available.'),
+                    selectable=True
+                ),
+            ], scroll=ft.ScrollMode.AUTO, spacing=10, tight=True),
             actions=[
-                ft.TextButton("View Release Notes", on_click=view_release_and_close),
                 ft.ElevatedButton("Download Update", on_click=download_and_close),
                 ft.TextButton("Later", on_click=close_dialog),
             ],
@@ -646,24 +679,36 @@ class TBRDealFinderApp:
         dialog.open = True
         self.page.update()
 
-    def view_release_notes(self, e):
-        """Open release notes in browser."""
-        if self.update_info:
-            import webbrowser
-            webbrowser.open(self.update_info['release_url'])
-
     def download_update(self, e):
         """Handle update download."""
         if not self.update_info or not self.update_info.get('download_url'):
             return
-        
-        # For now, open download URL in browser
-        # In a more advanced implementation, you could download in-app
-        import webbrowser
-        webbrowser.open(self.update_info['download_url'])
-        
-        # Show download instructions
-        self.show_download_instructions()
+
+        if sys.platform == "darwin":
+            dmg_path = Path(
+                f"~/Downloads/TBR-Deal-Finder-{self.update_info['version']}-mac.dmg"
+            ).expanduser()
+
+            # Show download instructions
+            self.show_download_instructions()
+
+            if not dmg_path.exists():
+                # Using curl or urllib to download to prevent Mac warning
+                subprocess.run([
+                    "curl", "-L",
+                    self.update_info['download_url'],
+                    "-o", dmg_path
+                ])
+
+            subprocess.run(["open", dmg_path])
+        else:
+            # For now, open download URL in browser
+            # In a more advanced implementation, you could download in-app
+            import webbrowser
+            webbrowser.open(self.update_info['download_url'])
+
+            # Show download instructions
+            self.show_download_instructions()
 
     def show_download_instructions(self):
         """Show instructions for installing the downloaded update."""
@@ -672,7 +717,7 @@ class TBRDealFinderApp:
             self.page.update()
         
         instructions = {
-            "darwin": "1. Download will start in your browser\n2. Open the downloaded .dmg file\n3. Drag the app to Applications folder\n4. Restart the application",
+            "darwin": "1. Wait for the update to download (can take a minute or 2)\n2. Close TBR Deal Finder\n3. Once the installer opens, drag the app to Applications folder\n3. When prompted, select Replace\n4. Restart the application",
             "windows": "1. Download will start in your browser\n2. Run the downloaded .exe installer\n3. Follow the installation wizard\n4. Restart the application",
         }
         
@@ -703,12 +748,20 @@ class TBRDealFinderApp:
         dialog.open = True
         self.page.update()
 
-
-
     def check_for_updates_button(self):
         """Check for updates when button is clicked."""
         self.check_for_updates_manual()
 
+    def update_last_run_time(self):
+        db_conn = get_duckdb_conn()
+        self._last_run_time = get_latest_deal_last_ran(db_conn)
+
+    def get_last_run_time(self) -> datetime:
+        if not self._last_run_time:
+            self.update_last_run_time()
+
+        return self._last_run_time
+
 
 def main():
     """Main entry point for the GUI application"""