Skip to content

Timer+

Timer+ is an iOS timer and stopwatch app. Protocol Launcher allows you to generate official URL scheme links to start quick timers and quick stopwatches in Timer+.

Usage

There are two ways to use this library:

  • On-Demand import from subpaths enables tree-shaking and keeps bundles small.
  • Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand
Recommended. Optimized for production.
Full Import
Convenient. Good for quick scripts.

Start Quick Timer

On-Demand
ts
import { quickTimer } from 'protocol-launcher/timer-plus'

const url = quickTimer({
  minutes: 50,
  name: 'Laundry',
})

Timer+ accepts any combination of hours, minutes, and seconds. Its official documentation states the total duration is limited to 100 hours, and that omitting the duration or setting it to 0 opens the new Quick Timer screen.

Start Quick Timer with Hours, Minutes, and Seconds

On-Demand
ts
import { quickTimer } from 'protocol-launcher/timer-plus'

const url = quickTimer({
  hours: 1,
  minutes: 23,
  seconds: 45,
})

Start Quick Stopwatch

On-Demand
ts
import { quickStopwatch } from 'protocol-launcher/timer-plus'

const url = quickStopwatch({
  name: 'Plank',
})

x-callback-url

Timer+ partially supports x-callback-url. Its official documentation accepts only x-source and x-success, and uses the timerplus://x-callback-url/ prefix instead of timerplus://app/.

On-Demand
ts
import { quickTimer } from 'protocol-launcher/timer-plus'

const url = quickTimer({
  hours: 1,
  minutes: 5,
  seconds: 30,
  name: 'Tea',
  xSource: 'Shortcuts',
  xSuccess: 'shortcuts://callback',
})
On-Demand
ts
import { quickStopwatch } from 'protocol-launcher/timer-plus'

const url = quickStopwatch({
  name: 'Plank',
  xSource: 'Shortcuts',
  xSuccess: 'shortcuts://callback',
})

Official Documentation