hue.tf Pixels To Palettes

Help Centre

Common questions, fixes for browser privacy protections, and a look at how the palette extraction works.

FAQ

What is hue.tf?

hue.tf is a browser-based colour palette tool. Drop in an image, extract a palette, refine the colours, and export the result as a showcase image, code tokens, or an Adobe swatch file.

All image processing happens in the current browser tab. The original image is not uploaded to a server.

Which image formats can be used?

WebP, AVIF, PNG, JPEG, and SVG, depending on what the browser can decode. If a file fails to open, convert it to PNG or JPEG and try again.

How to use the .ASE file?

Download the .ASE file from the Adobe Swatch tab in the Export dialog. In Photoshop, Illustrator, or InDesign, open the Swatches panel menu and choose the option to open or import swatches. In Procreate, use the palette import option.

The file contains the palette colours only, not the original image.

How can a bug be reported or a feature requested?

Open an issue on the Codeberg repository. Include the browser and version, operating system, steps to reproduce, and whether canvas access is blocked. Screenshots are helpful.

How can I support the project?

Donations are optional and can be made through Ko-fi or Liberapay on the donation page. Sharing the tool, reporting bugs, and suggesting improvements also help.

Sponsorship enquiries are welcome on the donation page as well.

Troubleshooting

Most unusual behaviour comes from one of two browser settings. The questions in each group have a single shared answer.

Canvas pixel access is blocked

If several of these apply, canvas blocking is the likely cause:

  • Why do the extracted colours look random?
  • Why is the image replaced by stripes or noise?
  • Why does clicking the image do nothing?
  • Why does the magnifier show the wrong colours?
  • Why is the exported PNG blank or corrupted?

Privacy-focused browsers and canvas-blocking extensions may block or fake canvas pixel reads. hue.tf needs pixel access for automatic extraction, pin sampling, the magnifier, and PNG rendering. The browser cannot distinguish a local palette tool from a fingerprinting script, so the protection applies to both.

If canvas access is allowed for this site - for example, by whitelisting it in the extension or changing the browser's canvas permission for the site - automatic extraction can work again. This lowers the browser's fingerprinting protection for the site. Refresh the page after changing the setting.

Manual HEX/RGB/HSL editing, shared palettes, SVG exports, code/token exports, and .ASE exports continue to work. The screen eyedropper may also work if the browser supports it.

JavaScript JIT is disabled

If several of these apply, reduced JavaScript performance is the likely cause:

  • Why do changes in the export options lag?
  • Why does the export preview take a long time to update?
  • Why do the laptop fans speed up during export?
  • Why is hue.tf slow in LibreWolf or Mullvad?

Some privacy-hardened browsers disable JavaScript just-in-time (JIT) compilation by default. hue.tf runs palette extraction and canvas rendering in JavaScript, so these operations become CPU-heavy when JIT is unavailable. This can cause lag, slow preview updates, and higher fan activity. It is a performance limitation, not a network transfer.

To reduce the load: use a smaller palette, turn off Include original photo in card, choose Ambient Palette Mesh or Studio Obsidian Solid instead of the blurred image, choose a smaller export ratio, and close other heavy tabs. A browser or profile with JIT enabled will render faster if that trade-off is acceptable.

No image or palette data is sent anywhere in either mode.

How does it work?

hue.tf turns pixels into palettes locally in the browser. No image or palette is sent to a server.

  1. Decode locally

    The browser decodes the selected image. The file is not uploaded.

  2. Sample pixels

    A small copy of the image, 220 pixels wide, is sampled with a seeded random generator. Area averaging can smooth noisy images.

  3. Cluster colours

    Median cut and k-means select representative colours. The seed makes results reproducible, and each colour is linked to a position in the image for the pins.

  4. Refine and export

    Edit values in HEX, RGB, or HSL; reorder or remove colours; then export as PNG or SVG, CSS/SCSS/Tailwind/JSON, or an .ASE swatch file.

Sharing: share links place the palette in the URL hash. Browsers do not send the hash fragment to servers, but anyone with the link can read the palette. The original image is not included. There are no accounts and no server-side palette storage.