JackyJacky

Catch events and manipulate third-party platform data directly from Jacky's routine engine.

Note

OAuth credentials and access tokens are saved locally on your device (stored encrypted-at-rest via the OS keyring like Windows Credential Manager or macOS Keychain). Your keys are never sent to any external server.


Supported OAuth Applications

  • Google Calendar: Connect your account to check upcoming schedules. Perfect for automatic routines that poll the Calendar API and announce events 5 minutes before they start.
  • GitHub: Monitor pull requests, commits, and issue activity on your repositories.
  • Spotify: Check the active track status, comment on songs in real-time, and manipulate your playback playlists.

Adding a New OAuth Connection

  1. Click Añadir... at the bottom of the connections table.
  2. Select your provider preset (Google, GitHub, Spotify, or Custom).
  3. Register a developer application on the target platform:
    • Google: Create a Desktop App client ID via the Google Cloud Console.
    • GitHub: Register an OAuth App. Use the displayed redirect URL in the configuration.
    • Spotify: Create an application on the Spotify Developer Dashboard.
  4. Input your Client ID and (if required) Client Secret.
  5. Specify the authorization scopes you want to request.
  6. Click Conectar (Connect) to open a browser window and authorize the application. Once authorized, the status column in the table will update to Conectado (Connected).

Redirect URIs

When registering developer applications, configure the redirect target as follows:

  • Desktop client: http://localhost (or loopback addresses like http://127.0.0.1:<port>).
  • Default callback port for Jacky: 8765 (http://127.0.0.1:8765/callback).

Provider-Specific Guides


Next Step: Create a Routine

Simply configuring an OAuth 2.0 integration only authorizes Jacky to communicate with the service. To allow your pet to actually access these events and respond to them, you must create a routine that references the configured integration.

Configure OAuth 2.0 Routines