RSSPub

RSSPub is an innovative self-hosted application developed in Rust that transforms your preferred RSS feeds and saved articles into a personalized daily newspaper, delivered in an EPUB format. This tool not only fetches and processes articles but also optimizes images, ensuring an enhanced reading experience on any e-reader or tablet.

With RSSPub, users benefit from:

• Read It Later Functionality: Save articles to peruse later; separate EPUBs are generated for these articles, which are marked as read once created. Article saving can be done through the web UI or via direct requests from iOS shortcuts or Android applications.
• RSS/Atom Parsing: Automatically parses and retrieves content from your configured feeds.
• EPUB Generation: Compiles articles into a well-formatted EPUB file, ready for reading.
• Image Optimization: Ensures images are resized and processed for optimal display on e-readers.
• User-Friendly Web Interface: Manage feeds and schedules effortlessly with an intuitive web interface.
• OPDS Catalog: Access a built-in OPDS server at /opds to browse and download generated EPUBs directly to compatible e-reading devices, such as KOReader and Moon+ Reader.
• Email Delivery: Set up automatic delivery of generated EPUBs to specified email addresses for easy access.
• Latest Downloads: Directly retrieve the most recent EPUBs from designated endpoints for quick downloading.
• Scheduled Generation: Automate EPUB production based on customizable cron expressions.
• Authentication Options: Implement Basic Authentication to secure your instance.
• High Performance: Built using Rust, Axum, and Tokio, ensuring efficient performance and low resource consumption.

Usage Example

To create an EPUB using RSSPub, follow these steps:

1. Open the Web UI: Navigate to your server's address (e.g., http://localhost:3000).
2. Add RSS Feeds: Input the URLs of the RSS/Atom feeds you want to follow.
3. Generate EPUB: Initiate the EPUB creation process via the "Generate" button or set a schedule for automatic generation.
4. Download: Access the generated EPUBs from the download section in the UI or through the integrated OPDS catalog by adding the URL to your e-reader's catalog.

Content Extraction

RSSPub features multiple content extraction methods, allowing for optimized retrieval of full article content. It supports default extraction methods as well as custom extraction configurations using CSS selectors for specific requirements.

Overall, RSSPub serves as a robust solution for anyone looking to centralize their reading materials while enjoying seamless access to a personalized digital newspaper format.