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 String ✅ The title of the alert (displayed prominently).
notes 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+up+and+stretch!&notes=Time+to+take+a+break

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+Meeting&notes=Zoom+link+in+calendar&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 + or %20).
  • You can trigger alerts from Shortcuts, Terminal, scripts, or other apps.

Use Cases

  • Show reminders from your own app or automation
  • Create custom alerts in Apple Shortcuts
  • Integrate with productivity or focus tools
  • Display urgent messages for teammates or users

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.