𝗜𝗖𝗢𝗡𝗢𝗚𝗥𝗔𝗣𝗛𝗬

A comprehensive collection of 589,000+ icons spanning color PNGs, monochrome SVG sets, macOS ICNS assets, animated SVG spinners, Meteocons weather animations, Apple SF Symbols, heavy metal band logos, music emblem rings, and 226 icon set collections via the Iconify API submodule. Includes native macOS desktop apps and specialized CLI/TUI utilities like ringicon for creating album art ring icons.

About • Structure • Collections • Music & RingIcon Tool • Music Rings Gallery • Iconify Submodule & Connectors • Spinners & Weather • Developer & File Types • SF Symbols • All Categories • Usage • Utilities & Apps • License

---

🗂️ About

A comprehensive collection of 589,000+ icons spanning color PNGs, monochrome SVG sets, macOS ICNS assets, animated SVG spinners, Meteocons weather animations, Apple SF Symbols, heavy metal band logos, music emblem rings, and 226 icon set collections via the Iconify API submodule. Includes native macOS desktop apps and specialized CLI/TUI utilities like ringicon for creating album art ring icons.

---

Structure

Click to expand directory structure

Iconography/
├── _new/                 # Staging for new icons
├── category/             # 30+ thematic categories
│   ├── animals/ brands/ checkmark/ communication/ developer/ education/
│   ├── equipment/ file type/ finance/ flags/ food & drink/ hardware/
│   ├── health/ internet/ logistics/ media/ medical/ nature/ network/
│   ├── os/ self-hosted/ signs/ social media/ time & date/ traffic/ weather/ web/
├── color/                # Colorful icon sets (PNG, SVG)
│   ├── ai/               # AI-themed (png/ svg/ webp/)
│   ├── distros/          # Linux distro & bootloader logos (distros/ refind/)
│   ├── km/               # Keyboard Maestro (bulk/ fluent/ logos/ etc.)
│   ├── library/          # 23+ dev tool categories
│   │   ├── browser/ cms/ community/ compiler/ crypto/
│   │   ├── database/ design/ developer/ devtool/ education/
│   │   ├── entertainment/ framework/ google/ hosting/
│   │   ├── language/ library/ marketplace/ microsoft/
│   │   ├── music/ payment/ social/ software/ svg/
│   ├── music/            # Music assets & tools
│   │   ├── band-logos/   # 320+ heavy metal & rock band logos (png/)
│   │   ├── rings/        # 143 album art & emblem ring icons
│   │   │   └── Tool/GPT/ # RingIcon CLI & TUI tool (C# + Go)
│   │   ├── spotify/      # Spotify player & UI icons
│   │   └── metallum/     # Metal Archives icons
│   ├── papirus/          # Papirus theme
│   └── windows98/        # Retro Windows 98 icons
├── distro-packs/         # 9 Linux desktop icon themes (74k files)
├── file-types/           # File format icons & file variants (files/ code/ 15 styles)
├── gifs/                 # Animated GIFs
├── iconify/              # 226 icon sets via Iconify API (331k files, 2GB)
│   ├── carbon/ codicon/ material-icon-theme/ meteocons/
│   ├── svg-spinners/ tabler/ ... 220+ more
├── macos/                # macOS ICNS + PNG assets (5k files)
│   ├── apps/             # Application icons (png/ icns/)
│   ├── drives/           # Volume icons
│   └── folders/          # Folder customization (misc/ colors/ default/)
├── misc/                 # Loose miscellaneous icons
├── packs/                # Curated icon packs (15+ directories)
│   ├── app-specific/ azure/ flat/ food/ google/ internet/ labels/
│   ├── raycast/ servers/ simplicio/ social/ web-hosting/ _logos/
├── plain/                # Monochrome icon sets (50k files)
│   ├── adobelightroom/ apple-music/ avidmedia/ brew/ car-badges/
│   ├── color-matrix/ coolicons/ default/ figma/ line/ logos/ remix/
│   ├── rpg-awesome/ spotify/ streamlabs/ teal/ txt/ vmix/ web/
├── sf-symbols/           # Apple SF Symbols (sf-symbols-dark/ 22 categories)
└── utilities/            # Scripts, folder templates, KM actions, desktop apps
    ├── applications/     # 14 macOS icon management apps (.app bundles)
    ├── folders/          # Folder templates (icns/ png/ svg/)
    ├── kb-maestro-actions/ # KM action bundles
    └── scripts/          # apply-icon.sh, svg-to-png.sh, convert-to-icns.sh, etc.

