What does the ICO to WebP Converter do?
The ICO to WebP Converter transforms Windows Icon files (.ico, image/x-icon, image/vnd.microsoft.icon) and Base64 Data URIs (data:image/x-icon;base64,...) into high-performance, next-generation WebP images (.webp). It parses binary ICONDIR and ICONDIRENTRY directory structures to extract width, height, bit depth, and multi-frame layer metadata, rendering clean raster graphics with configurable resolution scaling (1x, 2x Retina, 3x, 4x), custom pixel dimensions, lossy/lossless WebP quality compression ratios, and optional transparent alpha or solid background fills.
Core Concepts
- Modern Web Favicons: Converting legacy
.icofiles to WebP creates modern, ultra-lightweight website icons that load faster and render crisply across high-DPI smartphone screens and desktop browsers. - Multi-Frame ICO Container Support: Standard ICO files often bundle multiple icon dimensions (16x16, 32x32, 48x48, 256x256). The converter detects and extracts the highest-resolution frame automatically.
- ICONDIR & ICONDIRENTRY Inspection: The converter reads binary icon directory headers without requiring external native dependencies.
- Resolution Scaling & Retina Presets: Scale graphics up to 4x print quality or export at custom widths and heights without pixellation or artifacting.
How to use the tool?
- Upload or Paste Input: Drag & drop an
.icoor favicon file into the drop zone or paste a Base64-encoded Data URI string into the text editor. - Configure Resolution Scale & Dimensions: Select a scale preset (1x, 2x, 3x, 4x) or enter explicit width and height values in pixels.
- Set WebP Quality & Background Fill: Choose a compression quality preset (60% to 100%) and select transparent alpha or a solid background color.
- Convert to WebP: Click Convert to WebP to process the icon and render the raster preview.
- Download or Copy: Click Download to save the standalone
.webpimage file, or copy the Base64 Data URI for direct HTML, React, or CSS embedding.
Related Developer Utilities
- SVG to WebP Converter
- JPG to WebP Converter
- PNG to WebP Converter
- TIFF to WebP Converter
- AVIF to WebP Converter
- GIF to WebP Converter
- BMP to WebP Converter
- ICO to PNG Converter
REST API Integration
blueutils.com provides a free REST API endpoint (POST https://blueutils.com/api/image/ico-to-webp) for programmatic image rasterization.
API Request Parameters
| Name | Type | Description | Example |
|---|---|---|---|
rawText |
String | ICO Base64 payload or Data URI string. | "data:image/x-icon;base64,AAABAA..." |
options.scale |
Number | Optional resolution scaling multiplier (1 to 10). | 2 |
options.quality |
Number | Optional WebP quality factor between 0.1 and 1.0. | 0.9 |
options.width |
Number | Optional explicit target width in pixels. | 512 |
options.height |
Number | Optional explicit target height in pixels. | 512 |
options.bgColor |
String | Optional background fill color (hex code or 'transparent'). |
"#ffffff" |
API Request Payload Examples
cURL
curl -X POST https://blueutils.com/api/image/ico-to-webp \
-H "Content-Type: application/json" \
-d '{ "rawText": "data:image/x-icon;base64,AAABAA...", "options": { "scale": 1, "quality": 0.9, "bgColor": "transparent" } }'Python
import requests
url = "https://blueutils.com/api/image/ico-to-webp"
payload = {
"rawText": "data:image/x-icon;base64,AAABAA...",
"options": {"scale": 2, "quality": 0.85, "bgColor": "transparent"}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.json())Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
String jsonPayload = "{\"rawText\": \"data:image/x-icon;base64,AAABAA...\", \"options\": {\"scale\": 1}}";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://blueutils.com/api/image/ico-to-webp"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}API Response Parameters
| Name | Type | Description | Example |
|---|---|---|---|
isValid |
Boolean | Indicates whether the conversion succeeded. | true |
mimeType |
String | Output MIME type. | "image/webp" |
originalFormat |
String | Detected source image MIME type. | "image/x-icon" |
dataUri |
String | Complete WebP Data URI. | "data:image/webp;base64,..." |
metadata.originalWidth |
Number | Extracted intrinsic ICO frame width in pixels. | 256 |
metadata.originalHeight |
Number | Extracted intrinsic ICO frame height in pixels. | 256 |
metadata.targetWidth |
Number | Computed output width in pixels. | 512 |
metadata.targetHeight |
Number | Computed output height in pixels. | 512 |
metadata.scale |
Number | Applied scaling factor. | 2 |
metadata.frameCount |
Number | Detected total icon frame entries. | 4 |
API Response Payload Examples
Success Response (HTTP 200 OK)
{
"isValid": true,
"mimeType": "image/webp",
"originalFormat": "image/x-icon",
"dataUri": "data:image/webp;base64,UklGR...",
"metadata": {
"originalWidth": 256,
"originalHeight": 256,
"targetWidth": 512,
"targetHeight": 512,
"scale": 2,
"quality": 0.9,
"bgColor": "transparent",
"bitDepth": 32,
"frameCount": 4,
"aspectRatio": 1.0,
"originalSizeBytes": 15000,
"formattedSize": "14.6 KB"
},
"snippets": {
"html": "<img src=\"data:image/webp;base64,...\" width=\"512\" height=\"512\" alt=\"Converted WebP Favicon\" />",
"css": "background-image: url(\"data:image/webp;base64,...\");",
"markdown": ""
}
}Validation Failure Response (HTTP 400 Bad Request)
{
"isValid": false,
"error": "ICO image payload cannot be empty. Please upload an ICO file or provide a Base64 string."
}Rate Limit Exceeded Response (HTTP 429 Too Many Requests)
{
"error": "API rate limit exceeded. Please wait or contact support@blueutils.com."
}Why use an API to convert ICO to WebP?
Integrating the ICO to WebP API into web scrapers, metadata link preview engines, or automated build pipelines provides concrete advantages:
- Automated Favicon Optimization: Programmatically normalize legacy multi-frame favicon icons into clean, modern WebP images.
- Optimized Token Efficiency for AI Agents: Offload binary ICONDIR structure parsing and frame extraction to a fast, deterministic endpoint.
- Deterministic Accuracy Without Hallucinations: Ensures valid binary headers, exact aspect ratio scaling, and valid MIME types without LLM hallucination risks.
Native Usage
Convert ICO files into WebP images locally using native operating system utilities and standard libraries:
Windows (PowerShell)
# Convert ICO to WebP Data URI using PowerShell
$icoBytes = [System.IO.File]::ReadAllBytes("favicon.ico")
$base64 = [System.Convert]::ToBase64String($icoBytes)
$dataUri = "data:image/webp;base64,$base64"
[System.IO.File]::WriteAllText("output.txt", $dataUri)
Write-Output "Encoded favicon.ico to WebP Data URI successfully"Linux / Unix (Bash)
# Convert ICO to WebP Data URI using Bash and base64
BASE64_DATA=$(base64 -w 0 favicon.ico)
echo "data:image/webp;base64,${BASE64_DATA}" > output.txt
echo "Encoded favicon.ico to WebP Data URI successfully"Python
# Standard library Python conversion
import base64
with open("favicon.ico", "rb") as f:
b64_data = base64.b64encode(f.read()).decode("utf-8")
data_uri = f"data:image/webp;base64,{b64_data}"
with open("output.txt", "w", encoding="utf-8") as f:
f.write(data_uri)
print("Encoded favicon.ico to WebP Data URI successfully")Java
// Standard library Java conversion
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Base64;
public class IcoToWebp {
public static void main(String[] args) throws Exception {
byte[] bytes = Files.readAllBytes(Paths.get("favicon.ico"));
String b64 = Base64.getEncoder().encodeToString(bytes);
String dataUri = "data:image/webp;base64," + b64;
Files.writeString(Paths.get("output.txt"), dataUri);
System.out.println("Encoded favicon.ico to WebP Data URI successfully");
}
}