Just Timers

Just Timers is an iOS timer app. Protocol Launcher allows you to generate official URL scheme links for creating, deleting, pausing, resetting, restarting, and resuming timers.

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.

Notes

Just Timers documents justtimers://x-callback-url/[action]/?[parameter]=[value] for individual timers and justtimers://x-callback-url/[action]/all for controlling all timers. The official page does not document callback query parameters such as x-success or x-error, so this module does not expose them.

Creating a timer requires name and either duration or seconds. New timers are active by default; pass active: false to create the timer paused.

Create Timer With Duration

On-Demand

import { createTimer } from 'protocol-launcher/just-timers'

const url = createTimer({
  name: 'Tea',
  duration: '2 minutes',
})

Create Paused Timer With Seconds

On-Demand

import { createTimer } from 'protocol-launcher/just-timers'

const url = createTimer({
  name: 'Tea',
  seconds: 120,
  active: false,
})

Delete Timer

On-Demand

import { deleteTimer } from 'protocol-launcher/just-timers'

const url = deleteTimer({
  name: 'Tea',
})

Pause All Timers

On-Demand

import { pauseTimer } from 'protocol-launcher/just-timers'

const url = pauseTimer({
  all: true,
})

Reset Timer

On-Demand

import { resetTimer } from 'protocol-launcher/just-timers'

const url = resetTimer({
  name: 'Tea',
})

Restart Timer

On-Demand

import { restartTimer } from 'protocol-launcher/just-timers'

const url = restartTimer({
  name: 'Tea',
})

Resume Timer

On-Demand

import { resumeTimer } from 'protocol-launcher/just-timers'

const url = resumeTimer({
  name: 'Tea',
})

Generated URLs

createTimer({ name: 'Tea', duration: '2 minutes' })
// => 'justtimers://x-callback-url/new/?name=Tea&duration=2%20minutes'

createTimer({ name: 'Tea', seconds: 120, active: false })
// => 'justtimers://x-callback-url/new/?name=Tea&seconds=120&active=false'

deleteTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/delete/?name=Tea'

deleteTimer({ all: true })
// => 'justtimers://x-callback-url/delete/all'

pauseTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/pause/?name=Tea'

pauseTimer({ all: true })
// => 'justtimers://x-callback-url/pause/all'

resetTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/reset/?name=Tea'

resetTimer({ all: true })
// => 'justtimers://x-callback-url/reset/all'

restartTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/restart/?name=Tea'

restartTimer({ all: true })
// => 'justtimers://x-callback-url/restart/all'

resumeTimer({ name: 'Tea' })
// => 'justtimers://x-callback-url/resume/?name=Tea'

resumeTimer({ all: true })
// => 'justtimers://x-callback-url/resume/all'

Official Documentation

• Just Timers Shortcuts API