{"id":42043542,"url":"https://github.com/abfcode/librium","last_synced_at":"2026-01-26T06:04:00.187Z","repository":{"id":284256972,"uuid":"927260924","full_name":"ABFCode/Librium","owner":"ABFCode","description":"Web-based personal ebook library and reader focused on EPUBs. Built with React and Spring Boot.","archived":false,"fork":false,"pushed_at":"2026-01-25T00:52:57.000Z","size":2763,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-25T09:09:27.427Z","etag":null,"topics":["digital-library","ebook-reader","epub","java","postgresql","react","spring-boot","tailwindcss","typescript","web-application"],"latest_commit_sha":null,"homepage":"","language":"Java","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/ABFCode.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-04T17:07:55.000Z","updated_at":"2025-12-08T03:08:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"017ea89c-0c1b-4f74-9d84-5b8a651493a5","html_url":"https://github.com/ABFCode/Librium","commit_stats":null,"previous_names":["abfcode/springreader","abfcode/librium.dev"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ABFCode/Librium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABFCode%2FLibrium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABFCode%2FLibrium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABFCode%2FLibrium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABFCode%2FLibrium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ABFCode","download_url":"https://codeload.github.com/ABFCode/Librium/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ABFCode%2FLibrium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28768026,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T03:54:34.369Z","status":"ssl_error","status_checked_at":"2026-01-26T03:54:33.031Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["digital-library","ebook-reader","epub","java","postgresql","react","spring-boot","tailwindcss","typescript","web-application"],"created_at":"2026-01-26T06:03:59.185Z","updated_at":"2026-01-26T06:04:00.182Z","avatar_url":"https://github.com/ABFCode.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Librium — Personal Ebook Library \u0026 Reader\n\nLibrium is a performance‑focused web app for uploading, managing, and reading your personal EPUB library. It’s built as a modern, real‑time stack with a dedicated parser service.\n\n## Stack\n\n* **Web app:** TanStack Start + React 19 + Vite + Tailwind (`/web`)\n* **Data/Auth:** Convex (with Better Auth) (`/web/convex`)\n* **Parser:** Go microservice using Spine for EPUB parsing (`/parser`)\n* **Storage:** Convex Storage (EPUBs, section text, and assets)\n\n## Features (current)\n\n* **Auth:** Email/password sign‑in + sign‑up\n* **Import:** Upload EPUBs, async parsing + ingest\n* **Library:** Covers, title/author, download, delete\n* **Reader:** TOC, next/prev, arrow keys, bookmarks, search\n* **Reader prefs:** Font size, line height, content width, theme\n* **Progress:** Remembers last section + scroll position\n\n## Quick start (dev)\n\n1) Install dependencies:\n```\ncd web\npnpm install\n```\n\n2) Install Playwright browsers (for UI tests):\n```\ncd web\npnpm exec playwright install\n```\nIf Playwright reports missing system libraries on Linux, run:\n```\ncd web\nnpx playwright install-deps\n```\n\n3) Start the parser:\n```\ncd parser\ngo run ./main.go\n```\n\n4) Start Convex:\n```\ncd web\npnpm convex dev\n```\n\n5) Start the web app:\n```\ncd web\npnpm dev\n```\n\nThe parser defaults to `http://localhost:8081/parse`. Override with `PARSER_URL` if needed.\n\n## Resetting dev data\n\n```\nmake convex-reset CONFIRM=RESET\n```\n\n## Tests\n\n```\ncd web\npnpm test\n```\n\nBrowser tests run headless by default in CI. To see the browser locally:\n```\ncd web\nVITEST_BROWSER_HEADLESS=false pnpm test:watch\n```\n\nTo run only browser or node tests:\n```\ncd web\npnpm test:browser\npnpm test:node\n```\n\nE2E smoke tests (Playwright):\n```\ncd web\npnpm test:e2e\n```\n\n## Known limitations (0.1.0)\n\n- EPUB only (additional formats planned).\n- Parser service required for imports (separate Go service).\n- Auth is basic email/password (reset/2FA planned).\n- Offline reading is not supported yet.\n\n## Status\n\nActive development. Expect breaking changes while the new stack stabilizes.\n\n## License\n\nApache License 2.0. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabfcode%2Flibrium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabfcode%2Flibrium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabfcode%2Flibrium/lists"}