icons8-dl

README

🖼️ icons8-dl

A fast, dependency-free command-line tool for downloading PNG icons from Icons8.com. Ships as a single static binary — no runtime to install.

[!WARNING] Uses the public, undocumented Icons8 website API (not the official Icons8 API). No API token is required or supported. Only icons can be downloaded (not illustrations or photos), and only in PNG format.

📦 Installation

Prebuilt binary (recommended): download the archive for your OS/architecture from the latest release, extract it, and put the icons8-dl binary on your PATH.

With Go (1.26+):

go install github.com/alexander-danilenko/icons8-dl@latest

🎯 Usage

Download one or more icon style packs by their code. Each pack is a positional argument and downloads into its own <target>/<Title>/ subdirectory:

icons8-dl ios_filled                      # one pack
icons8-dl ios_filled m_rounded fluent     # several at once
icons8-dl ios_filled -d ~/icons           # choose a target directory (default: current)

Re-runs skip icons already on disk, so an interrupted download resumes where it left off. Filenames don't encode size, so a file downloaded at one --size is skipped rather than refreshed at another — use --force to re-download.

Finding pack codes

Use list and search to print each pack's code and title live from the API:

icons8-dl list             # every available pack
icons8-dl search windows   # packs matching "windows"

The codes shown by list/search are the authoritative ones — they don't always match the style slug in an Icons8 website URL.

Options

Options work with every command and may appear before, between, or after positional arguments.

Option	Short	Description
--target-directory	-d	Target directory for downloaded icons (default: current directory)
--size	-s	Icon size: 24, 48, 96, 192, 384, or 512 (default: 512)
--force	-f	Re-download and overwrite files that already exist
--no-cache	-C	Disable response caching
--verbose	-v	Stream verbose JSON logs to stderr
--version		Show version and exit
--help		Show help message and exit

Downloading every pack

Pipe the codes from icons8-dl list (its first column) into a loop:

# Linux/macOS (Bash)
icons8-dl list | tail -n +2 | awk '{print $1}' | while read -r id; do icons8-dl "$id" -d ./icons; done

# Windows (PowerShell)
icons8-dl list | Select-Object -Skip 1 | ForEach-Object { icons8-dl ($_ -split '\s+')[0] -d .\icons }

📄 License

Licensed under the MIT License — see LICENSE. Icons and API courtesy of Icons8.

💬 Support

Found a bug or have a request? Open an issue.

Documentation

Overview

Command icons8-dl downloads icons from the Icons8 website API.

main.go is the composition root: it holds the build-time version and the production Icons8 endpoints, and hands off to the cli inbound adapter. All program logic lives under internal/ in the domain, application, and infrastructure layers.