> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sipapp.io/llms.txt
> Use this file to discover all available pages before exploring further.

# URL Schemes

Using the `sip://` custom URL scheme, you can interact with the Sip app and trigger specific actions.

The URL schemes allow you to:

* Activate your license
* Open Picker
* Open Contrast Checker
* Open Preferences
* Add Colors
* Add Palettes

This enables deeper integration with your workflow.

## License

To activate your license, use the following format:

```
sip://license/{{SERIAL_NUMBER}}
```

This will launch the Activation window and automatically populate the license field with your `{{SERIAL_NUMBER}}`.

<Tip>
  <b>Example:</b> `sip://license/SIP-000-000-000-000-000`
</Tip>

<img className="block h-auto w-full rounded-2xl dark:hidden" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/license-light@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=28ad0edf36216712376eec3cccb57f22" alt="license" width="1600" height="1000" data-path="_images/pages/url-schemes/license-light@2x.png" />

<img className="hidden h-auto w-full rounded-2xl dark:block" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/license-dark@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=4e1a0e038b67109343c0c5a315d099c6" alt="license" width="1600" height="1000" data-path="_images/pages/url-schemes/license-dark@2x.png" />

## Picker

Launch the Sip Picker with:

```
sip://picker
```

<Tip>
  <b>Example:</b> `sip://picker`
</Tip>

<img className="block h-auto w-full rounded-2xl dark:hidden" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/picker-light@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=bdd4a04b5a907b385e921257d6882443" alt="picker" width="2000" height="800" data-path="_images/pages/url-schemes/picker-light@2x.png" />

<img className="hidden h-auto w-full rounded-2xl dark:block" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/picker-dark@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=6c5632db9e21f70625aa6fcfa28fc703" alt="picker" width="2000" height="800" data-path="_images/pages/url-schemes/picker-dark@2x.png" />

## Contrast Checker

Launch the Contrast Checker using:

```
sip://contrast
```

You can also pass two colors (in `hex` or `rgba` format) to compare:

<Tip>
  <b>Example:</b> `sip://contrast`
</Tip>

<Tip>
  <b>Example:</b> `sip://contrast/hex/#000000,#FFFA7B`
</Tip>

<Tip>
  <b>Example:</b> `sip://contrast/rgba/0-0-0-1.00,255-250-123-1.00`
</Tip>

<img className="block h-auto w-full rounded-2xl dark:hidden" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/contrast-checker-light@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=f464c670ecb15ccfe90c277445e31de8" alt="contrast-checker" width="1600" height="1200" data-path="_images/pages/url-schemes/contrast-checker-light@2x.png" />

<img className="hidden h-auto w-full rounded-2xl dark:block" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/contrast-checker-dark@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=b82f1d1f11a865e5e2c5275deb8384ec" alt="contrast-checker" width="1600" height="1200" data-path="_images/pages/url-schemes/contrast-checker-dark@2x.png" />

## Preferences

Open the Preferences window using:

```
sip://settings
```

Optionally, specify a tab to open directly. Valid values: `general`, `appearance`, `formats`, `smart-formats`, `smart-profiles`, `dock`, `shortcuts`, `cloud`, `snapshots`, and `about`.

<Tip>
  <b>Example:</b> `sip://settings`
</Tip>

<Tip>
  <b>Example:</b> `sip://settings/general`
</Tip>

<img className="block h-auto w-full rounded-2xl dark:hidden" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/preferences-light@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=04ea090e96b2fd24541a50e5443e3911" alt="preferences" width="2000" height="1200" data-path="_images/pages/url-schemes/preferences-light@2x.png" />

<img className="hidden h-auto w-full rounded-2xl dark:block" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/preferences-dark@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=4ee80e4194fd73bdf42a2ba77139203a" alt="preferences" width="2000" height="1200" data-path="_images/pages/url-schemes/preferences-dark@2x.png" />

## Color

Add a color to your history using:

```
sip://color/{format}/{color_name}/{color_value}
```

* `{format}`: `hex` or `rgba`
* `{color_name}`: The name of the color
* `{color_value}`: Must match the selected format

<Tip>
  <b>Example:</b> `sip://color/hex/Pistachio/#9FD362`
</Tip>

<Tip>
  <b>Example:</b> `sip://color/rgba/Sap Green/80-119-51-1.00`
</Tip>

<img className="block h-auto w-full rounded-2xl dark:hidden" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/color-light@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=0935ab833d69053f948a74abcaa338ae" alt="color" width="1000" height="1600" data-path="_images/pages/url-schemes/color-light@2x.png" />

<img className="hidden h-auto w-full rounded-2xl dark:block" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/color-dark@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=5022b5b13b63400ad326c8131b5d5f5f" alt="color" width="1000" height="1600" data-path="_images/pages/url-schemes/color-dark@2x.png" />

## Palette

Add a palette using:

```
sip://palette/{format}/{palette_name}/{color_list}
```

* `{format}`: `hex` or `rgba`
* `{palette_name}`: The name of the palette
* `{color_list}`: Comma-separated list of `{color_name}-{color_value}` entries. Each value must match the format.

<Tip>
  <b>Example:</b> `sip://palette/rgba/Deep Palette/Spring Sun-246-251-222-1.00,Snow Flurry-229-250-191-1.00,Reef-210-239-154-1.00,Yellow Green-189-226-129-1.00,Pistachio-159-211-98-1.00,Mantis-132-185-82-1.00,Apple-109-158-69-1.00,Sap Green-80-119-51-1.00`
</Tip>

<Tip>
  <b>Example:</b> `sip://palette/hex/Deep Palette/Spring Sun-#F6FBDE,Snow Flurry-#E5FABF,Reef-#D2EF9A,Yellow Green-#BDE281,Pistachio-#9FD362,Mantis-#84B952,Apple-#6D9E45,Sap Green-#507733`
</Tip>

<img className="block h-auto w-full rounded-2xl dark:hidden" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/palette-light@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=55ab70e80b0bd7d29cb9bf87c8a28971" alt="palette" width="1000" height="1280" data-path="_images/pages/url-schemes/palette-light@2x.png" />

<img className="hidden h-auto w-full rounded-2xl dark:block" src="https://mintcdn.com/sip/9J_M-7V4gWPP-GJC/_images/pages/url-schemes/palette-dark@2x.png?fit=max&auto=format&n=9J_M-7V4gWPP-GJC&q=85&s=1cc2dd924a04776021baea33ec47dc5b" alt="palette" width="1000" height="1280" data-path="_images/pages/url-schemes/palette-dark@2x.png" />
