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

Example

colorslurp://x-callback-url/show-colorslurp

Show Magnifier

Example

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