Trigger Full-Screen Alerts via Deeplink

In Your Face can display a custom full-screen alert when opened via a special deeplink. This lets users and developers trigger alerts for any purpose — reminders, timers, or notifications — even outside the calendar.

inyourface://showAlert?title=<title>&notes=<notes>&from=<from date>&to=<to date>&snoozable=<true or false>

This deeplink accepts several parameters to customize the alert:

Parameter Type Required Description
title URL encoded String ✅ The title of the alert (displayed prominently).
notes URL encoded String ❌ Additional text or details shown when clicking the notes button.
from Unix timestamp ❌ Start time of the alert or event.
to Unix timestamp ❌ End time of the alert or event.
snoozable Boolean (true / false) ❌ Whether the alert includes a “Snooze” button. Defaults to true.

Example: Simple Alert

inyourface://showAlert?title=Stand%20up%20and%20stretch%21!&notes=Time%20to%20take%20a%20break

This immediately displays a full-screen alert with:

  • Title: “Stand up and stretch!”
  • Notes: “Time to take a break”
  • Snooze button: enabled (default)

Example: Timed Alert (with Snooze Disabled)

inyourface://showAlert?title=Team%20Meeting&notes=Zoom%20link%20in%20calendar&from=1734805200&to=1734808800&snoozable=false

This creates an alert titled “Team Meeting”, with:

  • Notes: “Zoom link in calendar”
  • Start time and end time based on the provided timestamps
  • Snooze button: disabled

Tips

  • The from and to parameters use Unix timestamps (seconds since Jan 1, 1970). You can convert human-readable times using tools like epochconverter.com.
  • All parameters must be URL-encoded (e.g. spaces become %20). Use a tool like urlencoder.org to encode a string.
  • You can trigger alerts from Shortcuts, Terminal, scripts, or other apps.

Use Cases

  • If you are a developer, show reminders from your own app
  • Create custom alerts in Apple Shortcuts
  • Integrate with productivity or focus tools
  • Display urgent messages for teammates or users

Some Examples

Home automation: Movement alert from security camera

On the left side is a still image from a front door security camera showing a hooded person. On the right side is a MacBook with a full screen alert saying 'Movement detected!'

Trading price alerts

On the left side is a bitcoin price chart. On the right side is a MacBook with a full screen alert saying 'BTC over 100k$!'

Try It Out

Paste a deeplink into your browser, run it in Shortcuts, or execute it from a script — In Your Face will instantly show your custom alert in full screen, no setup required.