https://github.com/dineshdb/readlater
readlater:// protocol handler and webextensions
https://github.com/dineshdb/readlater
getpocket read-later readlater
Last synced: about 2 months ago
JSON representation
readlater:// protocol handler and webextensions
- Host: GitHub
- URL: https://github.com/dineshdb/readlater
- Owner: dineshdb
- Created: 2025-01-29T18:19:33.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-24T05:27:39.000Z (3 months ago)
- Last Synced: 2025-02-24T06:22:17.606Z (3 months ago)
- Topics: getpocket, read-later, readlater
- Language: Rust
- Homepage: http://dbhattarai.info.np/readlater/
- Size: 102 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
Awesome Lists containing this project
README
# 
> readlater://save?url=https://example.org&tags
A protocol handler that will save any articles it receives to getpocket.
## Supported Features
This supports handling `readlater://save?url=&title=&tags=`
without installing web extension. If you install the
[webextension](https://addons.mozilla.org/en-US/firefox/addon/read_later/), it
provides additional features such as:
- toolbar button to save current url to pocket by clicking it.
Alternatively, you can use bookmarket to add items to the getpocket. Or just
paste properly formatted link to url bar.
## Setup
- Install the binary `cargo install --git https://github.com/dineshdb/readlater`
- Register protocol handler and WebExtension native-host `readlater register`
- Provide Pocket authentication `POCKET_CONSUMER_KEY`, `POCKET_ACCESS_TOKEN` via
env variable.
## Test
Visit the [hosted version of this page](https://dbhattarai.info.np/readlater/)
and then click
[this link](readlater://save?url=https://github.com/dineshdb/readlater) to add
the this repo url to pocket using `readlater://`.
## Bookmarklet
```javascript
javascript: (function () {
var currentUrl = encodeURIComponent(window.location.href);
var tags = prompt("Enter tags (comma-separated):", "");
if (tags !== null) {
var encodedTags = encodeURIComponent(tags);
var url = `readlater://save?url=${currentUrl}&tags=${encodedTags}`;
window.location.href = url;
}
})();
```
## Roadmap
- Protocol Handler
- Native Host and Protocol handler
- [x] Linux protocol handler for
`readlater://save?url=&title=&tags=`
- [x] Save new urls to Pocket
- Save links to pocket even when offline
- [x] Local cache of remote data
- [ ] Queue of save actions and background sync
- [ ] Tag imdb links as watchlater
- [ ] Tag archived imdb links as watched
- [ ] Tag youtube links as watchlater
- WebExtension
- [x] Add a `readlater://` button that saves current tab pocket
- [x] Release the web extension
- [x] Change toolbar icon based on result
- [x] Firefox(on Linux) Support
- [x] Keyboard shortcut (`Ctrl+Shift+L`)
- [ ] SideView with local cached data
- [ ] Add browser bookmarks to pocket with #bookmark tag
- [ ] Insert `readlater://` links in web pages for easier saving to
`readlater://`
- [ ] Support for Chrome and Chromium based browsers
- CI
- [x] Tests
- [ ] Release Binaries on Github packages
- [ ] Add a install script
- [ ] Decouple it from Pocket and make it pluggable.
## License
MIT