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

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

@@ -13,6 +13,7 @@ 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

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/.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.2}/CHANGELOG.md

@@ -3,6 +3,18 @@
 
 ---
 
+## 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.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tbr-deal-finder
-Version: 0.3.1
+Version: 0.3.2
 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.2/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.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tbr-deal-finder"
-version = "0.3.1"
+version = "0.3.2"
 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"

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/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.2}/tbr_deal_finder/__init__.py

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

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

@@ -26,6 +26,7 @@ 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
         
         # Initialize pages
         self.settings_page = SettingsPage(self)
@@ -258,6 +259,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]
@@ -289,6 +300,23 @@ class TBRDealFinderApp:
         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"""
         if self.config is None and self.current_page != "settings":
@@ -309,6 +337,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),

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/tbr_deal_finder/gui/pages/all_books.py

@@ -39,6 +39,9 @@ class AllBooksPage(BaseBookPage):
 
     async def _async_load_items(self):
         """Load TBR books asynchronously using Flet's async support"""
+        # Disable navigation during the loading operation
+        self.app.disable_navigation()
+        
         try:
             # Run the async operation directly
             await self.app.auth_all_configured_retailers()
@@ -50,6 +53,10 @@ class AllBooksPage(BaseBookPage):
             self.filtered_items = []
         finally:
             self.set_loading(False)
+            
+            # Re-enable navigation after the operation completes
+            self.app.enable_navigation()
+            
             # Update the page to reflect the loaded data
             self.app.page.update()
 

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/tbr_deal_finder/gui/pages/base_book_page.py

