{"id":13674392,"url":"https://github.com/cubny/lite-reader","last_synced_at":"2026-05-17T00:56:59.307Z","repository":{"id":71301848,"uuid":"454299","full_name":"cubny/lite-reader","owner":"cubny","description":"self-hosted Lightweight News Reader with multi-user support","archived":false,"fork":false,"pushed_at":"2025-02-23T14:15:01.000Z","size":36216,"stargazers_count":40,"open_issues_count":3,"forks_count":7,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-28T14:44:34.200Z","etag":null,"topics":["cross-platform","lite","rss-aggregator","rss-reader","self-hosted","web-app"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cubny.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2009-12-31T10:13:31.000Z","updated_at":"2025-02-22T22:19:37.000Z","dependencies_parsed_at":"2024-01-14T17:03:10.404Z","dependency_job_id":"64501865-db03-4248-b8e2-dd2422814e47","html_url":"https://github.com/cubny/lite-reader","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/cubny/lite-reader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubny%2Flite-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubny%2Flite-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubny%2Flite-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubny%2Flite-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cubny","download_url":"https://codeload.github.com/cubny/lite-reader/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cubny%2Flite-reader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274291347,"owners_count":25258157,"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-09-09T02:00:10.223Z","response_time":80,"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":["cross-platform","lite","rss-aggregator","rss-reader","self-hosted","web-app"],"created_at":"2024-08-02T11:00:48.793Z","updated_at":"2026-05-17T00:56:59.302Z","avatar_url":"https://github.com/cubny.png","language":"Go","funding_links":[],"categories":["Software","Feed Readers"],"sub_categories":["Feed Readers","E-commerce"],"readme":"# Lite Reader\n\nRead your feeds on your own machine with a simple and lite application.\n\n![Feed list](docs/images/feed-list.png)\n\n![Article reader](docs/images/item-reader.png)\n\n## Table of Contents\n- [Features](#features)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Testing](#testing)\n- [Migration from Legacy Lite Reader](#migration-from-legacy-lite-reader)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n- Lightweight and minimal feed aggregator\n- Easy to install and use\n- Supports data migration from legacy Lite Reader\n- **New:** Multi-user support with individual user feeds\n- Feed management: add, update, delete feeds\n- Item management: read, star, mark as read/unread\n\n## Requirements\n- None, just download the binary from the releases page and run it.\n\n## Installation\n1. Download the latest release from the [releases page](https://github.com/cubny/lite-reader/releases).\n2. Run the binary:\n   ```sh\n   ./lite-reader\n   ```\n   By default the SQLite database is stored in your OS user config directory (see [Usage](#usage)). To store it somewhere else, set `DB_PATH` to an absolute path:\n   ```sh\n   DB_PATH=/var/lib/lite-reader/agg.db ./lite-reader\n   ```\n\n## Usage\n- Access the application via `http://localhost:3000` (or your specified port).\n- The SQLite database lives in your OS user config directory by default:\n  `~/.config/lite-reader/agg.db` (Linux), `~/Library/Application Support/lite-reader/agg.db` (macOS), `%AppData%\\lite-reader\\agg.db` (Windows).\n  Override with an absolute path via `DB_PATH=/absolute/path/agg.db`.\n\n## Testing\n\nLite Reader includes comprehensive automated tests:\n\n### Unit Tests\n\n```bash\n# Run all Go unit tests\nmake test\n\n# View coverage report\nmake coverage-report\n```\n\n### UI Tests\n\n```bash\n# First-time setup (install Playwright)\nmake test-ui-setup\n\n# Run automated UI tests\nmake test-ui\n\n# Run UI tests with visible browser (for debugging)\nmake test-ui-headed\n\n# Run all tests (unit + UI)\nmake test-all\n```\n\nFor detailed testing documentation, see [TEST.md](TEST.md).\n\n**Key Features:**\n- Automated browser testing with Playwright\n- Mock RSS/Atom feed server (no internet required)\n- Happy path and edge case coverage\n- Fast execution (\u003c 5 minutes)\n- CI/CD integration ready\n\n## Migration from Legacy Lite Reader\nIf you are using the legacy Lite Reader, you can migrate your data to the new Lite Reader.\n1. Download the latest release of Lite Reader.\n2. Copy your existing `agg.db` to the new default location:\n   - Linux: `~/.config/lite-reader/agg.db`\n   - macOS: `~/Library/Application Support/lite-reader/agg.db`\n   - Windows: `%AppData%\\lite-reader\\agg.db`\n\n   Alternatively, point the binary at the old file with an absolute path:\n   ```sh\n   DB_PATH=/path/to/old/agg.db ./lite-reader\n   ```\n3. Run the new Lite Reader.\n\n## Contributing\nWe are looking for contributors! Here's how you can help:\n- Report bugs (https://github.com/cubny/lite-reader/issues/new)\n- Share your ideas (https://github.com/cubny/lite-reader/issues/new)\n- We are looking for a frontend engineer to rewrite the app with a modern stack\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contact\n- For any queries, please open an issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcubny%2Flite-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcubny%2Flite-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcubny%2Flite-reader/lists"}