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

tbr_deal_finder-0.3.1/.github/workflows/build-release-dmg.yml

@@ -0,0 +1,115 @@
+name: Build and Attach DMG to Release
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  contents: write
+  
+jobs:
+  build-dmg:
+    runs-on: macos-latest
+    env:
+      HAS_MACOS_CERTIFICATE: ${{ secrets.MACOS_CERTIFICATE != '' }}
+      HAS_MACOS_CERTIFICATE_PASSWORD: ${{ secrets.MACOS_CERTIFICATE_PASSWORD != '' }}
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+        
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+        
+    - name: Install project dependencies
+      run: |
+        uv sync
+
+    - name: Set up Xcode
+      uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: latest-stable
+        
+    - name: Set up CocoaPods
+      uses: maxim-lobanov/setup-cocoapods@v1
+      with:
+        version: latest
+
+    - name: Import Code Signing Certificate (if available)
+      if: ${{ env.HAS_MACOS_CERTIFICATE == 'true' && env.HAS_MACOS_CERTIFICATE_PASSWORD == 'true' }}
+      run: |
+        # 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
+        
+        # Import 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
+        
+        # Allow codesign to access the certificate
+        security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "temp_keychain_password" temp.keychain
+        
+        # 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 '"')
+            echo "CODESIGN_IDENTITY=$CERT_IDENTITY" >> $GITHUB_ENV
+            echo "✅ Code signing certificate imported (auto-detected): $CERT_IDENTITY"
+        fi
+        
+        # Clean up certificate file
+        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: |
+        ls -la gui_dist/
+        DMG_FILE=$(find gui_dist/ -name "*.dmg" -type f | head -1)
+        if [ -z "$DMG_FILE" ]; then
+          echo "❌ DMG file not found!"
+          echo "Contents of gui_dist/:"
+          ls -la gui_dist/ || echo "gui_dist/ directory not found"
+          exit 1
+        fi
+        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: |
+        DMG_SIZE=$(ls -lh "${{ steps.find-dmg.outputs.dmg_path }}" | awk '{print $5}')
+        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 }}
+      run: |
+        gh release upload ${{ github.event.release.tag_name }} \
+          "${{ steps.find-dmg.outputs.dmg_path }}" \
+          --clobber \
+          --repo ${{ github.repository }}
+

tbr_deal_finder-0.3.1/.github/workflows/build-release-exe.yml

