{"id":20733140,"url":"https://github.com/ping/newsrack","last_synced_at":"2025-08-30T12:39:59.769Z","repository":{"id":37726354,"uuid":"481480649","full_name":"ping/newsrack","owner":"ping","description":"Generate a GitHub-hosted newsrack of magazines and newspapers for your Kindle/ereader","archived":false,"fork":false,"pushed_at":"2024-02-01T20:33:12.000Z","size":2097,"stargazers_count":19,"open_issues_count":1,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T22:54:35.991Z","etag":null,"topics":["calibre","ebook","ebooks","kindle"],"latest_commit_sha":null,"homepage":"https://ping.github.io/newsrack/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ping.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://buymeacoffee.com/ping/"]}},"created_at":"2022-04-14T05:43:20.000Z","updated_at":"2025-04-23T12:39:42.000Z","dependencies_parsed_at":"2024-11-17T05:24:10.853Z","dependency_job_id":"647a2003-7857-4987-897e-d1180152f768","html_url":"https://github.com/ping/newsrack","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ping/newsrack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ping%2Fnewsrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ping%2Fnewsrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ping%2Fnewsrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ping%2Fnewsrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ping","download_url":"https://codeload.github.com/ping/newsrack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ping%2Fnewsrack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272852284,"owners_count":25004054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calibre","ebook","ebooks","kindle"],"created_at":"2024-11-17T05:23:41.442Z","updated_at":"2025-08-30T12:39:59.750Z","avatar_url":"https://github.com/ping.png","language":"Python","funding_links":["https://buymeacoffee.com/ping/","https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee\u0026emoji=\u0026slug=ping\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Bree\u0026outline_colour=000000\u0026coffee_colour=ffffff","https://www.buymeacoffee.com/ping"],"categories":[],"sub_categories":[],"readme":"# newsrack\n\nGenerate an online \"newsrack\" of periodicals for your ereader.\n\nFeatures:\n- Download anywhere using your device browser\n- Subscribe via OPDS feeds\n\nUses [calibre](https://calibre-ebook.com/) + [recipes](https://manual.calibre-ebook.com/news_recipe.html), [GitHub Actions](.github/workflows/build.yml), and hosted\non [GitHub Pages](https://pages.github.com/).\n\n![eInk Kindle Screenshot](https://github.com/ping/newsrack/assets/104607/475daa53-f2d5-4469-b88e-7d5463399d73)\n![Mobile Screenshot](https://github.com/ping/newsrack/assets/104607/76ec3514-8d89-43bc-a68c-909df42971cb)\n\n[![Buy me a coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee\u0026emoji=\u0026slug=ping\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Bree\u0026outline_colour=000000\u0026coffee_colour=ffffff)](https://www.buymeacoffee.com/ping)\n\n## Running Your Own Instance\n\n### General Steps\n\n1. Fork this repository.\n2. Create a new branch, for example `custom`. Using a new branch makes a few things, like contributing fixes for example, easier.\n3. Add your own recipes to the [`recipes_custom/`](recipes_custom) folder and customise [_recipes_custom.py](_recipes_custom.py). Optional.\n4. Customise the cron schedule and job run time in [.github/workflows/build.yml](.github/workflows/build.yml). Optional.\n5. Set the new branch `custom` as default\n   - from Settings \u003e Branches \u003e Default branch\n6. Enable Pages in repository settings to deploy from `GitHub Actions`\n   - from Settings \u003e Pages \u003e Build and deployment \u003e Source\n7. If needed, manually trigger the `Build` workflow from Actions to start your first build.\n\n### What Can Be Customised\n\n`newsrack` supports extensive customisation such as:\n- add/remove recipes\n- the formats generated\n- when recipes are executed\n- cover colours and fonts\n\nReview the [wiki](https://github.com/ping/newsrack/wiki#customisation) page to understand what can be customised and how to do so.\n\nYou can also refer to the [example fork repo](https://github.com/ping/newsrack-fork-test/) and see the [actual customisations](https://github.com/ping/newsrack-fork-test/compare/main...custom#files_bucket) in action.\n\n\n## Available Recipes\n\n`newsrack` has its own set of customised recipes. The full list of available recipes can be viewed on [here](https://github.com/ping/newsrack/wiki/Available-Recipes).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fping%2Fnewsrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fping%2Fnewsrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fping%2Fnewsrack/lists"}