{"id":16139538,"url":"https://github.com/bergercookie/mendeley2calibre","last_synced_at":"2025-06-22T19:05:17.732Z","repository":{"id":78140176,"uuid":"129114208","full_name":"bergercookie/mendeley2calibre","owner":"bergercookie","description":"Conversion tool for migrating a Mendeley DB to calibre","archived":false,"fork":false,"pushed_at":"2018-04-23T00:23:10.000Z","size":32,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-12T23:45:40.855Z","etag":null,"topics":["calibre","conversion","mendeley-library","python3","scientific-papers"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bergercookie.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}},"created_at":"2018-04-11T15:22:27.000Z","updated_at":"2018-09-30T13:21:04.000Z","dependencies_parsed_at":"2023-02-26T20:01:03.436Z","dependency_job_id":null,"html_url":"https://github.com/bergercookie/mendeley2calibre","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bergercookie%2Fmendeley2calibre","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bergercookie%2Fmendeley2calibre/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bergercookie%2Fmendeley2calibre/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bergercookie%2Fmendeley2calibre/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bergercookie","download_url":"https://codeload.github.com/bergercookie/mendeley2calibre/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247526675,"owners_count":20953141,"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","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","conversion","mendeley-library","python3","scientific-papers"],"created_at":"2024-10-09T23:49:16.983Z","updated_at":"2025-04-06T17:43:34.215Z","avatar_url":"https://github.com/bergercookie.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mendeley2calibre\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://travis-ci.org/bergercookie/mendeley2calibre\" alt=\"Build Status\"\u003e\n  \u003cimg src=\"https://travis-ci.org/bergercookie/mendeley2calibre.svg?branch=master\" /\u003e\u003c/a\u003e\n\n  \u003ca href='http://mendeley2calibre.readthedocs.io/en/latest/?badge=latest'\u003e\n  \u003cimg src='https://readthedocs.org/projects/mendeley2calibre/badge/?version=latest' alt='Documentation Status' /\u003e\u003c/a\u003e\n\n  \u003ca href=\"https://github.com/bergercookie/mendeley2calibre/blob/master/LICENSE\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/pypi/l/Django.svg\" /\u003e\u003c/a\u003e\n\n  \u003ca href=\"https://www.python.org/\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Made%20with-Python-1f425f.svg\" /\u003e\u003c/a\u003e\n\n\u003c/p\u003e\n\n\n```\n                              _        _               ___              _  _  _\n                             | |      | |             |__ \\            | |(_)| |\n  _ __ ___    ___  _ __    __| |  ___ | |  ___  _   _    ) | ___  __ _ | | _ | |__   _ __  ___\n | '_ ` _ \\  / _ \\| '_ \\  / _` | / _ \\| | / _ \\| | | |  / / / __|/ _` || || || '_ \\ | '__|/ _ \\\n | | | | | ||  __/| | | || (_| ||  __/| ||  __/| |_| | / /_| (__| (_| || || || |_) || |  |  __/\n |_| |_| |_| \\___||_| |_| \\__,_| \\___||_| \\___| \\__, ||____|\\___|\\__,_||_||_||_.__/ |_|   \\___|\n                                                 __/ |\n                                                |___/\n```\n\n\n## Description\n\nConversion tool for migrating a Mendeley DB to calibre. mendeley2calibre parses\nthe local mendeley sqlite3 db and imports the files + metadata found there to\nthe corresponding Calibre db. Parsing of the mendeley db is carried out using\nthe [bergercookie/pymendeley](https://github.com/bergercookie/pymendeley)\npackage.\n\n## Setup\n\nInstall the package locally using pip:\n  ```sh\n  pip3 install --user --upgrade git+https://github.com/bergercookie/pymendeley\n  pip3 install --user --upgrade git+https://github.com/bergercookie/mendeley2calibre\n  ```\n\n## Usage\n\nMigrate the mendeley db using the mendeley2calibre script\n  ```sh\n  mendeley2calibre --help\n\n  Usage: migrate_to_calibre.py [OPTIONS]\n\n  Options:\n    -c, --calibre-lib PATH   Top-level path to the Calibre library  [required]\n    -m, --mendeley-lib PATH  Path to the Mendeley sqlite3 DB. If not specified\n                             ./migrate_to_calibre.py will try to guess where\n                             that is.\n    --help                   Show this message and exit.\n\n  ```\n\n## Offline documentation\n\nA developer can also generate the `Sphinx` documentation for `mendeley2calibre` offline:\n\n- Install the related tools:\n\n  ```sh\n  apt-get install sphinx sphinx_rtd_theme\n  ```\n- To update the documentation run `make html` inside the `docs` directory.\n    Open the `build/html/index.html` file to view the results\n\n  ```sh\n  firefox docs/build/html/index.html\n  ```\n\n\n## Roadmap\n\n- [X] Come up with a working version\n- [X] Use mypy for static checking\n- [X] Generate Sphinx documentation\n- [X] Authors, Document Tags Support\n- [X] Optional argument for specifying the mendeley path as well\n- [ ] Unittests\n  - [ ] pymendeley\n  - [ ] calibre2mendeley\n- [ ] Basic CI script that runs unittests, flake stats + posting\n- [ ] Github badges (pymendeley, mendeley2calibre)\n  - [X] pymendeley - pylint badge - https://github.com/mperlet/pybadge\n  - [ ] calibre2mendeley - pylint badge - https://github.com/mperlet/pybadge\n  - [X] CI\n  - [X] Documentation\n- [ ] Cleanup Todos\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbergercookie%2Fmendeley2calibre","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbergercookie%2Fmendeley2calibre","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbergercookie%2Fmendeley2calibre/lists"}