---

Collections

Color Icons (6 Previews Per Row)

Category	Count	Description	Preview (6 Icons)
Library (Developer)	1,877	Languages, frameworks, tools, IDEs (PNG)
Library (Software)	1,119	Desktop applications & utilities (PNG)
Self-Hosted	1,030+	Self-hosted service icons
Music Rings	143	Music emblem & album rings
Web Services	1,380+	Web service icons (PNG + SVG)
Papirus	2,380+	Papirus icon theme (apps, devices, mimetypes)
Flags	262	Country flags
AI	50+	ChatGPT, Claude, Copilot, Midjourney...
Social	75+	Twitter, Discord, Reddit, LinkedIn...
Browser	20+	Chrome, Firefox, Arc, Brave, Safari...
Database	68+	PostgreSQL, MongoDB, Redis, MySQL...
Design	45+	Figma, Adobe suite, Sketch, Canva...
Crypto	39+	Bitcoin, Ethereum, Solana, wallets...
Brands	1,140+	Corporate, tech, and hardware logos
Band Logos	320+	Heavy metal & rock band logos

macOS Assets

Category	Count	Formats	Preview
Color Folders	270+	.icns .png
App Icons	2,500+	.icns .png
Dev Folders	30+	.icns .png
Default Folders	90+	.icns .png

Linux & Bootloader Themes (6 Previews Per Row)

Theme / Collection	Count	Formats	Description	Preview (6 Icons)
Distro Logos	100	PNG + SVG	Modern Linux distribution logos
rEFInd Bootloader	91	PNG	Bootloader OS selector icons
Deepin	12,916	PNG + SVG	Complete Deepin desktop theme
Kora	9,774	PNG + SVG	Kora icon theme
Papirus Remix	5,154	PNG + SVG	Papirus remix variant
Flat Remix	4,267	PNG + SVG	Flat Remix icon theme
mac	3,790	PNG + SVG	macOS-like Linux icon theme
Hatter	2,002	PNG + SVG	Hatter icon theme
Argon	313	PNG + SVG	Argon icon theme

Plain Icons (8 Previews Per Row)

Set	Icons	Format	Style	Preview (8 Icons)
Remix Icon	5,557	PNG + SVG	Line & fill
Coolicons	1,776	PNG + SVG	Modern line
RPG Awesome	990	PNG + SVG	Gaming & RPG
Brew	568	PNG + SVG	Homebrew
Car Badges	172	PNG + SVG	Automotive
vMix	256	PNG + SVG	Broadcast
Logos	5,879	PNG + SVG	Brand marks
Figma	204	PNG + SVG	Design tool
Default	228	PNG + SVG	System style
Apple Music	53	PNG	Music playback controls
Avid Media	61	PNG	Media editing tools
Color Matrix	65	PNG	Color palette Swatches
Line Icons	154	PNG	Constellations & simple lines
Spotify	47	PNG	Spotify desktop controls
Streamlabs	53	PNG	Streaming scene controls
Teal	246	PNG	Teal UI monochrome badges
Text Typography	13	PNG	Roman numeral typography
Adobe Lightroom	1,148	PNG + SVG	Photo editing
Web Icons	168	PNG	Web platform marks

---

🎵 Music Collection & RingIcon Tool (color/music/)

The repository includes a dedicated music iconography section with 320+ heavy metal band logos, 143 music emblem rings, and a custom ringicon production tool for creating album-art ring icons.

1. Music Collections (color/music/)

• Band Logos (color/music/band-logos/png/): 320+ transparent high-resolution PNG logos for heavy metal & rock bands (Metallica, Megadeth, Slayer, Anthrax, Aerosmith, DMX, Saxon, Mortician, Marduk, Destruction, etc.).
• Music Rings (color/music/rings/): 143 emblem & circular album rings for audio players & desktop launchers.

2. RingIcon Production CLI & TUI Application (color/music/rings/Tool/GPT/)

ringicon is a custom high-performance application built to eliminate repetitive manual workflows (e.g. Canva) for cropping album artwork into circles and layering multi-colored ring borders:

Source Image / URL → Position & Crop → Ring Layer Stack → Transparent PNG

Running the Interactive TUI

cd /Volumes/Apfspace/Icons/color/music/rings/Tool/GPT
./ringicon

The interactive TUI dashboard features:

