{"id":13624194,"url":"https://github.com/custom-components/feedparser","last_synced_at":"2025-12-29T23:34:57.703Z","repository":{"id":37576261,"uuid":"145180996","full_name":"custom-components/feedparser","owner":"custom-components","description":"📰 RSS Feed Integration","archived":false,"fork":false,"pushed_at":"2024-11-29T11:02:52.000Z","size":294,"stargazers_count":145,"open_issues_count":22,"forks_count":33,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-29T12:19:15.128Z","etag":null,"topics":["feedparser","home-assistant","home-assistant-component","home-assistant-hacs","home-assistant-sensor","rss","rss-parser"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/custom-components.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2018-08-18T01:41:41.000Z","updated_at":"2024-11-17T11:40:35.000Z","dependencies_parsed_at":"2023-11-21T22:30:48.258Z","dependency_job_id":"e8d04822-8de2-46a8-9fba-7d1a3d299e4b","html_url":"https://github.com/custom-components/feedparser","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custom-components%2Ffeedparser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custom-components%2Ffeedparser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custom-components%2Ffeedparser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custom-components%2Ffeedparser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/custom-components","download_url":"https://codeload.github.com/custom-components/feedparser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249148386,"owners_count":21220523,"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","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":["feedparser","home-assistant","home-assistant-component","home-assistant-hacs","home-assistant-sensor","rss","rss-parser"],"created_at":"2024-08-01T21:01:39.936Z","updated_at":"2025-12-29T23:34:57.665Z","avatar_url":"https://github.com/custom-components.png","language":"Python","readme":"# sensor.feedparser\nRSS feed custom component for [Home Assistant](https://www.home-assistant.io/) which can be used in conjunction with the custom [Lovelace](https://www.home-assistant.io/lovelace) [list-card](https://github.com/custom-cards/list-card)\n\n[![GitHub Release][releases-shield]][releases]\n[![License][license-shield]](LICENSE.md)\n\n![Project Maintenance][maintenance-shield]\n[![GitHub Activity][commits-shield]][commits]\n\n[![Discord][discord-shield]][discord]\n[![Community Forum][forum-shield]][forum]\n\n## Support\nHey dude! Help me out for a couple of :beers: or a :coffee:!\n\n[![coffee](https://www.buymeacoffee.com/assets/img/custom_images/black_img.png)](https://www.buymeacoffee.com/zJtVxUAgH)\n\n\n## Installation\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://github.com/hacs/integration)\n\n1. Open HACS Settings and add this repository (https://github.com/custom-components/feedparser/)\n   as a Custom Repository (use **Integration** as the category).\n2. The `feedparser` page should automatically load (or find it in the HACS Store)\n3. Click `Install`\n\nAlternatively, click on the button below to add the repository:\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?category=Integration\u0026repository=feedparser\u0026owner=custom-components)\n\n\n## Configuration\n\n**Example configuration.yaml:**\n\n```yaml\nsensor:\n  - platform: feedparser\n    name: Engineering Feed\n    feed_url: 'https://www.sciencedaily.com/rss/matter_energy/engineering.xml'\n    date_format: '%a, %d %b %Y %H:%M:%S %Z'\n    scan_interval:\n      hours: 3\n    inclusions:\n      - title\n      - link\n      - description\n      - image\n      - published\n    exclusions:\n      - language\n\n  # Configuration of the second sensor tracking a different RSS feed\n  - platform: feedparser\n    name: Algemeen\n    feed_url: https://www.nu.nl/rss/Algemeen\n    local_time: true\n    show_topn: 1\n```\n\nIf you wish the integration to look for enclosures in the feed entries, add `image` to `inclusions` list. Do not use `enclosure`.\nThe integration tries to get the link to an image for the given feed item and stores it under the attribute named `image`. If it fails to find it, it assigns the Home Assistant logo to it instead.\n\nNote that the original `pubDate` field is available under `published` attribute for the given feed entry. Other date-type values that can be available are `updated`, `created` and `expired`. Please refer to [the documentation of the original feedparser](https://feedparser.readthedocs.io/en/latest/date-parsing.html) library.\n\n**Configuration variables:**\n\nkey | description\n:--- | :---\n**platform (Required)** | The platform name\n**name (Required)** | Name your feed\n**feed_url (Required)** | The RSS feed URL\n**date_format (Optional)** | strftime date format for date strings **Default** `%a, %b %d %I:%M %p`\n**local_time (Optional)** | Whether to convert date into local time **Default** false\n**show_topn (Optional)** | fetch how many entres from rss source，if not set then fetch all\n**inclusions (Optional)** | List of fields to include from populating the list\n**exclusions (Optional)** | List of fields to exclude from populating the list\n**scan_interval (Optional)** | Update interval in hours\n\n***\n\nNote: Will return all fields if no inclusions or exclusions are specified\n\nDue to how `custom_components` are loaded, it is normal to see a `ModuleNotFoundError` error on first boot after adding this, to resolve it, restart Home-Assistant.\n\n[commits-shield]: https://img.shields.io/github/commit-activity/y/custom-components/feedparser.svg?style=for-the-badge\n[commits]: https://github.com/custom-components/feedparser/commits/master\n[discord]: https://discord.gg/Qa5fW2R\n[discord-shield]: https://img.shields.io/discord/330944238910963714.svg?style=for-the-badge\n[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge\n[forum]: https://community.home-assistant.io/t/custom-component-rss-feed-parser/64637\n[license-shield]: https://img.shields.io/github/license/custom-components/feedparser.svg?style=for-the-badge\n[maintenance-shield]: https://img.shields.io/badge/maintainer-Ondrej%20Gajdusek%20%40ogajduse-blue.svg?style=for-the-badge\n[releases-shield]: https://img.shields.io/github/release/custom-components/feedparser.svg?style=for-the-badge\n[releases]: https://github.com/custom-components/feedparser/releases\n","funding_links":["https://www.buymeacoffee.com/zJtVxUAgH"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcustom-components%2Ffeedparser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcustom-components%2Ffeedparser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcustom-components%2Ffeedparser/lists"}