{"id":13705191,"url":"https://github.com/joerncodes/obsidian-readwise-reader","last_synced_at":"2025-05-05T13:30:43.967Z","repository":{"id":57799869,"uuid":"525804618","full_name":"joerncodes/obsidian-readwise-reader","owner":"joerncodes","description":"Obsidian plugin to publish notes to the Reader service of readwise.io (which is currently in beta)","archived":false,"fork":false,"pushed_at":"2022-08-24T05:25:59.000Z","size":176,"stargazers_count":26,"open_issues_count":1,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-08-03T22:14:41.162Z","etag":null,"topics":["obsidian","obsidian-md","plugin","reader","readwise"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joerncodes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-08-17T13:29:29.000Z","updated_at":"2024-06-28T19:43:57.000Z","dependencies_parsed_at":"2023-01-16T18:45:53.986Z","dependency_job_id":null,"html_url":"https://github.com/joerncodes/obsidian-readwise-reader","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joerncodes%2Fobsidian-readwise-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joerncodes%2Fobsidian-readwise-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joerncodes%2Fobsidian-readwise-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joerncodes%2Fobsidian-readwise-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joerncodes","download_url":"https://codeload.github.com/joerncodes/obsidian-readwise-reader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224448887,"owners_count":17313139,"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":["obsidian","obsidian-md","plugin","reader","readwise"],"created_at":"2024-08-02T22:00:35.236Z","updated_at":"2024-11-13T12:31:26.419Z","avatar_url":"https://github.com/joerncodes.png","language":"TypeScript","funding_links":["https://ko-fi.com/joerndraws"],"categories":["Tools"],"sub_categories":["Obsidian"],"readme":"# Obsidian to Reader\n\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/joerncodes/obsidian-readwise-reader?style=for-the-badge\u0026sort=semver)](https://github.com/joerncodes/obsidian-readwise-reader/releases/latest)\n![GitHub Downloads](https://img.shields.io/github/downloads/joerncodes/obsidian-readwise-reader/total?style=for-the-badge)\n\n----\n\n**Important note**: This plugin is still very much **in beta**. There are still bugs I'm trying to work out, so before we go live in the Community Plugin repository, I'd be delighted if you could report any bugs you find. Thank you!\n\n----\n\nAn [Obsidian](https://obsidian.md) plugin to send notes to the [readwise.io Reader](https://read.readwise.io) service. Please note that Reader is currently in beta, so in order to use this plugin, your Readwise account must have access to this beta.\n\n## Installation\n\nAs this plugin is currently in early development, you can use [BRAT](https://github.com/TfTHacker/obsidian42-brat) to install it. Use the path `joerncodes/obsidian-readwise-reader`.\n\nIf you're interested in helping to make *Obsidian to Reader* a finished product, please see [Contributing](#contributing).\n\n## Commands\n\n### *Send to Reader*\n\nThe *Send to Reader* command sends the rendered HTML of the current Obsidian note to Reader. It will display a popup message containing the newly created (or recently updated) URL.\n\n### *Open document URL in Reader*\n\nIf the `Save Reader URL in front matter` is set, this plugin will write the Reader document URL into your Obsidian note's [YAML front matter](https://help.obsidian.md/Advanced+topics/YAML+front+matter) upon publishing. Use this command to open a new browser window with your Reader document.\n\n## Settings\n\n\u003cdl\u003e\n    \u003cdt\u003eAccess token\u003c/dt\u003e\n    \u003cdd\u003eYour access token for Readwise. You can find yours at \u003ca href=\"https://readwise.io/access_token\"\u003ehttps://readwise.io/access_token\u003c/a\u003e.\u003c/dd\u003e\n    \u003cdt\u003eGeneral tags\u003c/dt\u003e\n    \u003cdd\u003eProvide a comma separated list of tags, which will be automatically assigned to all Reader documents created with this plugin.\u003c/dd\u003e\n    \u003cdt\u003eSave Reader URL in front matter\u003c/dt\u003e\n    \u003cdd\u003eIf checked, the plugin will write the Reader url for your published document into your Obsidian note's front matter.\u003c/dd\u003e\n    \u003cdt\u003eFallback author\u003c/dt\u003e\n    \u003cdd\u003eProvide a string that gets used for the \u003ccode\u003eauthor\u003c/code\u003e field in Reader if no author front matter is present in your note.\u003c/dd\u003e\n    \u003cdt\u003eOmit front matter\u003c/dt\u003e\n    \u003cdd\u003eIf this is checked, only the note's body will be sent to Reader, without the front matter. Defaults to \u003ccode\u003etrue\u003c/code\u003e.\u003c/dd\u003e\n    \u003cdt\u003eSubmit note tags\u003c/dt\u003e\n    \u003cdd\u003eIf this is checked, your Obsidian note's tags (the ones written like \u003ccode\u003e#tag\u003c/code\u003e plus the ones from the front matter) get appended as Reader document tags. See also the \u003cem\u003eGeneral tags\u003c/em\u003e setting.\u003c/dd\u003e\n    \u003cdt\u003eTriage status\u003c/dt\u003e\n    \u003cdd\u003eWhich triage status to submit to Reader. This will tell Reader which \"tab\" oft he app to show your document in.\u003c/dd\u003e\n\u003c/dl\u003e\n\n## Front matter parsing\n\n`Obsidian to Reader` recognizes the following front matter keys:\n\n- `author`: Gets used as the author field in your Reader note\n- `image-url` and `banner`: Both fields get parsed as an image to send to use as the cover image for your Reader document. If both are present, `image-url` supercedes `banner`.[^1]\n- `reader-url`: Gets filled automatically upon publishing if the `Save Reader URL in front matter` setting is active\n- `summary`: Gets submmited as the Reader document's summary (the text you see in the list page).\n- `source`: Gets submitted as the Reader document's source URL (instead of the usual Obsidian Callback URL).\n\n## Changelog\n\nYou can find the changelog at [https://obsidiantoreader.com/changelog/](https://obsidiantoreader.com/changelog/)\n\n## Contributing\n\nI'm hoping to make *Obsidian to Reader* as awesome as possible, and I need your help to do it. Any issue opened here on GitHub is appreciated, whether it be a bug report or a feature request. \n\nIf you want to take the time to do a PR, those are welcomed with open arms.\n\n\n## Testing\n\nTests are written in [Jest](https://jestjs.io) and currently don't have great coverage yet. You can run the tests by executing:\n\n```bash\nnpm test\n```\n\n## Support\n\nMaking money is not the goal I had in mind when starting this plugin, but it sure helps! If you are feeling generous, you can [![](https://uploads-ssl.webflow.com/5c14e387dab576fe667689cf/61e11d503cc13747866d338b_Button-2-p-1080.png)](https://ko-fi.com/joerndraws)\n\n-----\n\n#### Footnotes \n\n[^1]: The reason for this fallback is the excellent [Obsidian Banners](https://github.com/noatpad/obsidian-banners) plugin.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoerncodes%2Fobsidian-readwise-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoerncodes%2Fobsidian-readwise-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoerncodes%2Fobsidian-readwise-reader/lists"}