• Keyboard navigation: Arrow keys to pan/position, +/- to zoom, I to load image/URL, P for presets, R to customize ring stack, V for real PNG render/preview, Enter to export.
• Visual Ring Stack Builder: Configure inner/outer ring widths, transparent gaps, custom hex/RGB colors, and opacity.

CLI Commands & Automation

# Single image with preset
./ringicon make cover.jpg --preset black-green-black --zoom 1.25 --x -40 --y 20 --out output.png

# Custom multi-ring stack (inner to outer)
./ringicon make cover.jpg --rings "black:8,green:24,black:8" --size 1000 --out output.png

# Advanced ring syntax with transparent gaps and opacity
./ringicon make cover.jpg --rings "#111111:10,#f7931e:32:4:0.95" --out output.png

# Process image directly from HTTP URL
./ringicon make "https://example.com/cover.jpg" --preset single-orange --out ring.png

# Batch process directory of covers
./ringicon batch ./covers --preset single-orange --out ./rings --rename-existing

Finder & System Integration

• scripts/finder-ringicon.sh: Integrated script for macOS Finder / Automator to generate ring icons directly from right-clicking image files.
• completions/ringicon.zsh: Full Zsh shell completion for all flags & presets.
• Go Engine Port (go-ringicon/): High-speed compiled Go binary for automated server pipelines.

---

💿 Complete Music Rings Gallery (143 Icons - 9 Columns Wide)

Full visual gallery of all 143 album art and emblem ring icons located in color/music/rings/:

Click to collapse / expand ring icons gallery

Ring 1	Ring 2	Ring 3	Ring 4	Ring 5	Ring 6	Ring 7	Ring 8	Ring 9

---

🌐 Iconify Submodule Catalog & Framework Connectors

The repository includes a complete offline mirror and submodule of the Iconify API located at ./iconify/, hosting 331,946 vector SVG icons across 226 open-source icon sets.

Featured Open Source Icon Libraries in ./iconify/ (8 Previews Per Row)

Icon Library	Sets Included	Total SVGs	License	Preview (8 Icons)
Material Symbols	material/, material-icon-theme/	12,000+	Apache 2.0
Simple Icons	simple-icons/	3,717	CC0 1.0
Tabler Icons	tabler/	6,378	MIT
Lucide Icons	lucide/	1,987	ISC
Carbon Icons	carbon/	2,150	Apache 2.0
Codicon	codicon/	931	MIT
Font Awesome	fa/, fa6-solid/	10,000+	CC BY 4.0 / SIL
Heroicons	heroicons/	580	MIT
Octicons	octicon/	931	MIT
Boxicons	boxicons/	1,500+	MIT
Feather Icons	feather/	286	MIT

Framework Connectors & Usage

Integrate any icon from ./iconify/ directly into your web applications or build pipelines:

<!-- 1. Web Component / HTML Connector -->
<script src="https://code.iconify.design/iconify-icon/2.1.0/iconify-icon.min.js"></script>
<iconify-icon icon="simple-icons:github" width="24" height="24"></iconify-icon>

// 2. React Connector (@iconify/react)
import { Icon } from '@iconify/react';

export const App = () => (
  <Icon icon="carbon:developer" width="32" height="32" />
);

<!-- 3. Vue 3 Connector (@iconify/vue) -->
<template>
  <Icon icon="tabler:brand-docker" width="32" height="32" />
</template>

<script setup>
import { Icon } from '@iconify/vue';
</script>

<!-- 4. Svelte Connector (@iconify/svelte) -->
<script>
  import Icon from '@iconify/svelte';
</script>

<Icon icon="heroicons:cpu" width="32" height="32" />

// 5. Node.js Offline JSON/SVG Connector (@iconify/tools & @iconify/json)
import { lookupCollection, locate } from '@iconify/json';
import { readFileSync } from 'fs';

// Read local SVG directly from repository
const svgContent = readFileSync('./iconify/simple-icons/github.svg', 'utf-8');

---

⚡ Spinners & Weather

Animated SVG Spinners & Meteocons

Collection	Format	Count	Preview (8 Icons)
SVG Spinners	SVG	46
Meteocons Weather	SVG	450

---

🛠️ Developer & File Types

Material Icon Theme & File Extension Icons

Collection	Format	Count	Description	Preview (8 Icons)
Material Icon Theme	SVG	1,170+	File & folder icons for VS Code & IDEs
File Format Icons	PNG	125+	Extension-specific document badges

---

🍎 Apple SF Symbols (8 Previews Per Row)