@@ -0,0 +1,198 @@
+name: Build and Attach Windows EXE to Release
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  contents: write
+  
+jobs:
+  build-exe:
+    runs-on: windows-latest
+    env:
+      HAS_WINDOWS_CERTIFICATE: ${{ secrets.WINDOWS_CERTIFICATE != '' }}
+      HAS_WINDOWS_CERTIFICATE_PASSWORD: ${{ secrets.WINDOWS_CERTIFICATE_PASSWORD != '' }}
+      APP_DISPLAY_NAME: "TBR Deal Finder"
+      APP_FILENAME_BASE: "TBR-Deal-Finder"
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Flutter
+      uses: subosito/flutter-action@v2
+      with:
+        flutter-version: '3.29.2'
+        channel: 'stable'
+
+    - name: Enable Windows Desktop
+      run: flutter config --enable-windows-desktop
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+
+    - name: Install project dependencies
+      run: |
+        uv sync
+
+    - name: Import Code Signing Certificate (if available)
+      if: ${{ env.HAS_WINDOWS_CERTIFICATE == 'true' && env.HAS_WINDOWS_CERTIFICATE_PASSWORD == 'true' }}
+      run: |
+        # Decode and import certificate
+        $certBytes = [System.Convert]::FromBase64String("${{ secrets.WINDOWS_CERTIFICATE }}")
+        $certPath = "windows-cert.pfx"
+        [System.IO.File]::WriteAllBytes($certPath, $certBytes)
+        
+        # Import certificate to certificate store
+        $securePassword = ConvertTo-SecureString -String "${{ secrets.WINDOWS_CERTIFICATE_PASSWORD }}" -Force -AsPlainText
+        Import-PfxCertificate -FilePath $certPath -CertStoreLocation Cert:\CurrentUser\My -Password $securePassword
+        
+        Write-Output "✅ Code signing certificate imported successfully"
+        
+        # Clean up certificate file
+        Remove-Item $certPath -Force
+
+    - name: Build Windows EXE
+      env:
+        PYTHONIOENCODING: utf-8
+        PYTHONLEGACYWINDOWSFSENCODING: utf-8
+        # Disable Rich progress bars to avoid Unicode issues
+        TERM: dumb
+        NO_COLOR: 1
+      run: |
+        # Set console to UTF-8 to handle Unicode characters
+        chcp 65001
+        
+        # Clean any existing build cache to ensure fresh plugin compilation
+        Write-Output "🧹 Cleaning build cache..."
+        Remove-Item -Path "build" -Recurse -Force -ErrorAction SilentlyContinue
+        Remove-Item -Path "gui_dist" -Recurse -Force -ErrorAction SilentlyContinue
+        
+        # Use flet to build Windows executable (Flutter environment now properly set up)
+        Write-Output "🪟 Building Windows executable..."
+        uv run flet build windows --output gui_dist/ --verbose
+        
+        Write-Output "📁 Build output contents:"
+        Get-ChildItem -Path gui_dist -Recurse | Format-Table Name, Length, LastWriteTime
+
+    - name: Sign Windows EXE (if certificate available)
+      if: ${{ env.HAS_WINDOWS_CERTIFICATE == 'true' && env.HAS_WINDOWS_CERTIFICATE_PASSWORD == 'true' }}
+      uses: dlemstra/code-sign-action@v1
+      with:
+        certificate: '${{ secrets.WINDOWS_CERTIFICATE }}'
+        password: '${{ secrets.WINDOWS_CERTIFICATE_PASSWORD }}'
+        folder: 'gui_dist'
+        recursive: true
+
+    - name: Get App Info
+      id: app-info
+      run: |
+        # Find the EXE file
+        $exeFile = Get-ChildItem -Path "gui_dist" -Filter "*.exe" | Select-Object -First 1
+        if (-not $exeFile) {
+          Write-Output "❌ EXE file not found!"
+          exit 1
+        }
+        
+        $exeName = [System.IO.Path]::GetFileNameWithoutExtension($exeFile.Name)
+        $appVersion = "${{ github.event.release.tag_name }}".TrimStart('v')
+        
+        # Default to 1.0.0 if tag isn't semver
+        if (-not ($appVersion -match '^\d+\.\d+\.\d+')) {
+          $appVersion = "1.0.0"
+        }
+        
+        Write-Output "exe_name=$($exeFile.Name)" >> $env:GITHUB_OUTPUT
+        Write-Output "exe_base_name=$exeName" >> $env:GITHUB_OUTPUT
+        Write-Output "app_version=$appVersion" >> $env:GITHUB_OUTPUT
+
+    - name: Install Inno Setup
+      run: |
+        # Download and install Inno Setup silently
+        Invoke-WebRequest -Uri "https://jrsoftware.org/download.php/is.exe" -OutFile "innosetup.exe"
+        Start-Process -FilePath ".\innosetup.exe" -ArgumentList "/VERYSILENT", "/SUPPRESSMSGBOXES", "/NORESTART", "/SP-" -Wait
+        
+        # Add to PATH for current session
+        $env:PATH += ";C:\Program Files (x86)\Inno Setup 6"
+        
+        Write-Output "✅ Inno Setup installed successfully"
+
+    - name: Create InnoSetup Script
+      run: |
+        @"
+        [Setup]
+        AppId={{$(New-Guid)}}
+        AppName=${{ env.APP_DISPLAY_NAME }}
+        AppVersion=${{ steps.app-info.outputs.app_version }}
+        AppPublisher=WillNye
+        AppPublisherURL=https://github.com/WillNye
+        AppSupportURL=https://github.com/WillNye/${{ github.event.repository.name }}/issues
+        AppUpdatesURL=https://github.com/WillNye/${{ github.event.repository.name }}/releases
+        DefaultDirName={autopf}\${{ env.APP_DISPLAY_NAME }}
+        DefaultGroupName=${{ env.APP_DISPLAY_NAME }}
+        AllowNoIcons=yes
+        OutputDir=.
+        OutputBaseFilename=${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-Setup
+        SetupIconFile=assets\icon.ico
+        Compression=lzma2/normal
+        SolidCompression=no
+        WizardStyle=modern
+        PrivilegesRequired=lowest
+        PrivilegesRequiredOverridesAllowed=dialog
+        
+        [Languages]
+        Name: "english"; MessagesFile: "compiler:Default.isl"
+        
+        [Tasks]
+        Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
+        
+        [Files]
+        ; Exclude EXE from compression to preserve icon quality
+        Source: "gui_dist\${{ steps.app-info.outputs.exe_name }}"; DestDir: "{app}"; Flags: ignoreversion nocompression
+        ; Compress everything else
+        Source: "gui_dist\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs; Excludes: "${{ steps.app-info.outputs.exe_name }}"
+        
+        [Icons]
+        Name: "{group}\${{ env.APP_DISPLAY_NAME }}"; Filename: "{app}\${{ steps.app-info.outputs.exe_name }}"
+        Name: "{group}\{cm:UninstallProgram,${{ env.APP_DISPLAY_NAME }}}"; Filename: "{uninstallexe}"
+        Name: "{autodesktop}\${{ env.APP_DISPLAY_NAME }}"; Filename: "{app}\${{ steps.app-info.outputs.exe_name }}"; Tasks: desktopicon
+        
+        [Run]
+        Filename: "{app}\${{ steps.app-info.outputs.exe_name }}"; Description: "{cm:LaunchProgram,${{ env.APP_DISPLAY_NAME }}}"; Flags: nowait postinstall skipifsilent
+        "@ | Out-File -FilePath "setup.iss" -Encoding UTF8
+    - name: Build Setup with InnoSetup
+      run: |
+        # Compile the installer
+        & "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" setup.iss
+        
+        if ($LASTEXITCODE -ne 0) {
+          Write-Output "❌ InnoSetup compilation failed with exit code: $LASTEXITCODE"
+          exit 1
+        }
+        
+        Write-Output "✅ Installer created successfully"
+
+    - name: Sign Installer (if certificate available)
+      if: ${{ env.HAS_WINDOWS_CERTIFICATE == 'true' && env.HAS_WINDOWS_CERTIFICATE_PASSWORD == 'true' }}
+      uses: dlemstra/code-sign-action@v1
+      with:
+        certificate: '${{ secrets.WINDOWS_CERTIFICATE }}'
+        password: '${{ secrets.WINDOWS_CERTIFICATE_PASSWORD }}'
+        files: '${{ env.APP_FILENAME_BASE }}-${{ steps.app-info.outputs.app_version }}-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"
+        
+        gh release upload ${{ github.event.release.tag_name }} `
+          $installerFile `
+          --clobber `
+          --repo ${{ github.repository }}

{tbr_deal_finder-0.2.1 → tbr_deal_finder-0.3.1}/.gitignore

@@ -206,3 +206,6 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+gui_dist/
+scratch/

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

@@ -3,6 +3,22 @@
 
 ---
 
+## 0.3.1 (September 5, 2025)
+
+Notes: 
+* Added a GUI to serve as a desktop app
+* Added retry behavior to Kindle and Libro on get_book call
+* Saving all pricing info to be used for historical pricing details
+* Added version checking to the CLI
+
+BUG FIXES:
+* Improvements to grouping titles in TBR 
+* Fixed issue where known books were being marked as unknown if not found on a run
+* Fixed bug where books not found were sometimes not added to Unknown books 
+* Fixed regression on Windows devices when adding Kindle support
+
+---
+
 ## 0.2.1 (August 25, 2025)
 
 Notes: 

tbr_deal_finder-0.3.1/Makefile

@@ -0,0 +1,143 @@
+# TBR Deal Finder Build System
+.PHONY: help build-mac build-windows build-windows-docker build-linux build-all clean clean-all test-mac status create-cert
+
+# Default target
+help:
+	@echo "TBR Deal Finder Build Commands:"
+	@echo ""
+	@echo "Setup:"
+	@echo "  make create-cert     Create self-signed certificate (one-time setup) 🔐"
+	@echo ""
+	@echo "Building:"
+	@echo "  make build-mac       Build self-signed macOS DMG ⭐"
+	@echo "  make build-windows   Build Windows EXE (GitHub Actions) ⭐"
+	@echo "  make build-linux     Build Linux executable"
+	@echo "  make build-all       Build for current platform"
+	@echo ""
+	@echo "Testing:"
+	@echo "  make test-mac        Test macOS DMG"
+	@echo ""
+	@echo "Utilities:"
+	@echo "  make clean          Clean build artifacts (keeps .spec)"
+	@echo "  make clean-all      Clean everything including .spec"
+	@echo ""
+	@echo "Current platform: $(shell uname -s)"
+
+# Variables
+PROJECT_NAME := TBR Deal Finder
+DIST_DIR := gui_dist
+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/
+	@echo ""
+	@echo "📦 Creating self-signed macOS DMG for app"
+	bash scripts/packaging/create_dmg.sh
+	@echo "✅ Self-signed macOS DMG built successfully!"
+
+# Build Windows EXE (requires Windows or GitHub Actions)
+build-windows:
+	@echo "🪟 Building Windows EXE..."
+	uv run flet build windows --output ${DIST_DIR}/ --verbose
+
+# Test macOS DMG
+test-mac:
+	@echo "🧪 Testing macOS DMG..."
+	@if [ ! -f "$(DIST_DIR)/TBRDealFinder.dmg" ]; then \
+		echo "❌ No DMG found. Run 'make build-mac' first."; \
+		exit 1; \
+	fi
+	@echo "📂 DMG file info:" && \
+		ls -lh $(DIST_DIR)/TBRDealFinder.dmg && \
+		echo "🔍 Testing DMG mount..." && \
+		hdiutil attach $(DIST_DIR)/TBRDealFinder.dmg -mountpoint /tmp/tbr_test -nobrowse && \
+		echo "✅ DMG mounts successfully" && \
+		ls -la /tmp/tbr_test/ && \
+		hdiutil detach /tmp/tbr_test 2>/dev/null || \
+		echo "❌ DMG mount failed"
+
+# Build Linux executable (works on Linux)
+build-linux:
+	@echo "🐧 Building Linux executable..."
+	@if [ "$(shell uname -s)" != "Linux" ]; then \
+		echo "⚠️  Linux builds require Linux OS"; \
+		echo "   Run this on Linux or use GitHub Actions for cross-platform builds"; \
+		exit 1; \
+	fi
+	uv run python $(BUILD_SCRIPT)
+	@echo ""
+	@echo "✅ Linux executable built successfully!"
+	@echo "📦 Output: $(DIST_DIR)/TBRDealFinder"
+	@ls -lh $(DIST_DIR)/TBRDealFinder 2>/dev/null || true
+
+# Build for current platform
+build-all:
+	@echo "🌍 Building for current platform..."
+	@case "$(shell uname -s)" in \
+		Darwin) \
+			echo "On macOS - building self-signed DMG"; \
+			$(MAKE) build-mac; \
+			;; \
+		Linux) \
+			echo "On Linux - building executable"; \
+			$(MAKE) build-linux; \
+			;; \
+		MINGW*|MSYS*|CYGWIN*) \
+			echo "On Windows - building Windows EXE"; \
+			$(MAKE) build-windows; \
+			;; \
+		*) \
+			if [ "$(OS)" = "Windows_NT" ]; then \
+				echo "On Windows - building Windows EXE"; \
+				$(MAKE) build-windows; \
+			else \
+				echo "❌ Unsupported platform: $(shell uname -s)"; \
+				echo "   Supported: macOS (with Docker), Windows, Linux"; \
+				exit 1; \
+			fi; \
+			;; \
+	esac
+
+# Clean build artifacts (preserves .spec file for version control)
+clean:
+	@echo "🧹 Cleaning build artifacts..."
+	rm -rf $(DIST_DIR)/
+	rm -rf build/
+	@echo "✅ Clean complete (kept .spec file)"
+
+# Clean everything including .spec file
+clean-all:
+	@echo "🧹 Cleaning everything..."
+	rm -rf $(DIST_DIR)/
+	rm -rf build/
+	rm -rf dist/
+	rm -f *.spec
+	@echo "✅ Complete clean finished"
+
+# Create self-signed certificate for consistent code signing
+create-cert:
+	@echo "🔐 Creating self-signed certificate for consistent code signing..."
+	@echo ""
+	@bash scripts/create-self-signed-cert.sh
+
+# Show build status
+status:
+	@echo "📊 Build Status:"
+	@echo ""
+	@echo "Platform: $(shell uname -s)"
+	@echo "Build directory: $(DIST_DIR)/"
+	@echo ""
+	@echo "Built artifacts:"
+	@if [ -d "$(DIST_DIR)" ]; then \
+		ls -la $(DIST_DIR)/ 2>/dev/null || echo "  None found"; \
+	else \
+		echo "  Build directory doesn't exist"; \
+	fi
+	@echo ""
+	@echo "Dependencies:"
+	@uv tree --depth 1 | grep -E "(flet|pyinstaller)" || echo "  Not installed"
+	@echo ""
+	@echo "Code signing certificates:"
+	@security find-identity -v -p codesigning 2>/dev/null | grep -E "(TBR Deal Finder|Developer ID)" || echo "  None found (will use ad-hoc signing)"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tbr-deal-finder
-Version: 0.2.1
+Version: 0.3.1
 Summary: Track price drops and find deals on books in your TBR list across audiobook and ebook formats.
 License: MIT
 License-File: LICENSE
@@ -9,26 +9,32 @@ Requires-Dist: aiohttp>=3.12.14
 Requires-Dist: audible==0.8.2
 Requires-Dist: click>=8.2.1
 Requires-Dist: duckdb>=1.3.2
+Requires-Dist: flet[all]==0.28.2
 Requires-Dist: levenshtein>=0.27.1
+Requires-Dist: pandas-stubs==2.3.0.250703
 Requires-Dist: pandas>=2.3.1
+Requires-Dist: plotly>=5.17.0
+Requires-Dist: pyinstaller>=6.15.0
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: tqdm>=4.67.1
 Requires-Dist: unidecode>=1.4.0
 Description-Content-Type: text/markdown
 
-# tbr-deal-finder
-
+<div>
+  <h1>TBR Deal Finder <img src="assets/icon.png" alt="TBR Deal Finder" width="128" height="128" style="vertical-align: middle; margin-left: 10px;"></h1>
+</div>
 Track price drops and find deals on books in your TBR (To Be Read) and wishlist across digital book retailers.
 
 ## Features
 - Use your StoryGraph exports, Goodreads exports, and custom csvs (spreadsheet) to track book deals
-- Supports multiple of the library exports above
+- Supports multiple library exports
 - Tracks deals on the wishlist of all your configured retailers like audible (excluding kindle)
-- Supports multiple locales and currencies
+- Supports multiple locales
 - Find the latest and active deals from supported sellers
-- Simple CLI interface for setup and usage
 - Only get notified for new deals or view all active deals 
 - Filters out books you already own to prevent purchasing the same book on multiple retailers
+- Track historical pricing* (History limited to your runs making it more accurate over time)
+- Compare pricing across digital retailers
 
 ## Support
 
@@ -53,24 +59,6 @@ Track price drops and find deals on books in your TBR (To Be Read) and wishlist
 * ES
 * BR
 
-## Installation Guide
-
-### Python (Recommended)
-1. If it's not already on your computer, download Python https://www.python.org/downloads/
-   1. tbr-deal-finder requires Python3.13 or higher
-2. Optional: Install and use virtualenv
-3. Open your Terminal/Command Prompt
-4. Run `pip3.13 install tbr-deal-finder`
-
-### UV
-1. Clone the repository:
-   ```sh
-   git clone https://github.com/yourusername/tbr-deal-finder.git
-   cd tbr-deal-finder
-   ```
-2. Install uv:
-   https://docs.astral.sh/uv/getting-started/installation/
-
 ## Configuration
 This tool can use the csv generated by the app you use to track your TBRs.
 Here are the steps to get your export.
@@ -103,70 +91,13 @@ If you've got your own CSV you're using to track your TBRs all you need are the
 Optionally, you can add the `Read Status` column. Set `to-read` for all books you want to be tracked.
 If you don't add this column the deal finder will run on ALL books in the CSV.
 
-### tbr-deal-finder setup
-
-#### Python
-```sh
-tbr-deal-finder setup
-```
-
-#### UV
-```sh
-uv run -m tbr_deal_finder.cli setup
-```
-
-You will be prompted to:
-- Enter the path(s) to your StoryGraph export CSV file(s)
-- Select your locale (country/region)
-- Set your maximum price for deals
-- Set your minimum discount percentage
-
-The configuration will be saved for future runs.
-
-## Usage
-All commands are available via the CLI:
-
-- `setup`         – Set up or update your configuration interactively.
-- `latest-deals`  – Find and print the latest book deals based on your config.
-- `active-deals`  – Show all currently active deals.
-
-#### Python
-```sh
-tbr-deal-finder [COMMAND]
-```
-
-#### UV
-```sh
-uv run -m tbr_deal_finder.cli [COMMAND]
-```
-
-Example:
-```sh
-tbr-deal-finder latest-deals
-
-# or
-
-uv run -m tbr_deal_finder.cli latest-deals
-```
-
-## Updating your TBR
-To update tbr-deal-finder as your TBR changes, regenerate and download your library export.
-See [Configuration](#Configuration) for steps.
-
-
-## Updating the tbr-deal-finder
-
-### Python
-```sh
-pip3.13 install tbr-deal-finder --upgrade
-```
-
-### UV
-```sh
-# From the repo directory
-git checkout main && git fetch
-```
+## Installation Guide
+Each guide contains everything you need: installation, usage, and updating instructions.
 
+### Choose Your Guide
+- [📱 **Desktop App Guide**](docs/desktop-app.md) - For users who prefer graphical interfaces
+- [🐍 **Python CLI Guide**](docs/python-cli.md) - For command-line and automation users
+- [🛠️ **Development Guide**](docs/development.md) - For developers and contributors
 
 ---