@@ -142,8 +142,7 @@ class BaseBookPage(ABC):
             item_tiles.append(tile)
         
         return ft.Container(
-            content=ft.ListView(item_tiles, spacing=5),
-            height=700,
+            content=ft.Column(item_tiles, spacing=5),
             border=ft.border.all(1, ft.Colors.OUTLINE),
             border_radius=8,
             padding=10

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/tbr_deal_finder/gui/pages/latest_deals.py

@@ -274,6 +274,9 @@ class LatestDealsPage(BaseBookPage):
         self.progress_container.visible = True
         self.run_button.disabled = True
         
+        # Disable navigation during the operation
+        self.app.disable_navigation()
+        
         # Update the page to show loading state
         self.app.page.update()
         
@@ -299,6 +302,9 @@ class LatestDealsPage(BaseBookPage):
             self.run_button.disabled = False
             self.check_last_run()  # Refresh the status
             
+            # Re-enable navigation after the operation
+            self.app.enable_navigation()
+            
             # Update the page to reset loading state
             self.app.page.update()
             

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/tbr_deal_finder/gui/pages/settings.py

@@ -309,6 +309,7 @@ class SettingsPage:
             clear_unknown_books()
             
             self.show_success("Configuration saved successfully!")
+            self.app.enable_navigation()
             self.app.config_updated(self.config)
             
         except Exception as ex:

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/tbr_deal_finder/retailer_deal.py

@@ -2,16 +2,14 @@ import asyncio
 import copy
 from collections import defaultdict
 
-import click
 import pandas as pd
-from tqdm.asyncio import tqdm_asyncio
 
 from tbr_deal_finder.book import Book, get_active_deals, BookFormat
 from tbr_deal_finder.config import Config
 from tbr_deal_finder.tracked_books import get_tbr_books, get_unknown_books, set_unknown_books
 from tbr_deal_finder.retailer import RETAILER_MAP
 from tbr_deal_finder.retailer.models import Retailer
-from tbr_deal_finder.utils import get_duckdb_conn, echo_info, echo_err, is_gui_env
+from tbr_deal_finder.utils import get_duckdb_conn, echo_info, echo_err
 
 
 def update_retailer_deal_table(config: Config, new_deals: list[Book]):
@@ -67,6 +65,13 @@ async def _get_books(
     Returns:
         List of Book objects with updated pricing and availability
     """
+
+    echo_info(f"Getting deals from {retailer.name}")
+    books = _get_retailer_relevant_tbr_books(
+        retailer,
+        books,
+    )
+
     semaphore = asyncio.Semaphore(retailer.max_concurrency)
     response = []
     unknown_books = []
@@ -81,11 +86,7 @@ async def _get_books(
         if book.deal_id not in ignored_deal_ids
     ]
 
-    if is_gui_env():
-        results = await asyncio.gather(*tasks)
-    else:
-        results = await tqdm_asyncio.gather(*tasks, desc=f"Getting latest prices from {retailer.name}")
-
+    results = await asyncio.gather(*tasks)
     for book in results:
         if not book:
             """Cases where we know the retailer has the book but it's not coming back.
@@ -99,9 +100,7 @@ async def _get_books(
         elif not book.exists:
             unknown_books.append(book)
 
-    click.echo()
-    for book in unknown_books:
-        echo_info(f"{book.title} by {book.authors} not found")
+    echo_info(f"Finished getting deals from {retailer.name}")
 
     return response, unknown_books
 
@@ -184,34 +183,26 @@ async def _get_latest_deals(config: Config):
     ignore_books: list[Book] = get_unknown_books(config)
     ignored_deal_ids: set[str] = {book.deal_id for book in ignore_books}
 
+    tasks = []
     for retailer_str in config.tracked_retailers:
         retailer = RETAILER_MAP[retailer_str]()
         await retailer.set_auth()
 
-        relevant_tbr_books = _get_retailer_relevant_tbr_books(
-            retailer,
-            tbr_books,
+        tasks.append(
+            _get_books(
+                config,
+                retailer,
+                tbr_books,
+                ignored_deal_ids
+            )
         )
 
-        echo_info(f"Getting deals from {retailer.name}")
-        click.echo("\n---------------")
-        retailer_books, u_books = await _get_books(
-            config,
-            retailer,
-            relevant_tbr_books,
-            ignored_deal_ids
-        )
+    results = await asyncio.gather(*tasks)
+    for retailer_books, u_books in results:
         books.extend(retailer_books)
         unknown_books.extend(u_books)
-        click.echo("---------------\n")
 
     _apply_proper_list_prices(books)
-
-    books = [
-        book
-        for book in books
-    ]
-
     update_retailer_deal_table(config, books)
     set_unknown_books(config, unknown_books)
 

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/tbr_deal_finder/utils.py

@@ -27,25 +27,34 @@ def get_data_dir() -> Path:
     app_name = "TBR Deal Finder"
 
     if custom_path := os.getenv("TBR_DEAL_FINDER_CUSTOM_PATH"):
-        path = Path(custom_path)
-
-    elif not is_gui_env():
-        path = Path.home() / ".tbr_deal_finder"
-
-    elif sys.platform == "win32":
-        # Windows: C:\Users\Username\AppData\Local\AppAuthor\AppName
-        base = os.environ.get("LOCALAPPDATA", os.path.expanduser("~\\AppData\\Local"))
-        path = Path(base) / app_author / app_name
-
-    elif sys.platform == "darwin":
-        # macOS: ~/Library/Application Support/AppName
-        path = Path.home() / "Library" / "Application Support" / app_name
-
-    else:  # Linux and others
-        # Linux: ~/.local/share/appname (following XDG spec)
-        xdg_data_home = os.environ.get("XDG_DATA_HOME",
-                                       os.path.expanduser("~/.local/share"))
-        path = Path(xdg_data_home) / app_name.lower()
+        path = Path(custom_path).expanduser()
+    else:
+        cli_path = Path.home() / ".tbr_deal_finder"
+        if sys.platform == "win32":
+            # Windows: C:\Users\Username\AppData\Local\AppAuthor\AppName
+            base = os.environ.get("LOCALAPPDATA", os.path.expanduser("~\\AppData\\Local"))
+            gui_path = Path(base) / app_author / app_name
+
+        elif sys.platform == "darwin":
+            # macOS: ~/Library/Application Support/AppName
+            gui_path = Path.home() / "Library" / "Application Support" / app_name
+
+        else:  # Linux and others
+            # Linux: ~/.local/share/appname (following XDG spec)
+            xdg_data_home = os.environ.get("XDG_DATA_HOME",
+                                           os.path.expanduser("~/.local/share"))
+            gui_path = Path(xdg_data_home) / app_name.lower()
+
+        if is_gui_env():
+            path = gui_path
+            if cli_path.exists() and not path.exists():
+                # Use the cli path if it exists and the gui path does not
+                path = cli_path
+        else:
+            path = cli_path
+            if gui_path.exists() and not path.exists():
+                # Use the gui path if it exists and the cli path does not
+                path = gui_path
 
     # Create directory if it doesn't exist
     path.mkdir(parents=True, exist_ok=True)

{tbr_deal_finder-0.3.1 → tbr_deal_finder-0.3.2}/uv.lock

@@ -1181,7 +1181,7 @@ wheels = [
 
 [[package]]
 name = "tbr-deal-finder"
-version = "0.3.1"
+version = "0.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },

tbr_deal_finder-0.3.1/docs/desktop-app.md

@@ -1,251 +0,0 @@
-# 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"
-   - [Opening app from unknown developer](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
-
-#### 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
-
-#### Troubleshooting Windows
-- **Windows Defender blocks**: Click "More info" → "Run anyway"
-- **Still blocked**: Temporarily disable real-time protection, install, then re-enable
-
-### 🐧 Linux Installation
-
-#### Download & Install
-1. Go to the [latest release](https://github.com/yourusername/tbr-deal-finder/releases/latest)
-2. Download `TBRDealFinder-{version}-Linux`
-3. **Make Executable**: 
-   ```bash
-   chmod +x TBRDealFinder-{version}-Linux
-   ```
-4. **Move to Applications** (optional):
-   ```bash
-   sudo mv TBRDealFinder-{version}-Linux /usr/local/bin/tbr-deal-finder
-   ```
-5. **Launch**: 
-   ```bash
-   ./TBRDealFinder-{version}-Linux
-   # Or if moved: tbr-deal-finder
-   ```
-
-#### Create Desktop Entry (Linux)
-For easier launching, create a desktop entry:
-```bash
-cat > ~/.local/share/applications/tbr-deal-finder.desktop << EOF
-[Desktop Entry]
-Name=TBR Deal Finder
-Comment=Track price drops and find deals on books
-Exec=/path/to/TBRDealFinder-{version}-Linux
-Icon=applications-office
-Terminal=false
-Type=Application
-Categories=Office;Utility;
-EOF
-```
-
-## 🎯 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
-
-## 📖 Using the Desktop App
-
-### Main Interface
-
-#### 🆕 Latest Deals View
-- **Purpose**: Shows newly discovered deals since your last check
-- **Features**: Book covers, titles, authors, current and original prices
-- **Actions**: Click any book for detailed information and purchase links
-
-#### 📚 All Active Deals View  
-- **Purpose**: Browse all currently active deals
-- **Features**: Filter by retailer, price range, discount percentage
-- **Sorting**: By discount amount, price, or date discovered
-- **Best For**: Weekly browsing of all available deals
-
-#### 📖 All Books View
-- **Purpose**: Manage your tracked books library
-- **Features**: See all books being tracked for deals
-- **Actions**: Add new books or remove books from tracking
-- **Status**: See which books currently have active deals
-
-#### ⚙️ Settings View
-- **Configuration**: Update deal preferences and price limits
-- **Data Management**: Add new CSV files or update existing ones
-- **Notifications**: Configure how you want to be alerted about deals
-- **Account**: Manage your locale and retailer preferences
-
-### Navigation Tips
-- **Side Menu**: Quick switching between views
-- **Search Bar**: Find specific books or authors instantly  
-- **Filter Panel**: Narrow results by price, discount, or retailer
-- **Book Details**: Click any book for comprehensive information
-
-### Understanding Deal Information
-Each deal displays:
-- **Book cover and title**
-- **Author name(s)**
-- **Original price** vs **Sale price**
-- **Discount percentage** 
-- **Retailer** (Audible, Kindle, Chirp, Libro.fm)
-- **Deal expiration** (when available)
-
-## 🔄 Regular Usage Workflow
-
-### Daily Deal Checking (5 minutes)
-1. **Open the App**
-2. **Check Latest Deals View** 
-3. **Review New Discoveries**
-4. **Click Through** to purchase interesting deals
-
-### Weekly Management (15 minutes)  
-1. **Browse All Active Deals** for comprehensive view
-2. **Update Your Library** by adding new books to track
-3. **Remove Purchased Books** to keep library current
-4. **Adjust Settings** if your preferences have changed
-
-### Monthly Maintenance (30 minutes)
-1. **Export Fresh Reading Lists** from StoryGraph/Goodreads
-2. **Upload Updated CSVs** via Settings
-3. **Review Price Limits** and adjust for seasonal sales
-4. **Clean Up Library** by removing uninteresting books
-
-## 🔄 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`
-   - Linux: `TBRDealFinder-{version}-Linux`
-2. **Install Over Existing**: Follow same installation steps
-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
-- **Linux**: Verify file permissions (`chmod +x`)
-
-### 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
-- **Restart App**: Close and reopen to clear memory
-- **Update**: Ensure you're running the latest version
-- **System**: Close other applications to free resources
-
-### Settings Not Saving
-- **Permissions**: Ensure app can write to user directory
-- **Restart**: Close app completely and reopen
-- **Reinstall**: Download fresh copy if issues persist
-
-## 📊 System Requirements
-
-### Minimum Requirements
-- **macOS**: 10.14 or later
-- **Windows**: Windows 10 or later  
-- **Linux**: Modern distribution with GUI support
-
-## 💡 What Makes This App Special
-
-### Smart Deal Discovery
-- **Automated Searching**: Checks multiple retailers automatically
-- **Intelligent Matching**: Finds your books across different platforms
-- **Price Tracking**: Monitors for temporary sales and price drops
-
-### User-Friendly Design
-- **No Command Line**: Everything through visual interface
-- **Beautiful Interface**: Modern design with book covers
-- **Easy Setup**: Wizard guides you through configuration
-
-### Comprehensive Coverage
-- **Multiple Retailers**: Audible, Kindle, Chirp, Libro.fm
-- **Global Support**: Works in US, CA, UK, AU, FR, DE, JP, IT, IN, ES, BR
-- **Both Formats**: Audiobooks and ebooks in one place
-
-## 🆘 Getting Help
-
-### Self-Help Resources
-1. **Check This Guide**: Most questions are answered here
-2. **Try Troubleshooting**: Common issues have solutions above
-3. **Update App**: Many issues are fixed in newer versions
-
-### 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!** 📚💰