Curated Apple SF Symbols organized across thematic categories in sf-symbols/sf-symbols-dark/:

Category	Description	Preview (8 Icons)
Communication	Phone, chat, email, video call icons
Media & Audio	Headphones, photo, speaker, volume controls
System & Controls	Speedometer, gear, wifi, battery, sliders
Weather & Nature	Rain, sun, cloud, leaf, sparkles
Nature & Environment	Trees, plants, leaves, outdoor icons
Health & Fitness	Heart, pulse, activity, medical emblems
Security & Privacy	Lock, key, shield, fingerprint badges
Files & Folders	Document types, directory badges, archives
People & Profiles	User profiles, team groups, contact icons
Shapes & Geometry	Circles, squares, stars, polygon badges

---

📦 All Thematic Categories (category/ - 6 Previews Per Row)

Complete reference of all 27 thematic categories in category/:

Category Directory	Items	Description	Preview (6 Icons)
category/animals/	320	Animals, birds, pets & dinosaurs
category/brands/	1,145	Global brand logos & software marks
category/checkmark/	196	Checkmarks, cross marks & status badges
category/communication/	814	Calling, chat, online media & messaging
category/developer/	88	IDEs, editors, compilers & dev environments
category/education/	1,846	Letters, numbers, school & learning symbols
category/equipment/	204	Tools, paint buckets & maintenance gear
category/file type/	236	File extension badges & document types
category/finance/	1,927	Money, currencies, piggy banks & trade
category/flags/	976	World country flags & territory emblems
category/food & drink/	382	Beverages, coffee, meals & snacks
category/hardware/	634	Computer parts, keys & charging indicators
category/health/	341	Healthcare, fitness & medical hygiene
category/internet/	1,212	Cloud downloads, protocols & web APIs
category/logistics/	22	Shipping, delivery & parcel packages
category/media/	564	Video clips, photos, media controls
category/medical/	452	Medical suits, diagnosis & health care
category/nature/	325	Trees, plants, leaves & sustainability
category/network/	336	Network globes, eSIM, servers & connectivity
category/os/	79	Operating systems & Linux distros
category/self-hosted/	1,030	Self-hosted services & homelab apps
category/signs/	1,221	Zodiac signs, warnings & badges
category/social media/	476	Social networks, Snapchat, VK, Vero
category/time & date/	3,516	Calendar days, month dates & clocks
category/traffic/	174	Traffic signs, signals & road markers
category/weather/	218	Weather conditions & temperature badges
category/web/	1,447	Web frameworks, tools & services

---

📦 Curated Packs (packs/ - 6 Previews Per Row)

Specialized icon packs & collections:

Pack Directory	Items	Description	Preview (6 Icons)
packs/raycast/	725	Clean application icons for Raycast
packs/google/	53	Official Google app & service marks
packs/app-specific/browsers/	25	Browser build variations (Dev, Beta, Whale)
packs/azure/	1,366	Official Azure Cloud service icons
packs/servers/	64	Server infrastructure & cloud hosting
packs/simplicio/	78	Simplicio desktop UI icons
packs/social/	146	Social media badges & Spotify pack

---

Usage

Applying macOS Folder Icons

# Using fileicon (brew install fileicon)
fileicon set ~/Projects/MyApp ./macos/folders/misc/github.icns

# Using included script
./utilities/scripts/apply-icon.sh github.icns ~/Projects/MyApp

# Or via Finder
# 1. Get Info on icon file (⌘ + I)
# 2. Click icon preview → Copy (⌘ + C)
# 3. Get Info on target folder
# 4. Click folder icon → Paste (⌘ + V)

Applying App Icons

# Replace app icon
fileicon set /Applications/MyApp.app ./macos/apps/icns/custom-icon.icns

# Using included script
./utilities/scripts/apply-icon.sh custom-icon.icns /Applications/MyApp.app

# Refresh icon cache
sudo killall Finder && sudo killall Dock

Using in Web Projects

<!-- SVG inline -->
<img src="iconify/simple-icons/github.svg" alt="GitHub" width="24">

<!-- SVG Spinner -->
<img src="iconify/svg-spinners/pulse-multiple.svg" alt="Loading" width="32">

<!-- As favicon -->
<link rel="icon" href="color/library/browser/chrome.png">

Example icons:

• Kubernetes
• PSX
• NZB-Dav
• Firefox
• Claude
• Copilot
• Spotify

Converting Icons

# Convert SVG to PNG (512px width)
./utilities/scripts/svg-to-png.sh icon.svg -w 512

