Help

A quick reference for using TBR.fyi

Getting started

  1. Text anything to +1 (360) 504-4327
  2. You'll receive a welcome message
  3. Reply START to opt in and activate your account
  4. Start adding books—a "TBR" shelf is automatically created for you

Try it now

Text 9780547928227 to add The Hobbit to your shelf.

Adding books

Via SMS

Text any of these to +1 (360) 504-4327:

  • • An ISBN (10 or 13 digits)
  • • A title and author ("The Hobbit by Tolkien")
  • • A photo of a barcode
  • • An Amazon link

Via web

Click the + button on your shelf page. You can enter an ISBN, paste an Amazon URL, search by title/author, or upload a photo.

SMS commands

  • ADD — Add the last suggested book to your shelf
  • HELP — Get a quick command reference
  • STOP — Unsubscribe from SMS messages
  • START — Re-subscribe to SMS messages

Managing your library

Shelves

Your TBR shelf is created automatically. You can add custom shelves (Favorites, Currently Reading, etc.) by clicking "+ New Shelf." Deleting a shelf removes the organization, not the books—they'll still appear in All Books.

Book actions

  • Read/Unread — Click the green badge to toggle
  • Owned — Click the blue badge to mark books you own
  • Notes — Add context like "Recommended on Fresh Air"
  • Shelves — Click "+ Add to shelf" to organize
  • Delete — Removes from all shelves

Marking a book as read doesn't remove it from any shelves—it stays where you put it until you move it.

View modes

Grid view shows covers with flip cards for details. List view is more compact with everything visible at once.

FAQs

Why isn't my book being found?

Some books aren't in Google Books. Try using the ISBN from the copyright page instead of the back cover, or try the other format (ISBN-10 vs ISBN-13). You can also search by exact title and author.

What if I text the same ISBN twice?

Duplicates are detected automatically. You'll get a confirmation that the book is already on your shelf.

Why are my barcode photos not working?

Good lighting helps. Keep the barcode in focus, fill most of the frame, avoid glare, and make sure the entire barcode is visible.

Why can't I send a photo of the book cover?

Reliably extracting title and author from cover images is surprisingly complex—there's a lot of variation in cover design. For now, we're focused on features that work reliably. Once the core experience is solid, cover recognition is on the list.

Can multiple people use the same phone number?

No, each phone number has its own library. This keeps your reading list private.

Why is the cover image missing or low quality?

Cover images come from Google Books. Older or less common books sometimes don't have high-quality covers available.

Troubleshooting

Not receiving SMS responses?

Check that you've sent START to opt in. Verify you're texting +1 (360) 504-4327. SMS delivery can take 10-30 seconds. Some carriers block automated messages.

Shelf page not loading?

Clear your browser cache and refresh, or try incognito mode. Make sure the phone number format includes the country code (+1 for US).

Books not showing up after adding?

Refresh your shelf page and check that you're viewing the correct shelf (try "All Books"). Verify you received a confirmation SMS.

Common error messages

  • "Invalid ISBN" — Check for typos or try the other format (10-digit vs 13-digit)
  • "Book not found" — The book may not be in Google Books; try searching by title/author
  • "Already on your shelf" — This book is already in your library

Need more help?

Text HELP to +1 (360) 504-4327 for a quick command reference.

Found a bug or have feedback? Open an issue on GitHub.