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)

• Upgrade page → session:///upgrade
• Analytics → session:///analytics
• Main screen → session:///main
• Calendar → session:///calendar
• Account → session:///account

Settings

• Settings → session:///settings
• General → session:///settings/general
• Profile Settings → session:///settings/profile
• Notification → session:///settings/notification
• BackgroundSound → session:///settings/background-sound
• Calendar → session:///settings/calendar
• LiveActivity → session:///settings/live-activity
• MenubarAndDock → session:///settings/menubar-and-dock
• Window → session:///settings/window
• SlackBlocker → session:///settings/slack-blocker
• AppleShortcut → session:///settings/apple-shortcut
• AppleScript → session:///settings/apple-script
• Display → session:///settings/display
• Language → session:///settings/language
• KeyboardShortcut → session:///settings/keyboard-shortcut
• Support → session:///settings/support
• DeveloperMode → session:///settings/developer-mode
• WindowTracker → session:///settings/window-tracker