URL scheme

Last updated 10 August 2026

JustShot registers the justshot:// scheme so other tools can drive it - capture, open, pin, record and upload without touching the menu bar. Opening one of these URLs by any means triggers the action: the open command, a browser, a link, Raycast, Alfred or Shortcuts.

Turn it on first

URL control lives behind Settings → Advanced → “Allow control via justshot:// URLs”. It is on by default. With it off, JustShot ignores incoming URLs entirely - which is also the switch to reach for if you would rather nothing could drive the app.

Commands

URL	What it does
`justshot://capture-area`	Start an area capture - drag to select a region.
`justshot://capture-fullscreen`	Capture the full screen immediately.
`justshot://capture-window`	Start a window capture - click a window to pick it.
`justshot://capture-scrolling`	Scrolling capture: auto-scrolls a selected region and stitches it into one tall image. Needs Accessibility permission.
`justshot://capture-text`	Capture Text / QR - OCR a region, decode any QR or barcode, and copy the result to the clipboard.
`justshot://record`	Start a screen recording. Opens the recorder bar, or records a specific source with `?source=`.
`justshot://open-from-clipboard`	Open whatever image is on the clipboard in the editor.
`justshot://pin?path=<file>`	Pin an image file to the screen as a floating overlay.
`justshot://open?path=<file>`	Open an image file in the editor. Alias: `justshot://open-annotate`.
`justshot://upload?path=<file>`	Upload an image file to JustShot Cloud and copy the share link.
`justshot://open-settings`	Open Settings, optionally at a tab with `?tab=`.

Unknown commands and malformed URLs are ignored - no error, no crash, nothing happens.

action — what happens after a capture

The four interactive capture commands accept ?action=, which overrides your After a capture setting for that one capture. Omit it and JustShot does whatever Settings → General says.

action	Result
`copy`	Copy the capture to the clipboard.
`save`	Open the Save panel.
`annotate`	Open the capture in the editor.
`pin`	Pin the capture to the screen.
`upload`	Upload to JustShot Cloud and copy the share link.

justshot://capture-area?action=copy
justshot://capture-fullscreen?action=upload
justshot://capture-window?action=annotate
justshot://capture-scrolling?action=upload

source — what to record

Optional on record. Leave it out to open the recorder bar and choose by hand.

source	Result
(omitted)	Open the recorder bar, then record.
`area`	Select a region, then record it.
`fullscreen`	Record the full screen.
`window`	Pick a window, then record it.

justshot://record
justshot://record?source=area
justshot://record?source=fullscreen

path — the file to act on

Required by pin, open and upload. An absolute path to a local image; a leading ~ expands to your home folder. URL-encode anything with spaces or special characters — an unencoded space ends the URL early, and the command quietly does nothing.

justshot://open?path=~/Desktop/diagram.png
justshot://upload?path=/Users/me/Screenshots/bug%20report.png
justshot://pin?path=~/Downloads/reference.jpg

tab — which Settings tab to open

Optional on open-settings. One of general, hotkeys, cloud, advanced.

justshot://open-settings
justshot://open-settings?tab=cloud

Terminal

open "justshot://capture-area?action=copy"
open "justshot://upload?path=$HOME/Desktop/shot.png"

Raycast

Use a Script Command, the built-in Open URL action, or a small extension, then bind it to a hotkey or alias.

open "justshot://capture-area?action=upload"
open "justshot://capture-scrolling?action=upload"
open "justshot://record?source=area"

Alfred

A Workflow with a Run Script (/bin/bash) or an Open URL action. Trigger it from a keyword, a hotkey, or a Universal Action on a file — passing the file through as justshot://upload?path={query}.

open "justshot://capture-fullscreen?action=annotate"

Apple Shortcuts

Add the Open URLs action with a justshot:// URL. Because the URL is plain text you can build it as you go: take a file as input, URL-encode its path, open justshot://upload?path=…, and the share link lands on the clipboard for the next step to use.

Permissions and safety

These URLs cannot run code. They do only what is listed above: capture, open, pin, record, upload, open Settings. Nothing on this page executes a shell command or reads a file you did not name.
Permissions are requested, not skipped. capture-scrolling needs Accessibility and record needs Screen Recording. If a permission is missing, JustShot asks for it rather than failing silently.
You can switch the whole thing off in Settings → Advanced, and JustShot will ignore every incoming URL.

Something missing?

If there is an action you want to automate and no URL for it, email contact@justshot.net - the list above is small on purpose, and it grows based on what people actually ask for.