This plugin for Obsidian that allows you to sync your Pocket reading list into Obsidian, so that you can easily create Obsidian notes directly from your Pocket reading list.
The plugin will soon be installable from the "Community plugins" settings tab in Obsidian, as described here.
After the plugin has been enabled, you will be able to see a "Pocket" option under the "Plugin options" section of the settings panel, as shown below.
Click on "Connect your Pocket account" to begin the Pocket authorization flow by opening a web page on your default browser. You will be asked whether you want to give permission to this plugin to access your Pocket data. Then you will be redirected back to Obsidian.
If you granted permission to this plugin to access Pocket data, you can click on "Sync Pocket items" to actually download and store your Pocket list locally within Obsidian.
You can also sync your Pocket items using an Obsidian command: "Sync Pocket list".
Once the Pocket list is downloaded and stored, open the command palette and search for "Pocket" to see the list of available commands. The command to open the Pocket list is "Open Pocket list". The Pocket list is shown in a screenshot above.
Pocket tags are synced and presented in the Pocket list. Pocket supports tags with spaces in them, whereas Obsidian does not. The way that obsidian-pocket handles Pocket tags with spaces can be configured in the "Multi-word Pocket tag converter options" setting shown in the screenshot above.
The available options are:
- Snake case ('#tag with spaces' becomes #tag_with_spaces)
- Camel case ('#tag with spaces' becomes #TagWithSpaces)
- Do nothing ('#tag with spaces' remains unchanged)
These settings only affect the Pocket tags displayed in the Pocket list, and the
tags that are inserted into a Pocket item note if you have {{tags}} in your
Pocket item note template (see below for using templates for Pocket item
notes). They do not affect already-existing Obsidian tags or Pocket tags.
Click on any Pocket item's title to create a note (or navigate to an existing note) for that Pocket item. Notes for Pocket items will be created in the Pocket item notes folder, which can be configured in settings.
Open the Pocket item URL in your browser using Meta+click for Linux and Mac OS (e.g. command+click on Mac OS) and using Alt+click for Windows.
Meta+click (e.g. command+click on Mac OS) to open the Pocket item URL in your browser.
Notes in Obisidan are matched to Pocket items based on their name. If you find this setup limiting, please file a feature request (see bottom of this README for how to do that).
A template for new Pocket item notes can be specified in settings.
Templates for Pocket notes work similar to any other template in Obsidian, see here, except that only the following variables are supported:
| Variable name | What it means |
|---|---|
{{title}} |
The title of the Pocket item |
{{url}} |
The URL of the Pocket item |
{{excerpt}} |
The excerpt extracted by Pocket for the Pocket item |
{{tags}} |
The Pocket tags for the Pocket item |
Here's an example template that will put this metadata into the YAML frontmatter of the note for the Pocket item:
---
Title: {{title}}
URL: {{url}}
Tags: {{tags}}
Excerpt: >
{{excerpt}}
---
{{url}}
{{tags}}
If you had saved this URL to Pocket, synced it to Obsidian using this plugin and then created a note for the corresponding Pocket item with the above template, your note would start off containing the following:
---
Title: Carbon removal hype is becoming a dangerous distraction
URL: https://www.technologyreview.com/2021/07/08/1027908/carbon-removal-hype-is-a-dangerous-distraction-climate-change/
Excerpt: In February, oil giant Shell trumpeted a scenario in which the world pulls global warming back to 1.5 ˚C by 2100, even as natural gas, oil, and coal continue to generate huge shares of the world’s energy.
---
Feature requests, bug reports and PRs are welcome! Please use https://github.com/nybbles/obsidian-pocket/issues for this. Please file feature requests under https://github.com/nybbles/obsidian-pocket/labels/enhancement, or comment in existing feature requests to indicate your interest.
This plugin runs completely on your local desktop. The only external party it communicates with is Pocket, via the Pocket API. All of your data from Pocket and your Pocket access token are stored locally.
This plugin stores your Pocket data locally in Obsidian's IndexedDB.
If you find this plugin valuable, please let me know! It is great to hear from people who use what I've built. If you really like this plugin and want to express that by buying me a coffee, please do 🙏🏾.
Please don't feel obligated to donate!