tbr-deal-finder 0.4.1

Track price drops and find deals on books in your TBR list across audiobook and ebook formats.

TBR Deal Finder

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, Hardcover exports, and custom csvs (spreadsheet) to track book deals
• Supports multiple library exports
• Tracks deals on the wishlist of all your configured retailers like audible (excluding kindle)
• Supports multiple locales
• Find the latest and active deals from supported sellers
• 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
• Whispersync intelligence* (Where available. See FAQ Below for more)
• Audible Plus & Kindle Unlimited awareness and alerting
• Centralized place to view all the audiobooks and ebooks you own

Support

Audiobooks

• Audible
• Chirp
• Libro.fm
• Kobo

EBooks

• Kindle
• Kobo

Locales

• US
• CA
• UK
• AU
• FR
• DE
• JP
• IT
• IN
• ES
• BR

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.

StoryGraph

• Open https://app.thestorygraph.com/ in the browser of your choice
• Click on your profile icon in the top right corner
• Select "Manage Account"
• Scroll down to "Manage Your Data"
• Click the button "Export StoryGraph Library"
• You will be navigated to https://app.thestorygraph.com/user-export
• Click "Generate export"
• Wait a few minutes and refresh the page
• A new item will appear that says "Your export from ... - Download" will appear
• Click "Download"

Goodreads

• Open https://www.goodreads.com/review/import in the browser of your choice
• At the top of the page click the button "Export Library"
• Wait a few minutes and refresh the page
• A new item will appear that says "Your export from ..." will appear
• Click it to download the csv

Hardcover

• Open https://hardcover.app/account/exports in the browser of your choice
• In the center of your page click the button "Generate Export"
• Wait a few minutes and refresh the page
• A new line item will appear, including a section called "Download"
• Click the button for the most recent export to download the csv

Custom csv

If you've got your own CSV you're using to track your TBRs all you need are the following columns for it to be in a valid format

• Title
• Authors
• Read Status* (See below)

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.

Installation Guide

Each guide contains everything you need: installation, usage, and updating instructions.

Choose Your Guide

• 📱 Desktop App Guide - For users who prefer graphical interfaces
• 🐍 Python CLI Guide - For command-line and automation users
• 🛠️ Development Guide - For developers and contributors

F.A.Q.

What is Whispersync pricing

Whispersync is Amazon's program that discounts audiobooks when you own the ebook.

The trick: This works with any ebook in your library—including Kindle Unlimited books. So you can add a KU ebook (even if you don't want it) to unlock a steep discount on the audiobook.

TBR Deal Finder automatically checks for Whispersync discounts. If you're a Kindle Unlimited member and the ebook is available in KU, it'll show you the discounted Audible price instead of the full price.

---

Happy deal hunting!