{"id":17119043,"url":"https://github.com/chyroc/greader","last_synced_at":"2025-10-11T16:40:10.268Z","repository":{"id":65837196,"uuid":"597927677","full_name":"chyroc/greader","owner":"chyroc","description":"RSS service, providing api similar to google reader.","archived":false,"fork":false,"pushed_at":"2023-03-07T05:32:28.000Z","size":346,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-29T08:23:27.400Z","etag":null,"topics":["freshrss","rss"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chyroc.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":"2023-02-06T02:25:08.000Z","updated_at":"2023-02-10T06:19:40.000Z","dependencies_parsed_at":"2023-04-05T22:17:43.828Z","dependency_job_id":null,"html_url":"https://github.com/chyroc/greader","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyroc%2Fgreader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyroc%2Fgreader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyroc%2Fgreader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chyroc%2Fgreader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chyroc","download_url":"https://codeload.github.com/chyroc/greader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245195962,"owners_count":20575938,"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":["freshrss","rss"],"created_at":"2024-10-14T17:56:09.345Z","updated_at":"2025-10-11T16:40:05.203Z","avatar_url":"https://github.com/chyroc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# greader\n\nRSS service, providing api similar to google reader.\n\n## Start Server\n\n### By Docker\n\n- **Run**\n\n```bash\ndocker run -d \\\n  -e MYSQL_HOST=xx \\\n  -e MYSQL_USERNAME=root \\\n  -e MYSQL_PASSWORD=your-password \\\n  -e MYSQL_DATABASE=greader \\\n  -e ADMIN_USERNAME=admin \\\n  -e ADMIN_PASSWORD=greader-password \\\n  -p 8081:8081 \\\n  ghcr.io/chyroc/greader:latest\n```\n\n### By Docker Compose\n\n- **Create `docker-compose.yml`**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/chyroc/greader/master/docker-compose.yaml \u003e docker-compose.yml\n``\n```\n\n- **Run**\n\n```bash\ndocker-compose up -d\n```\n\n### By Binary\n\n- **Install Binary**\n\n```bash\ngo install github.com/chyroc/greader@latest\n```\n\n- **Run**\n\n```bash\nMYSQL_HOST=xx \\\n  MYSQL_USERNAME=xx \\\n  MYSQL_PASSWORD=xx \\\n  MYSQL_DATABASE=xx \\\n  ADMIN_USERNAME=admin \\\n  ADMIN_PASSWORD=greader-password \\\n  greader start\n```\n\n## RSS API\n\n```text\n\u003cyour host\u003e/api/greader\n```\n\n![](./screenshot/list.png)\n\n## TODO\n\n- [ ] Newsletter Address\n- [ ] filter \u0026\u0026 action\n- [ ] import \u0026\u0026 export opml file\n\n## Ref\n\n- https://ranchero.com/downloads/GoogleReaderAPI-2009.pdf\n- https://github.com/Ranchero-Software/NetNewsWire/blob/mac-6.1.1b1/Account/Sources/Account/ReaderAPI/ReaderAPICaller.swift\n- https://github.com/FreshRSS/FreshRSS/blob/1.20.2/p/api/greader.php\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchyroc%2Fgreader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchyroc%2Fgreader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchyroc%2Fgreader/lists"}