English · 简体中文

Leverages GitHub Actions to schedule Calibre to send news via email.

Upload Recipe | Add Built-in Recipe | Update Schedule | Workflow | Environments | Enable/Disable | Destroy

1. Create a project using the [use this template] button located in the top right corner.
2. Navigate to [ Settings > Environments ] in your project.
3. Click "New environment" to create a new environment named calibre-news.
4. Add the required "environment secrets" to the environment as follows.

5. Navigate to "Actions" and click [ Calibre News Delivery > Run workflow ] to test.

Normally, you may receive two example ebooks sent from your project.

The default delivery is scheduled to occur daily at midnight (00:00) UTC. You can change it according to your preference. The cron expression - cron: '0 0 * * *' can be found in the workflow file located at:

/.github/workflows/calibre-news.yml

Please refer to the "schedule" documentation to specify an appropriate time. For example, if you are in a timezone that is UTC+8 and want the delivery to start at 6:00 AM every day, you can set the cron expression as 0 22 * * *, calculated using the formula UTC Time = Local Time − Offset.

Additionally, you can manually trigger the delivery on the "Actions" page of your project.

For the built-in recipes, you need to add their titles (found in the Title attribute of the recipe file) to the plain text file recipe_list.txt, one title per line. For manually written recipes, simply place them in the root of the project.

You can specify the cover and style for a recipe. Place the cover image in the "covers" folder and the style file in the "styles" folder. Both filenames must match the corresponding recipe title or filename. Be aware that the style may be ignored by the Send to Kindle service.

You can upload the recipe files using either the Git tool or GitHub's online uploading feature. The best practice is to test the recipe locally to ensure no errors occur before uploading it.

This project does not accept any PRs for adding recipes. Please do something interesting on your own.

• API documentation for recipes
• Calibre recipe repository
• Adding your favorite news website

GNU General Public License v3.0