{"id":51326670,"url":"https://github.com/ganbarovemin/calibre-livelib-metadata-plugin","last_synced_at":"2026-07-04T22:00:30.718Z","repository":{"id":367960127,"uuid":"1282968015","full_name":"GanbarovEmin/calibre-livelib-metadata-plugin","owner":"GanbarovEmin","description":"Calibre metadata source plugin for Russian books using LiveLib, LitRes, and FantLab","archived":false,"fork":false,"pushed_at":"2026-06-28T13:59:05.000Z","size":12,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-28T14:06:37.841Z","etag":null,"topics":["calibre","calibre-plugin","fantlab","litres","livelib","metadata","russian-books"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GanbarovEmin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2026-06-28T12:03:03.000Z","updated_at":"2026-06-28T13:59:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/GanbarovEmin/calibre-livelib-metadata-plugin","commit_stats":null,"previous_names":["ganbarovemin/calibre-livelib-metadata-plugin"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/GanbarovEmin/calibre-livelib-metadata-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GanbarovEmin%2Fcalibre-livelib-metadata-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GanbarovEmin%2Fcalibre-livelib-metadata-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GanbarovEmin%2Fcalibre-livelib-metadata-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GanbarovEmin%2Fcalibre-livelib-metadata-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GanbarovEmin","download_url":"https://codeload.github.com/GanbarovEmin/calibre-livelib-metadata-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GanbarovEmin%2Fcalibre-livelib-metadata-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35019037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"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":["calibre","calibre-plugin","fantlab","litres","livelib","metadata","russian-books"],"created_at":"2026-07-01T19:01:33.461Z","updated_at":"2026-07-01T19:01:35.207Z","avatar_url":"https://github.com/GanbarovEmin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LiveLib Metadata for Calibre\n\n`LiveLib Metadata` is a Calibre metadata source plugin for Russian-language book libraries.\n\nIt improves Calibre metadata lookup for books that are better represented on Russian book services than on the default Calibre sources. The plugin searches LiveLib, LitRes, and FantLab, then returns Russian descriptions, tags, identifiers, publication details, and covers.\n\n## Features\n\n- Searches LiveLib beta pages and parses structured book metadata.\n- Uses the public LitRes API as the first source when it has a strong match.\n- Uses FantLab as an additional fallback for genre and speculative fiction titles.\n- Downloads Russian descriptions and genre tags.\n- Imports ISBN, publisher, publication year, rating, and LiveLib vote count when available.\n- Adds edition details to comments: series, page count, binding, paper type, weight, size, and age rating.\n- Prefers high-resolution LiveLib cover URLs (`/o/...jpeg`) and falls back to preview covers when needed.\n- Rejects weak title/author matches to avoid replacing a book with a same-title result by another author.\n\n## Search Order\n\n1. `litres:` identifier, when already present.\n2. `livelib:` identifier, when already present.\n3. LitRes public API search.\n4. LiveLib beta search: `https://beta.livelib.ru/search?q=...`.\n5. Old LiveLib search as a fallback: `https://www.livelib.ru/find/...`.\n6. FantLab public API search.\n\n## Installation\n\n1. Download `LiveLib.Metadata.zip` from the latest GitHub release.\n2. Open Calibre.\n3. Go to `Preferences -\u003e Plugins -\u003e Load plugin from file`.\n4. Select `LiveLib Metadata.zip`.\n5. Restart Calibre.\n6. Go to `Preferences -\u003e Metadata download` and make sure `LiveLib Metadata` is enabled.\n\n## Updating\n\nDownload the new `LiveLib.Metadata.zip` from the latest release and install it through `Load plugin from file` again. Calibre will replace the previous version after restart.\n\nThis repository also includes a GitHub Actions release workflow. When a new tag like `v0.3.2` is pushed, GitHub builds a fresh plugin zip and attaches it to the release automatically.\n\n## Building Locally\n\n```bash\n./scripts/build-plugin.sh\n```\n\nThe build output is written to:\n\n```text\ndist/LiveLib.Metadata.zip\n```\n\n## Notes\n\nCalibre has no native page-count field, so physical edition details are appended to comments under `Детали издания LiveLib`.\n\nLiveLib and LitRes are third-party services. Their HTML/API behavior can change, so releases may update parsers and matching rules as needed.\n\n## License\n\nGPL-3.0-only.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fganbarovemin%2Fcalibre-livelib-metadata-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fganbarovemin%2Fcalibre-livelib-metadata-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fganbarovemin%2Fcalibre-livelib-metadata-plugin/lists"}