Input valid JSON data
Example: {"upcoming_holidays":[{"date":"2025-02-14","name":"Holiday to Taj Mahal, India"},{"date":"2025-06-11","name":"Visiting Japan"},{"date":"2025-12-20","name":"Northern Lights Norway!"}]}

Learn how to build form fields here, or click here to verify syntax inline.
Example: - keyname: lookback_period field_type: select options: - '1' - '7' - '14' - '30' name: Lookback Period description: Time span of displayed data help_text: In days

Fetch from this server even when TRMNL cannot verify its HTTPS certificate, for example a home server with a self-signed certificate.

Connect to third-party services requiring OAuth2

Add this URL to your OAuth app's "Redirect URIs" or "Callback URLs"

Configure your OAuth provider credentials and settings

Borrow TRMNL's OAuth app instead of registering your own

Select a pre-configured provider to auto-fill OAuth settings, or configure manually

From your OAuth provider app settings
Example: your-client-id

Keep this secret!
Example: your-client-secret

When enabled, users who install your recipe can use your OAuth app (hidden from them)

OAuth2 authorization endpoint
Example: https://accounts.provider.com/oauth2/authorize

OAuth2 token endpoint
Example: https://accounts.provider.com/oauth2/token

List of scopes
Example: read user:email

Use Proof Key for Code Exchange (required by some providers like Twitter/X)

Extra parameters for the authorization URL
Example: {"token_access_type": "offline"}

Extra headers for the token request
Example: {"Notion-Version": "2022-06-28"}

Only needed if token endpoint is on a different domain than authorization
Example: https://swd.weatherflow.com

Extra body parameters for the token request
Example: {"type": "web_server"}

Character used to join multiple scopes

How to send client credentials during token exchange

Content type for token request body

Different endpoint for token refresh (optional)
Example: https://api.example.com/oauth/refresh

Extra fields to extract from the token response
Example: ["workspace_id", "owner"]

How to send client credentials to the authorization endpoint

Extra parameters for token refresh requests
Example: {"grant_type": "refresh_token"}

Field name in the OAuth response containing the access token
Example: access_token

Field name in the OAuth response containing the expiration
Example: expires_in

How to interpret the expiration value

Fixed token expiry in milliseconds (when not provided in response)
Example: 3600000

The fastest "Max refresh rate" anyone may pick for this plugin, including everyone who installs it as a recipe. Leave blank to allow every rate.

Defaults no. If "yes" is selected, padding around your markup will be removed.

Inverts black/white pixels. Will modify entire screen. Add class "image" to img tags as needed.

Run your transform script in the serverless runtime with the selected language.

Paste this URL into your webhook integration

Choose a specific Framework version for stability. Upgrade at your own pace for the latest improvements. Learn more

(Maps only) Where TRMNLMaps fetches vector tiles for maps in this plugin. A {z}/{x}/{y} template; {key} is replaced by the key below. Leave blank for the free public tiles.
Example: https://tiles.example.com/{z}/{x}/{y}.mvt?key={key}

(Maps only) The key your tile provider issued, stored encrypted. Fills {key} in the URL above.