Session
Learn
Pricing
Support

Session URL scheme

Philip Young

URL Scheme is one way to navigate Session directly from URL. Use cases:

  • a document with list of clickable links,
  • integrate your to-do app with Session,
  • run Session from Alfred,
  • run Session inside AppleScript,
  • and much more.

URL Scheme is Pro feature and only availble from version 2.1 and above.

Start Session

Programatically start Session.

Parameters:

  • intent (optional): Your Session intention.
  • duration (optional): Duration in minutes. If not provided, it defaults to your default app duration
  • categoryId (optional): Match the first category id. Fall back to default project if not found.
  • categoryName (optional): Match the first category with identical name. Case insensitive. Fall back to default project if not found.
  • notes (optional) (v2.7.12): Initial notes for the Session

session:///start?intent=Example%20Session&duration=30&notes=Example%20Notes

Try URL above by clicking this link

Start Previous Session

Start previous session with your last intent.

session:///start-previous

Try URL above by clicking this link

Toggle Pause

Toggle pause. Only works while Session is running.

session:///pause

Try URL above by clicking this link

Take a break

Start a break / take a break while in Session

session:///break

Try URL above by clicking this link

Finish Session

Finish Session. Only works while Session is running.

session:///finish

Try URL above by clicking this link

Abandon Session / Rest

Abandon session / stop rest / stop working.

session:///abandon

Try URL above by clicking this link

Navigate to Menu (v2.9.8 BETA. Might change at later date)

Settings

Session
Changelog
Privacy
Terms
Support