# Convert PNG to ICNS for macOS
./utilities/scripts/convert-to-icns.sh icon.png

# Batch convert all SVGs in directory
./utilities/scripts/svg-to-png.sh ./icons -b -w 512

See utilities/scripts/README.md for complete script documentation.

---

🛠️ Scripts, Utilities & macOS Desktop Applications

1. CLI Automation & Helper Scripts (utilities/scripts/)

Command-line utilities for processing, downloading, converting, and applying icons:

Script / Tool	Description	Usage Example
apply-icon.sh	Applies ICNS/PNG/SVG icons to macOS folders or .app bundles & refreshes Finder	./utilities/scripts/apply-icon.sh icon.icns ~/Folder
bulk-download-icons.sh	Downloads icon packs in parallel with auto-retries, rate limiting & progress bars	./utilities/scripts/bulk-download-icons.sh -p 'https://site.com/icon-{{1..100}}.svg' ./out
convert-to-icns.sh	Converts PNG/SVG to macOS .icns format generating all resolution stacks (16px..1024px @2x)	./utilities/scripts/convert-to-icns.sh icon.png
get-largest-size.sh	Analyzes directories to find maximum image resolution, aspect ratio, or JSON statistics	./utilities/scripts/get-largest-size.sh ./icons -f table
png2icns.sh	Lightweight PNG-to-ICNS compiler script using native macOS sips	./utilities/scripts/png2icns.sh input.png output.icns
svg-to-png.sh	Converts SVGs to high-res PNGs while strictly preserving aspect ratio and directory layout	./utilities/scripts/svg-to-png.sh ./svgs -b -w 512
Library Helpers (utilities/scripts/library/)	Node.js automation scripts: convert-svg-to-png.js, categorize-downloaded-pngs.js, fix-wordmark-conversions.js, reorganize-structure.js	node ./utilities/scripts/library/categorize-downloaded-pngs.js

2. Featured macOS Applications (utilities/applications/)

A curated suite of desktop applications for icon creation, folder colorizing, and icon set management:

Application	Purpose	Location
Image2Icon	Convert any image into macOS ICNS, PNG, and folder icons	utilities/applications/Image2Icon.app
IconJar	Organize, search, and export icon sets & SVGs	utilities/applications/IconJar.app
IconChamp	System-wide macOS app & folder icon theme engine	utilities/applications/IconChamp.app
App Icon Generator	Generate iOS/macOS app icon assets in all required resolutions	utilities/applications/App Icon Generator.app
Mac ICNS Creator	Quickly compile PNG image stacks into .icns files	utilities/applications/Mac ICNS Creator.app
macOS Icons	Browse & apply community macOS app icons	utilities/applications/macOS Icons.app
Folder Art	Custom artwork applicator for macOS Finder folders	utilities/applications/Folder Art.app
Folder Colorizer	Color-code Finder folders with custom hues	utilities/applications/Folder Colorizer.app
Folder Designer	Design & style custom macOS folder icons	utilities/applications/Folder Designer.app
Folder Icons	Icon overlay utility for Finder folders	utilities/applications/Folder Icons.app
Iconize	Convert graphics into system icon formats	utilities/applications/Iconize.app
Icons8	Standalone desktop icon search and asset picker	utilities/applications/Icons8.app
IconShop	Mac asset editor and icon converter	utilities/applications/IconShop.app
Pictogram	Apply custom ICNS icons to any app or folder	utilities/applications/Pictogram.app

3. Keyboard Maestro Action Icon Bundles (utilities/kb-maestro-actions/)

Pre-scaled, high-contrast action icons categorized for Keyboard Maestro macros:

• system/: Terminal (warp.png, alacritty.png, ghostty.png), IDEs (vscode.png, neovim.png, emacs.png), system editors (unreal-editor.png, claude-code.png).
• text/: Language badges (python.png, typescript.png, java.png, csharp.png, swift.png, lua.png).
• files/: Cloud & dev tools (docker.png, kubernetes.png, cloudflare.png, nginx.png, postman.png, azure.png).
• visibility/: Service toggles (chrome.png, gitlab.png, google.png, android-share.png).

See utilities/kb-maestro-actions/README.md for details.

4. Folder Templates (utilities/folders/)

Templates and base assets in icns/, png/, and svg/ for creating custom folder designs.

---

📜 License

This repository is licensed under the WTFPL (Do What The Fuck You Want To Public License).

---

Collected and organized for quick access