Skip to content

Add local-network OPDS sharing v1 - #137

Draft
phildenhoff wants to merge 16 commits into
mainfrom
phil/cdl-27-validate-and-harden-the-packaged-opds-experience-with
Draft

Add local-network OPDS sharing v1#137
phildenhoff wants to merge 16 commits into
mainfrom
phil/cdl-27-validate-and-harden-the-packaged-opds-experience-with

Conversation

@phildenhoff

Copy link
Copy Markdown
Member

What changed

  • adds an interface-scoped, IPv4/IPv6 OPDS 1.x server that exists only while the desktop app is running
  • serves the active Calibre library with acquisition feeds, pagination, search, recent/unread views, authors, series, tags, and canonical genres
  • adds optional HTTP Basic authentication with backend-owned Argon2id credential storage
  • adds desktop sharing management, actionable listener states, and a separate headless server entry point
  • adds representative fixture generation, protocol/package validation, documentation, and Linux build hardening

Why

Citadel users need a deliberately enabled, read-only way to browse and download the active library from KOReader over their local network. This keeps OPDS access separate from frontend management RPCs, starts sharing off on every process launch, avoids HTTPS/Bonjour/QR scope, and preserves a reusable core for future hosted deployment.

Validation

  • cargo test
  • bun lint (passes with existing warnings)
  • bun format and bun format:check
  • packaged macOS IPv4/IPv6, auth, lifecycle, catalog, metadata, cover, range, concurrency, and active-library smoke/crawl
  • Ubuntu 24.04 ARM64 .deb install/launch and AppImage bundle/launch
  • real-device early-path confirmation from KOReader on a Kobo Libra Colour over en0 with Basic auth

Tracks CDL-20 and CDL-27.

@linear-code

linear-code Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

CDL-27

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

libcalibre Test Coverage Report

Overall coverage: 83.86%

📊 Download HTML Report

Coverage breakdown available in the artifacts.

@phildenhoff
phildenhoff force-pushed the phil/cdl-27-validate-and-harden-the-packaged-opds-experience-with branch from 529d0aa to b58c984 Compare August 3, 2026 03:29
@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

libcalibre Test Coverage Report

Overall coverage: 83.86%

📊 Download HTML Report

Coverage breakdown available in the artifacts.

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

libcalibre Test Coverage Report

Overall coverage: 83.86%

📊 Download HTML Report

Coverage breakdown available in the artifacts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant