https://github.com/brianseidman/scriptable-pocket-widget

Unofficial Pocket favorites and unread widgets powered by Scriptable.
https://github.com/brianseidman/scriptable-pocket-widget

getpocket ios ios-widget pocket pocket-api scriptable scriptable-app scriptable-widgets

Last synced: about 1 month ago
JSON representation

Unofficial Pocket favorites and unread widgets powered by Scriptable.

• Host: GitHub
• URL: https://github.com/brianseidman/scriptable-pocket-widget
• Owner: brianseidman
• License: gpl-3.0
• Created: 2021-12-14T03:03:06.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2022-06-14T15:08:53.000Z (over 2 years ago)
• Last Synced: 2024-08-04T00:11:31.745Z (5 months ago)
• Topics: getpocket, ios, ios-widget, pocket, pocket-api, scriptable, scriptable-app, scriptable-widgets
• Language: JavaScript
• Homepage:
• Size: 583 KB
• Stars: 12
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-scriptable - scriptable-pocket-widget - Shows unread or favorited Pocket articles. (Reading)

README

        
# Pocket Widgets (Unofficial) [![Mentioned in Awesome Scriptable](https://awesome.re/mentioned-badge.svg)](https://github.com/dersvenhesse/awesome-scriptable#readme)

"Unread" and "Favorites" iOS widgets for [Pocket](https://getpocket.com).



Pocket is Mozilla's popular read-it-later service. Unfortunately, on iOS Pocket only offers a "Discover" widget showing you trending articles; there aren't widgets to show your own favorite (starred) or unread articles. These scripts, deployed through the Scriptable app, bring those missing widgets to your device.

Easy set-up:

* 🧑‍💻 Install the [Scriptable](https://scriptable.app) app by [Simon Støvring](https://github.com/simonbs). 

* 📁 Download the Pocket widget files to your Scriptable folder.

* 😀 Add your Pocket credentials and choose between "Unread" and "Favorites." That's it!

## Usage

You will need a consumer key and access token to query your user data with the Pocket API. To create those credentials:

* Follow the documentation on the [Pocket: Developer API](https://getpocket.com/developer/) site.

* Use one of the many third-party Pocket credential creation tools like [OneClickPocket](http://reader.fxneumann.de/plugins/oneclickpocket/auth.php) or [pocket-auth](https://github.com/mheap/pocket-auth).

## Preferences

The Pocket widget can be easily modified with these three lines of code in the pocket_widget.js file:

```

let attributes = {

	"consumerKey": "YOUR-CONSUMER-KEY",

	"accessToken": "YOUR-ACCESS-TOKEN",

	"favorite": 1  // Enter 0 for "Unread"; enter 1 for "Favorites"

} 

```

Replace YOUR-CONSUMER-KEY and YOUR-ACCESS-TOKEN with the respective consumer key and access token for your account. To show your two most recent Pocket favorites in the widget, leave the "favorite" value as 1; changing the "favorite" value to 0 will show your two most recent unread saved articles. No modification of the pocket_widget/pocket_widget_code.js file is necessary.