URL Scheme
ColorSlurp can be controlled by third party apps using the colorslurp://
url scheme, which follows the x-callback-url protocol.
Show ColorSlurp Window
colorslurp://x-callback-url/show-colorslurp
Show Magnifier
parameters:
-
return-color
if true, then the success url will be called instead of opening the picked color in ColorSlurp.
colorslurp://x-callback-url/show-magnifier
colorslurp://x-callback-url/show-magnifier?return-color=true&x-success=sourceapp://x-callback-url/acceptPickedColor
Show Picker
Shows ColorSlurp and selects the picker tab. Example
parameters:
-
color
optionally select a color. Can be any valid color string.
colorslurp://x-callback-url/show-picker?color=FC8392
Show Contrast
Shows ColorSlurp and selects the contrast tab. Example
parameters:
-
foreground
optionally change the foreground color. Can be any valid color string. -
background
optionally change the background color. Can be any valid color string.
colorslurp://x-callback-url/show-contrast?foreground=BECE86&background=2D3D2E
Show Palettes
Shows ColorSlurp and selects the palettes tab. Example
colorslurp://x-callback-url/show-palettes
Open a specific palette
You can also select a specific palette by specifying its name or ID in the url. For example, this link will open the first palette named "My Palette": Example
Opening a palette by name will open the first palette with that name. Note that you must escape spaces by replacing them with %20
to make it a valid url.
colorslurp://x-callback-url/show-palettes?paletteName=My%20Palette
You can also directly link to a palette by its id. You can copy the link to the palette ID by right clicking on a palette within the palettes page and choosing "Copy Link", or by clicking on the options icon in the palette editor and choosing "Copy Link".
Open palette by id:
colorslurp://x-callback-url/show-palettes?paletteId=A592EE38-A41D-4616-AEFA-5C8BE45B927C
Show Settings
Shows ColorSlurps settings, optionally specifying a settings tab. Example
parameters:
-
tab
can be: general, shortcuts, formats, magnifier, pro
colorslurp://x-callback-url/show-settings?tab=formats