Use the Timer+ URL Scheme

Timer+ can be launched from another app with its URL scheme. This is useful in automation and launcher apps that can open a URL and pass timer details to Timer+.

Start a quick timer

Use this URL to create and start a quick timer. Quick timers are removed after they finish.

timerplus://app/quick-timers/new?hours=[hours]&minutes=[minutes]&seconds=[seconds]&name=[name]

All parameters are optional and accept whole numbers, except name:

• hours
• minutes
• seconds
• name

For example:

timerplus://app/quick-timers/new?hours=1&minutes=23&seconds=45

starts a timer for 1 hour, 23 minutes, and 45 seconds. To start a 50-minute timer named Laundry:

timerplus://app/quick-timers/new?minutes=50&name=Laundry

The total duration can be up to 100 hours. If you leave out the duration, or if the supplied duration totals 0, Timer+ opens a new Quick Timer screen so you can enter it yourself.

Start a quick stopwatch

Use this URL to start a quick stopwatch:

timerplus://app/quick-stopwatches/new?name=[name]

For example:

timerplus://app/quick-stopwatches/new?name=Plank

Quick stopwatches are removed after you use them.

Use x-callback-url

Timer+ supports the x-source and x-success parameters from the x-callback-url specification. To use them, replace timerplus://app/ with timerplus://x-callback-url/.

For example:

timerplus://x-callback-url/quick-timers/new?minutes=50&name=Laundry&x-source=[source]&x-success=[success-url]

When x-success is set, Timer+ tries to open that URL after it completes the requested action.