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!
An Obsidian plugin to send notes to the readwise.io Reader 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.
As this plugin is currently in early development, you can use BRAT to install it. Use the path joerncodes/obsidian-readwise-reader.
If you're interested in helping to make Obsidian to Reader a finished product, please see Contributing.
The 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.
If 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 upon publishing. Use this command to open a new browser window with your Reader document.
- Access token
- Your access token for Readwise. You can find yours at https://readwise.io/access_token.
- General tags
- Provide a comma separated list of tags, which will be automatically assigned to all Reader documents created with this plugin.
- Save Reader URL in front matter
- If checked, the plugin will write the Reader url for your published document into your Obsidian note's front matter.
- Fallback author
- Provide a string that gets used for the
authorfield in Reader if no author front matter is present in your note. - Omit front matter
- If this is checked, only the note's body will be sent to Reader, without the front matter. Defaults to
true. - Submit note tags
- If this is checked, your Obsidian note's tags (the ones written like
#tagplus the ones from the front matter) get appended as Reader document tags. See also the General tags setting. - Triage status
- Which triage status to submit to Reader. This will tell Reader which "tab" oft he app to show your document in.
Obsidian to Reader recognizes the following front matter keys:
author: Gets used as the author field in your Reader noteimage-urlandbanner: Both fields get parsed as an image to send to use as the cover image for your Reader document. If both are present,image-urlsupercedesbanner.1reader-url: Gets filled automatically upon publishing if theSave Reader URL in front mattersetting is activesummary: Gets submmited as the Reader document's summary (the text you see in the list page).source: Gets submitted as the Reader document's source URL (instead of the usual Obsidian Callback URL).
You can find the changelog at https://obsidiantoreader.com/changelog/
I'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.
If you want to take the time to do a PR, those are welcomed with open arms.
Tests are written in Jest and currently don't have great coverage yet. You can run the tests by executing:
npm testMaking money is not the goal I had in mind when starting this plugin, but it sure helps! If you are feeling generous, you can
Footnotes
-
The reason for this fallback is the excellent Obsidian Banners plugin. ↩