FaviconDL

通过命令行下载任意网站 favicon / Download favicon for any domain via CLI

简介 / Overview

FaviconDL 是一款基于 favicondl.com API 的命令行工具，可一键下载任意网站的高质量 favicon 图标。支持自定义尺寸、多种格式，并提供 PowerShell 与 Bash 双版本，零依赖即可使用。

FaviconDL is a lightweight CLI tool powered by favicondl.com API. Download high-quality favicon images for any domain in any supported size — no API key required.

功能 / Features

安装 / Installation

Windows（PowerShell）

# 下载脚本到本地
curl -L -o "$env:USERPROFILE\favicondl.ps1" "https://raw.githubusercontent.com/sweesama/favicondl.com/main/favicondl.ps1"

# 添加到 PATH（可选）
# 将 $env:USERPROFILE 加入系统 PATH 环境变量

Linux / macOS（Bash）

curl -L -o ~/favicondl.sh "https://raw.githubusercontent.com/sweesama/favicondl.com/main/favicondl.sh"
chmod +x ~/favicondl.sh
sudo ln -s ~/favicondl.sh /usr/local/bin/favicondl

使用方法 / Usage

基本语法 / Syntax

# PowerShell
.\favicondl.ps1 -Domain \x3C域名> [-Size \x3C尺寸>] [-Output \x3C保存路径>]

# Bash
./favicondl.sh \x3C域名> [尺寸] [保存路径]

参数说明 / Parameters

示例 / Examples

# 下载 GitHub 128px favicon（默认尺寸）
.\favicondl.ps1 -Domain "github.com"

# 下载 256px 大图
.\favicondl.ps1 -Domain "github.com" -Size 256

# 保存到指定路径
.\favicondl.ps1 -Domain "github.com" -Size 128 -Output "C:\icons\gh.png"

# 批量下载多个域名
.\favicondl.ps1 -Domain "github.com"
.\favicondl.ps1 -Domain "openai.com"
.\favicondl.ps1 -Domain "anthropic.com"

# 下载 GitHub favicon
./favicondl.sh github.com

# 下载 256px 版本
./favicondl.sh github.com 256

# 保存到指定路径
./favicondl.sh github.com 128 ./icons/gh.png

输出示例 / Output Example

Fetching favicon for github.com at 128px...
Saved: ./github_favicon.png (6518 bytes) ✅

API 详情 / API Details

本工具调用 favicondl.com 提供的免费 API，无需注册、无需 API Key。

Under the hood, this tool calls the free favicondl.com API — no registration, no API key required.

端点 / Endpoint

GET https://favicondl.com/api/favicon?domain={domain}&size={size}&format=redirect

参数 / Parameters

响应 / Response

• 状态码 Status: 302 Found
• Location: 目标网站 favicon URL
• 最终内容: PNG 图片文件

适用场景 / Use Cases

错误处理 / Error Handling

相关项目 / Related Projects

更新日志 / Changelog

v1.0.0

• 首发版本 / Initial release
• 支持 PowerShell + Bash 双端
• 支持 7 种尺寸（16-512px）
• 302 重定向自动下载 PNG