[](https://github.com/andgineer/goodreads-export/actions)
[](https://htmlpreview.github.io/?https://github.com/andgineer/goodreads-export/blob/python-coverage-comment-action-data/htmlcov/index.html)
# Export goodreads books into markdown files (Obsidian etc)
Transform your goodreads.com book reviews into structured markdown files,
ideal for use in [Obsidian](https://obsidian.md/) and other markdown-based applications.
- **Goodreads Book Page Links:** Each markdown file contains a direct link to the corresponding book's page on Goodreads.
- **Calibre Integration:** Includes a [Search in Calibre](https://calibre-ebook.com/) URL for each book, allowing quick searches
in your local Calibre collection.
- **Tagging Based on Goodreads Shelves:** Reviews are automatically categorized with tags derived from your Goodreads shelves.
- **Customizable Templates:** Utilizing Jinja2 templates, the output format can be easily customized to suit your specific needs or preferences.
# User manual
[goodreads-export](https://andgineer.github.io/goodreads-export/en/)
# Developers
### Codebase structure
[Auto-generated reference](https://andgineer.github.io/goodreads-export/docstrings/).
### Create / activate environment
. ./activate.sh
It will also install the package in [edit mode](https://realpython.com/what-is-pip/#installing-packages-in-editable-mode-to-ease-development).
### Setting Up Pre-commit for Formatting and Static Checks
1. **Install Pre-commit**:
```bash
pip install pre-commit
```
2. **Configure Pre-commit**:
```bash
pre-commit install
```
This sets up `pre-commit` in your local environment to run the same static checks as the `static` GitHub Action.
### Scripts
make help
## Coverage report
* [Codecov](https://app.codecov.io/gh/andgineer/goodreads-export/tree/main/src%2Fgoodreads_export)
* [Coveralls](https://coveralls.io/github/andgineer/goodreads-export)
Raw data
{
"_id": null,
"home_page": "https://andgineer.github.io/goodreads-export/en/",
"name": "goodreads-export",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "goodreads book markdown obsidian",
"author": "Andrey Sorokin",
"author_email": "andrey@sorokin.engineer",
"download_url": "https://files.pythonhosted.org/packages/59/ee/35e6bc68fa27ef4ed092a471c8e35a0889f4fded68fa1f4f7aa2f97650ff/goodreads_export-1.9.0.tar.gz",
"platform": null,
"description": "[](https://github.com/andgineer/goodreads-export/actions)\n[](https://htmlpreview.github.io/?https://github.com/andgineer/goodreads-export/blob/python-coverage-comment-action-data/htmlcov/index.html)\n# Export goodreads books into markdown files (Obsidian etc)\n\nTransform your goodreads.com book reviews into structured markdown files,\nideal for use in [Obsidian](https://obsidian.md/) and other markdown-based applications.\n\n- **Goodreads Book Page Links:** Each markdown file contains a direct link to the corresponding book's page on Goodreads.\n- **Calibre Integration:** Includes a [Search in Calibre](https://calibre-ebook.com/) URL for each book, allowing quick searches\nin your local Calibre collection.\n- **Tagging Based on Goodreads Shelves:** Reviews are automatically categorized with tags derived from your Goodreads shelves.\n- **Customizable Templates:** Utilizing Jinja2 templates, the output format can be easily customized to suit your specific needs or preferences.\n\n# User manual\n\n[goodreads-export](https://andgineer.github.io/goodreads-export/en/)\n\n# Developers\n### Codebase structure\n[Auto-generated reference](https://andgineer.github.io/goodreads-export/docstrings/).\n\n### Create / activate environment\n . ./activate.sh\n\nIt will also install the package in [edit mode](https://realpython.com/what-is-pip/#installing-packages-in-editable-mode-to-ease-development).\n\n### Setting Up Pre-commit for Formatting and Static Checks\n\n1. **Install Pre-commit**:\n ```bash\n pip install pre-commit\n ```\n\n2. **Configure Pre-commit**:\n ```bash\n pre-commit install\n ```\n\nThis sets up `pre-commit` in your local environment to run the same static checks as the `static` GitHub Action.\n\n### Scripts\n make help\n\n## Coverage report\n* [Codecov](https://app.codecov.io/gh/andgineer/goodreads-export/tree/main/src%2Fgoodreads_export)\n* [Coveralls](https://coveralls.io/github/andgineer/goodreads-export)\n",
"bugtrack_url": null,
"license": null,
"summary": "Convert goodreads books to markdown files, for example for Obsidian.",
"version": "1.9.0",
"project_urls": {
"Homepage": "https://andgineer.github.io/goodreads-export/en/"
},
"split_keywords": [
"goodreads",
"book",
"markdown",
"obsidian"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bfe87c4964ddd4a24dd76151ac418d85aede51a77ec5af360a2f4a6a0ee08f91",
"md5": "5d095c23fe08b3379c4d88dcc27c201e",
"sha256": "b03219a52e2100d92e0b0d795b040b7f25dfd7202a93783e7396dc7161bbfe09"
},
"downloads": -1,
"filename": "goodreads_export-1.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5d095c23fe08b3379c4d88dcc27c201e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 23586,
"upload_time": "2025-09-01T04:47:29",
"upload_time_iso_8601": "2025-09-01T04:47:29.639589Z",
"url": "https://files.pythonhosted.org/packages/bf/e8/7c4964ddd4a24dd76151ac418d85aede51a77ec5af360a2f4a6a0ee08f91/goodreads_export-1.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "59ee35e6bc68fa27ef4ed092a471c8e35a0889f4fded68fa1f4f7aa2f97650ff",
"md5": "e83c9cb257c0c81742e975be3b38fe25",
"sha256": "996e37a7d816c0b14278d6d49799867c3ec922d985079a5468f19a1f7356b5e3"
},
"downloads": -1,
"filename": "goodreads_export-1.9.0.tar.gz",
"has_sig": false,
"md5_digest": "e83c9cb257c0c81742e975be3b38fe25",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 23270,
"upload_time": "2025-09-01T04:47:30",
"upload_time_iso_8601": "2025-09-01T04:47:30.853223Z",
"url": "https://files.pythonhosted.org/packages/59/ee/35e6bc68fa27ef4ed092a471c8e35a0889f4fded68fa1f4f7aa2f97650ff/goodreads_export-1.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-01 04:47:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "goodreads-export"
}
JSON