| name | icon-generator |
| description | Generate app icons and favicons in multiple sizes from a single source image. Support for iOS, Android, web favicon, and social media formats. |
Icon Generator
Generate app icons in all required sizes from a single image.
Features
- Multi-Platform: iOS, Android, Web, macOS, Windows
- Batch Generation: All sizes from one source
- Smart Scaling: Maintain quality at all sizes
- Format Support: PNG, ICO, ICNS
- Presets: Platform-specific size sets
- Rounding Options: Square or rounded corners
Quick Start
from icon_generator import IconGenerator
gen = IconGenerator()
# Generate all iOS icons
gen.load("logo.png")
gen.generate_ios("ios_icons/")
# Generate all favicon sizes
gen.load("logo.png")
gen.generate_favicon("favicon/")
# Generate specific sizes
gen.load("logo.png")
gen.generate_sizes([16, 32, 64, 128, 256, 512], "icons/")
CLI Usage
# Generate iOS icons
python icon_generator.py --input logo.png --preset ios --output-dir ios_icons/
# Generate Android icons
python icon_generator.py --input logo.png --preset android --output-dir android_icons/
# Generate favicons
python icon_generator.py --input logo.png --preset favicon --output-dir favicon/
# Custom sizes
python icon_generator.py --input logo.png --sizes 16 32 64 128 256 -o icons/
# Generate all platforms
python icon_generator.py --input logo.png --preset all --output-dir app_icons/
API Reference
IconGenerator Class
class IconGenerator:
def __init__(self)
# Loading
def load(self, filepath: str) -> 'IconGenerator'
# Generation
def generate_ios(self, output_dir: str) -> List[str]
def generate_android(self, output_dir: str) -> List[str]
def generate_favicon(self, output_dir: str) -> List[str]
def generate_macos(self, output_dir: str) -> List[str]
def generate_windows(self, output_dir: str) -> List[str]
def generate_pwa(self, output_dir: str) -> List[str]
def generate_all(self, output_dir: str) -> Dict[str, List[str]]
# Custom
def generate_sizes(self, sizes: List[int], output_dir: str,
prefix: str = "icon") -> List[str]
def generate_single(self, size: int, output: str) -> str
# Options
def set_rounding(self, radius_percent: float) -> 'IconGenerator'
def set_padding(self, padding_percent: float) -> 'IconGenerator'
def set_background(self, color: Tuple) -> 'IconGenerator'
Platform Sizes
iOS (App Store)
- 20x20, 29x29, 40x40, 60x60, 76x76, 83.5x83.5
- 1024x1024 (App Store)
- @2x and @3x variants
Android
- mdpi: 48x48
- hdpi: 72x72
- xhdpi: 96x96
- xxhdpi: 144x144
- xxxhdpi: 192x192
- Play Store: 512x512
Favicon
- 16x16, 32x32, 48x48
- 180x180 (Apple Touch)
- 192x192, 512x512 (PWA)
Windows
- 16x16, 32x32, 48x48
- 256x256 (ICO)
Dependencies
- pillow>=10.0.0