trmnl-goodreads-template
Display your current Goodreads reading progress on TRMNL e-ink devices.
web
goodlibbin/trmnl-goodreads-template
Just deployed
Deploy and Host trmnl-goodreads-template on Railway
A Flask backend that transforms your Goodreads RSS feed into beautiful reading progress displays for TRMNL e-ink devices. Features intelligent data fusion, automatic challenge tracking, and optimized JSON output for TRMNL templates.
Why Deploy
TRMNL e-ink devices need a reliable backend to process Goodreads data and provide clean JSON for beautiful reading displays. This Flask app handles the complex RSS parsing, data fusion, and caching so your reading progress updates automatically without manual intervention.
About Hosting trmnl-goodreads-template
This lightweight Flask application continuously processes your Goodreads RSS feed to provide clean JSON data for your TRMNL device. Includes smart caching (5-minute book data, 30-minute challenge updates) to minimize API calls while keeping reading progress current. Simply deploy, configure your Goodreads RSS URL, and connect to your TRMNL device.
Dependencies for trmnl-goodreads-template
This project requires minimal Python dependencies for reliable operation and easy maintenance.
Deployment Dependencies
- Flask 3.0.0: Web framework for API endpoints
- requests 2.31.0: HTTP library for RSS feed fetching
- beautifulsoup4 4.12.2: HTML/XML parsing for RSS content
- feedparser 6.0.10: RSS feed processing and normalization
- lxml 4.9.3: Fast XML parsing backend
Common Use Cases
- Personal Reading Dashboard: Display your current book and reading progress on your desk or nightstand
- Reading Challenge Tracking: Show annual reading goals with automatic progress updates as you complete books
- Book Club Displays: Share what you're currently reading with friends, family, or colleagues via e-ink display
Template Content
