/PoGOEvents

PoGOEvents is a Scriptable widget that displays current and upcoming Pokemon GO events.

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

Preview

PoGOEvents

PoGOEvents is a Scriptable widget that displays current and upcoming Pokemon GO events.

All event data is gathered from from ScrapedDuck, which scrapes LeekDuck.com periodically.

To follow development progress for this widget, check out the Trello board for PoGOEvents/ScrapedDuck.

Installation

  1. Install Scriptable from the app store.

  2. In the app, create a new script and copy/paste the contents of PoGOEvents.js

  3. Add a Scriptable widget to your home screen (Small, Medium, and Large widgets are supported). Then edit the widget and select the newly created script in the script field.

  • NOTE: If you've recently installed Scriptable, you may need to restart your device in order for the widgets to show up in the widget picker!
  1. To customize your widget, see Customization.

Customization

With Script

Due to limitations of Scriptable's parameter field, I've created a separate script (not a widget) that makes it easier to configure the widget to look the way you want.

To use, run the config script within Scriptable itself by tapping on it. You will then be prompted with the following questions:

1. What type of events should be displayed?

  • Current Events / Upcoming Events

If you'd like to see both current and upcoming events, you will need to add multiple widgets. Optionally, you can place them in a widget stack, making it easy to swipe between current and upcoming.

2. What style of widget do you want?

  • System Theme / Dark Theme / Light Theme

3. Do you want to whitelist any specific event types?

  • Yes / No

If you want to only see specific event types in this widget, select yes. You will then be prompted to list event types into a text field. For event types, see Event Types below.

4. Do you want to blacklist specific event types?

  • Yes / No

If you want to never see specific event types in this widget, select yes. You will then be prompted to list event types into a text field. For event types, see Event Types below.

5. Do you want to blacklist specific events?

  • Yes / No

If there are specific events that you never want to see in this widget (Ex: an event that lasts the entire season), select yes. You will then be prompted to list event IDs into a text field. Event IDs are the last section of the URL of the event's page.

Example:

  • URL: https://www.leekduck.com/events/season-of-alola/
  • ID: season-of-alola

You are then given a string that you can copy and paste into the parameter field on the widget itself.

Without Script

If you'd like to manually write out the parameters, here is how they are interpreted by the widget:

<category>|<theme>|<whitelisted even types separated by commas>|<blacklisted event types separated by commas>|<blacklisted event IDs separated by commas>

If a field is unused (at the end), you can optionally leave out the blank | characters. For example, if you only set a category and theme, <category>|<theme> would be valid.

Event Types

LeekDuck has events categorized into several event types. These types are listed in the ScrapedDuck event documentation here.