iconsnatch

A simple service that fetches and transforms a website's logo so it suitable for display in UIs.

What it does

`iconsnatch` fetches the favicon for a given domain, checks whether it is filled or not, and removes unwanted white backgrounds.

How to use it

To resolve an icon, make a GET request to the `/api/v1/resolve` endpoint with a `url` query parameter.

GET /api/v1/resolve?url=<your-website.com>

The service will return a JSON object with the URL of the cached icon.

{
  "icon_hash": "<sha256-hash>.webp",
  "icon_url": "https://iconsnatch.forevue.org/api/v1/show/<sha256-hash>.webp",
  "filled": true
}

You can then use this URL to display the icon in your application.

<img src="http://localhost:8080/api/v1/show/<sha256-hash-of-url>.webp">