{"id":20981417,"url":"https://github.com/nobe4/girssa","last_synced_at":"2025-09-04T05:16:55.873Z","repository":{"id":37009883,"uuid":"500055506","full_name":"nobe4/girssa","owner":"nobe4","description":"Github RSS Action","archived":false,"fork":false,"pushed_at":"2024-01-17T14:38:00.000Z","size":3074,"stargazers_count":4,"open_issues_count":22,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-22T22:18:11.458Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/nobe4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null}},"created_at":"2022-06-05T09:40:22.000Z","updated_at":"2023-05-21T07:23:51.000Z","dependencies_parsed_at":"2023-01-17T13:01:44.362Z","dependency_job_id":"786bb162-531f-4499-87af-5b199e875abe","html_url":"https://github.com/nobe4/girssa","commit_stats":{"total_commits":201,"total_committers":2,"mean_commits":100.5,"dds":"0.20895522388059706","last_synced_commit":"1b62b10994811c5b205036d3d46bcdb03ac2439c"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":"actions/javascript-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nobe4%2Fgirssa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nobe4%2Fgirssa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nobe4%2Fgirssa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nobe4%2Fgirssa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nobe4","download_url":"https://codeload.github.com/nobe4/girssa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254182742,"owners_count":22028354,"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":[],"created_at":"2024-11-19T05:37:26.254Z","updated_at":"2025-05-14T16:30:48.389Z","avatar_url":"https://github.com/nobe4.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n  _____  _____  _____    _____  _____\n / ____||_   _||  __ \\  / ____|/ ____|   /\\\n| |  __   | |  | |__) || (___ | (___    /  \\\n| | |_ |  | |  |  _  /  \\___ \\ \\___ \\  / /\\ \\\n| |__| | _| |_ | | \\ \\  ____) |____) |/ ____ \\\n \\_____||_____||_|  \\_\\|_____/|_____//_/    \\_\\\n\n GitHub        RSS                   Action\n```\n\n[![check dist](https://github.com/nobe4/girssa/actions/workflows/check-dist.yml/badge.svg)](https://github.com/nobe4/girssa/actions/workflows/check-dist.yml)\n[![codeql](https://github.com/nobe4/girssa/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/nobe4/girssa/actions/workflows/codeql-analysis.yml)\n[![units-test](https://github.com/nobe4/girssa/actions/workflows/test.yml/badge.svg)](https://github.com/nobe4/girssa/actions/workflows/test.yml)\n[![coverage](https://github.com/nobe4/girssa/actions/workflows/coverage.yml/badge.svg)](https://github.com/nobe4/girssa/actions/workflows/coverage.yml)\n\n# Girssa\n\nGirssa is a minimalist and easy to use [RSS](https://en.wikipedia.org/wiki/RSS) reader.\nIt leverages GitHub in two ways: _actions_ for automation and _issues_ for storage.\n\nTo use it: write a [_sources_](./docs/sources.example.json) file and install the action in a repository.\n\nDone :sparkles:\n\nGirssa sends the RSS items to the repository's issues. You can then consult them freely.\n\n## How does it work?\n\n0. The source file is read (`sources.read`).\n1. For each source, the feed is fetched (`rss.fetch`) and parsed (`rss.parse`).\n2. New items are selected (`issues.select`).\n3. For each new item, an issue is created (`issues.create`).\n\n## Usage and configuration\n\n### Usage\n\nYou can run Girssa on an automated basis.\n\n```yaml\nname: build rss feed\n\non:\n  workflow_dispatch:\n  schedule:\n    # Every day at midnight UTC\n    - cron: \"0 0 * * *\"\n\njobs:\n  run:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: nobe4/girssa@\u003ccurrent version\u003e\n```\n\n:warning: GitHub actions can cost you. Make sure to check [the billing doc](https://docs.github.com/en/actions/learn-github-actions/usage-limits-billing-and-administration) to not have any bad surprise :money_with_wings:.\n\n### Sources\n\nSee [`sources`](./docs/SOURCES.md)\n\n### Configuration\n\nYou can configure Girssa with some options, see [`action.yml`](./action.yml) for details.\n\nE.g.:\n\n```yaml\njobs:\n  run:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: nobe4/girssa@\u003ccurrent version\u003e\n        with:\n          repository: \u003canother/repository\u003e\n          token: \u003ctoken with access to another/repository\u003e\n          noop: true\n```\n\n## Contributing\n\nSee [the contributing guide](./docs/CONTRIBUTING.md)\n\n## License\n\nSee [LICENSE](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnobe4%2Fgirssa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnobe4%2Fgirssa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnobe4%2Fgirssa/lists"}