{"id":14070534,"url":"https://github.com/MichaBrugger/booksidian_plugin","last_synced_at":"2025-07-30T07:33:42.881Z","repository":{"id":41981314,"uuid":"429909794","full_name":"MichaBrugger/booksidian_plugin","owner":"MichaBrugger","description":"A plugin to connect your Goodreads shelves to your Obsidian vault.","archived":false,"fork":false,"pushed_at":"2024-06-24T20:49:16.000Z","size":716,"stargazers_count":120,"open_issues_count":6,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-06-24T22:24:15.799Z","etag":null,"topics":["goodreads","obisidian","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MichaBrugger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","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},"funding":{"ko_fi":"michabrugger"}},"created_at":"2021-11-19T19:18:47.000Z","updated_at":"2024-06-24T20:49:15.000Z","dependencies_parsed_at":"2024-06-24T22:27:26.470Z","dependency_job_id":null,"html_url":"https://github.com/MichaBrugger/booksidian_plugin","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaBrugger%2Fbooksidian_plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaBrugger%2Fbooksidian_plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaBrugger%2Fbooksidian_plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaBrugger%2Fbooksidian_plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichaBrugger","download_url":"https://codeload.github.com/MichaBrugger/booksidian_plugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":215155197,"owners_count":15836926,"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":["goodreads","obisidian","typescript"],"created_at":"2024-08-13T07:07:50.312Z","updated_at":"2024-08-13T07:17:15.045Z","avatar_url":"https://github.com/MichaBrugger.png","language":"TypeScript","funding_links":["https://ko-fi.com/michabrugger"],"categories":["TypeScript"],"sub_categories":[],"readme":"# Booksidian\r\n\r\nBooksidian brings your Goodreads data to Obsidian.\r\n\r\nYou can set both the body and the frontmatter for your book-note by choosing from the list of parameters available over the Goodreads RSS feed (+ some extra that can be deduced from them like subtitle or series).\r\n\r\n![image](https://user-images.githubusercontent.com/46029522/152006018-bfab5d8a-e829-4dbd-b19e-84a9af19e258.png)\r\n\r\n## Setup Instructions\r\n\r\nPlease note that the way Goodreads handles their RSS feed, only the first 100 items of a shelf are added to the respective RSS feed. So if you have more than 100 books you'd like to export from one shelf, you have to split them into multiple shelves.\r\n\r\n#### Creating Shelves\r\nYou can create those in Goodreads und `My Books` and then `Add shelf` in the left-side menu:\r\n![image](https://user-images.githubusercontent.com/46029522/152001408-87c88a68-b161-4dfd-9845-d6036a05992b.png)\r\n\r\n#### Getting the Feed Base-URL\r\nYou get the RSS Base URL by setting the items loaded per page to `infinite scroll` and then click the orange `RSS` button in the bottom right.\r\n\r\n![image](https://user-images.githubusercontent.com/46029522/152004240-2580c551-d603-4119-9dd5-95a3bf68b764.png)\r\n\r\n\r\nThis will open a new page. You can now copy that URL and remove everything after the last \"=\". This is your RSS Base URL. After setting this, you can add all the shelves you'd like to download by just adding their names (separated by comma) in the settings.\r\n\r\n![image](https://user-images.githubusercontent.com/46029522/152002763-444c05e1-3a5f-426b-9493-beb99deb9aa3.png)\r\n\r\n### Running Booksidian\r\nYou can run the Booksidian sync by executing the \"Booksidian Sync\" command or by pressing the \"B\" in your menu bar.\r\n\r\nAlternatively, you can set Booksidian to sync automatically by updating the `frequency` in the plugin settings.\r\n\r\n### Overwriting Notes\r\n\r\nBy default, once Booksidian has synced a book from your RSS feed and created a note, that note will never be updated or changed, even if the data related to that book changes within your feed. For example if you sync a book, then give it a rating and sync again, that rating will not be synced to the note.\r\n\r\nTo have Booksidian overwrite old notes, toggle the `overwrite` plugin setting on. This will cause Booksidian to always replace existing notes for books with new ones. Be careful though - if you've made your own updates to the notes files, they'll be lost on the next sync.\r\n\r\n## Output\r\n\r\nIn the end it's completely up to you how you style your book-notes. One thing I personally love is combining it with the `dataview plugin` and the new cards system in the `minimal theme`, which enables you to create beautiful little libraries like this: \r\n\r\n![image](https://user-images.githubusercontent.com/46029522/151970426-377a5997-7c15-4670-b423-17bb04b3720a.png)\r\n\r\nYou can achieve this look here by adding `cssClasses: cards` to the frontmatter of the file you'd like to have your library in and then pasting this code here:\r\n\r\n```dataview\r\ntable without id (\"![](\" + cover +\")\") as Cover, author as Author\r\nwhere cover != null\r\nsort rating desc\r\n```\r\n\r\nPlease check out the amazing work of these two [here](https://github.com/blacksmithgu/obsidian-dataview) and [here](https://github.com/kepano/obsidian-minimal).\r\n\r\n### Linking back to Goodreads\r\n\r\nThe Goodreads book `id` is provided as part of the available data in the plugin. You can create a link back to the Goodreads page for a book by doing:\r\n\r\n```\r\nhttps://www.goodreads.com/book/show/{{id}}\r\n```\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMichaBrugger%2Fbooksidian_plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMichaBrugger%2Fbooksidian_plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMichaBrugger%2Fbooksidian_plugin/lists"}