mirror of https://github.com/calibrain/shelfmark.git synced 2026-10-02 20:20:11 +01:00

Files

T

Alex a4173eafcb Restructure + abstraction, plugin system, settings UI, universal search mode (#351 )

Key changes:   

| Category | Lines | What it is |

|--------------------------|--------|----------------------------------------------------------------------|
| Docs | ~2,100 | plugin-settings.md, release-sources-plugin-guide.md,
provider README |
| Settings UI | ~1,650 | Modal, sidebar, field components (TextField,
SelectField, etc.) |
| ReleaseModal | ~1,200 | Universal mode release picker UI |
| Metadata Providers | ~2,100 | Hardcover + OpenLibrary + base classes |
| Core Infrastructure | ~2,150 | Cache decorator, queue, image cache,
models, config |
| main.py | ~1,570 | Flask routes (replaces old app.py but bigger) |
| Orchestrator | ~590 | Download queue management |
| Config/Settings Registry | ~1,400 | Backend settings system |
| Frontend Hooks | ~750 | useSettings, useSearch, useDownloadTracking,
etc. |
| Other Frontend | ~500 | BookGetButton, ReleaseCell, utils |
| Release Sources base | ~320 | Plugin interfaces |

2025-12-22 12:13:11 -05:00

1.8 KiB

Raw Blame History

URL Search Parameters

You can trigger searches directly via URL by adding query parameters. This enables bookmarking searches and sharing links.

Basic Usage

http://your-server:8084/?q=harry+potter

Supported Parameters

Parameter	Description	Example
`q` or `query`	Main search query	`/?q=dune`
`author`	Filter by author name	`/?author=frank+herbert`
`title`	Filter by book title	`/?title=foundation`
`isbn`	Filter by ISBN	`/?isbn=978-0747532699`
`lang`	Filter by language (ISO 639-1 code)	`/?lang=en`
`format`	Filter by file format	`/?format=epub`
`content`	Filter by content type	`/?content=fiction`
`sort`	Sort order for results	`/?sort=newest`

Multiple Values

Some parameters support multiple values by repeating the parameter:

/?lang=en&lang=de&lang=fr
/?format=epub&format=mobi&format=azw3

Examples

Simple search:

/?q=lord+of+the+rings

Search with author filter:

/?q=dune&author=frank+herbert

Search with format and language:

/?q=harry+potter&format=epub&lang=en

Author search with multiple formats:

/?author=stephen+king&format=epub&format=mobi

Search with sort order:

/?q=science+fiction&sort=newest

Search Mode Behavior

Direct Download Mode (default)

All parameters are used to filter results from Anna's Archive.

Universal Mode

Only q and sort are used. Other parameters (author, title, format, etc.) are silently ignored since metadata providers have their own search capabilities.

Notes

URL parameters are read once on page load
The URL is not updated when you perform searches manually
Spaces should be encoded as + or %20
Invalid or unknown parameters are silently ignored

1.8 KiB Raw Blame History