How it works
$ site-icons logo.svg -o my-icons
site-icons v1.0.0 — Free tier
Generated 4 files in my-icons/
favicon-16x16.png 639 bytes
favicon-32x32.png 719 bytes
favicon-48x48.png 749 bytes
favicon.ico 2,161 bytes
snippet.html 1,097 bytes
$ site-icons logo.svg -o my-icons --pro
site-icons v1.0.0 — Pro tier
Generated 17 files in my-icons/
(favicons + OG image + PWA + Apple + tile icons + manifest + XML + HTML)
Quick start
You need Python 3.9+ and Pillow installed. For SVG input, you also need rsvg-convert (install via brew install librsvg on macOS, or apt install librsvg2-bin on Linux).
$ pip install Pillow
$ curl -O https://hermes-passiv.pages.dev/downloads/site-icons/site-icons-1.0.0.tar.gz
$ tar xzf site-icons-1.0.0.tar.gz
$ cd site-icons-1.0.0
$ python3 site_icons.py your-logo.svg -o icons --pro
Or just download the single file:
$ curl -O https://hermes-passiv.pages.dev/downloads/site-icons/site_icons.py
$ python3 site_icons.py logo.svg -o icons
Tiers
Pro
$29
one-time
- Everything in Free, plus:
- Apple touch icons (152, 167, 180)
- PWA icons (192, 512)
- Windows tile icons + browserconfig.xml
- OG image (1200×630) with text overlay
- web app manifest.json
- Coming — available when Lemon Squeezy is set up
Why use it?
- CLI-first — no web UI, no upload, no clicking. One command, all icons.
- Offline — zero network calls. Your logo never leaves your machine.
- Single source of truth — one SVG generates everything. Change the logo, re-run, done.
- CI-ready — integrate into your build pipeline. Re-generate icons on every deploy.
- Universal — Python 3.9+, works on macOS, Linux, Windows (with rsvg-convert).
Output structure
icons/
├── favicon.ico (multi-res: 16, 32, 48)
├── favicon-16x16.png
├── favicon-32x32.png
├── favicon-48x48.png
├── apple-touch-icon-152x152.png (Pro)
├── apple-touch-icon-167x167.png (Pro)
├── apple-touch-icon-180x180.png (Pro)
├── icon-192x192.png (Pro, PWA)
├── icon-512x512.png (Pro, PWA)
├── icon-70x70.png (Pro, tile)
├── icon-150x150.png (Pro, tile)
├── icon-310x310.png (Pro, tile)
├── mstile-256x256.png (Pro, tile)
├── og-image.png (Pro, 1200×630)
├── manifest.json (Pro)
├── browserconfig.xml (Pro)
└── snippet.html (copy-paste into <head>)