FontAwesome Converter

Convert FontAwesome icons to PNG format

Python License SVG PNG

FontAwesome Icons

📋 Overview

FontAwesome Converter is a Python tool that allows you to convert FontAwesome icons to PNG format with flexible options. The tool supports both SVG-based and font-based rendering methods and can generate icons in multiple sizes simultaneously.

✨ Features

🎨 Multiple Rendering Methods: Convert using SVG or font-based rendering
📐 Flexible Size Options: Generate icons in multiple preset sizes (16px to 512px)
🔣 Style Support: Convert icons in solid, regular, or brands styles
🎭 Color Customization: Apply custom colors to your icons
📁 Organized Output: Automatically organizes icons by size in separate folders
🔄 Batch Processing: Convert individual icons or the entire icon set
📊 Logging Control: Adjustable verbosity with multiple log levels

🚀 Installation

From PyPI (Recommended)

pip install fontawesome-converter

From Source

# Clone the repository
git clone https://github.com/SakuraPuare/fontawesome-converter.git
cd fontawesome-converter

# Install the package
pip install -e .

📖 Usage

📂 FontAwesome Path Requirements

The /path/to/fontawesome argument should point to the extracted FontAwesome package directory downloaded from fontawesome.com/download. After downloading the ZIP file, extract it and use the path to the extracted directory.

Expected Directory Structure

fontawesome-directory/
├── css/
├── js/
├── svgs/
│   ├── solid/
│   ├── regular/
│   └── brands/
├── webfonts/
└── metadata/
    └── icons.json

Important notes:

Make sure to use the path to the extracted directory, not the ZIP file

The tool needs access to svgs/ directory for SVG rendering and webfonts/ for font rendering

The metadata/icons.json file is required for both rendering methods

Both Free and Pro versions of FontAwesome are supported

💻 Command Line Interface

Convert a single icon:

fa-convert convert arrow-right /path/to/fontawesome --style solid --size 512 --color "#FF0000"

Convert all icons:

fa-convert convert-all /path/to/fontawesome --style solid --size 512

⚙️ Options

Option	Description
`--style`	Icon style (solid, regular, brands)
`--size`	Maximum output size in pixels (will generate all standard sizes up to this value)
`--color`	Color for the icon (as hex code)
`--render-method`	Method to use for rendering (svg or font)
`--output-dir`	Directory to save the outputs
`--log-level`	Set logging verbosity (DEBUG, INFO, WARNING, ERROR, CRITICAL)

🐍 Python API

from fontawesome_converter import FontAwesomeConverter

# Initialize converter
converter = FontAwesomeConverter("/path/to/fontawesome")

# Convert a single icon
converter.convert_svg("arrow-right", style="solid", size=512, color="#FF0000")

# Convert all icons
converter.convert_all(style="solid", size=512, render_method="svg")

📊 Output Structure

Converted icons are organized in the following structure:

View Output Directory Structure

output/
  16px/
    icon1_solid.png
    icon2_regular.png
    ...
  24px/
    icon1_solid.png
    icon2_regular.png
    ...
  32px/
    ...
  48px/
    ...
  64px/
    ...
  128px/
    ...
  256px/
    ...
  512px/
    ...

🔍 Examples

Basic Usage

Convert an icon to multiple sizes (maximum 512px):

fa-convert convert arrow-right /path/to/fontawesome

Custom Colors

Convert all "solid" style icons to blue PNGs:

fa-convert convert-all /path/to/fontawesome --style solid --color "#0000FF"

Verbose Logging

Adjust log level for detailed information:

fa-convert --log-level DEBUG convert arrow-right /path/to/fontawesome

🔧 Requirements

Python 3.10+
FontAwesome files (can be downloaded from FontAwesome)
Dependencies:
- cairosvg - for SVG rendering
- Pillow - for image processing
- loguru - for enhanced logging
- click - for CLI interface
- tqdm - for progress bars

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

_{Built with ❤️ by SakuraPuare}

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fontawesome_converter-1.1.0.tar.gz (11.2 kB view details)

Uploaded Mar 22, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fontawesome_converter-1.1.0-py3-none-any.whl (10.6 kB view details)

Uploaded Mar 22, 2025 Python 3

File details

Details for the file fontawesome_converter-1.1.0.tar.gz.

File metadata

Download URL: fontawesome_converter-1.1.0.tar.gz
Upload date: Mar 22, 2025
Size: 11.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for fontawesome_converter-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`76a26c931c8f387feb885df9743bee243d210f6eb41737c970fc1a4cdb9f0dc2`
MD5	`2d941b2ca308a0327161413f7a8c34e5`
BLAKE2b-256	`cbe302012f5055c96ddfd1ba805d2a1f21f4e66dddeed3bd32544f14aee7b268`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fontawesome_converter-1.1.0.tar.gz:

Publisher: python-publish.yml on SakuraPuare/fontawesome-converter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fontawesome_converter-1.1.0.tar.gz
- Subject digest: 76a26c931c8f387feb885df9743bee243d210f6eb41737c970fc1a4cdb9f0dc2
- Sigstore transparency entry: 186567042
- Sigstore integration time: Mar 22, 2025
Source repository:
- Permalink: SakuraPuare/fontawesome-converter@b9402c0f5fb7e12b87f272b7d714a00d5f3e9cbb
- Branch / Tag: refs/tags/v1.1.0
- Owner: https://github.com/SakuraPuare
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@b9402c0f5fb7e12b87f272b7d714a00d5f3e9cbb
- Trigger Event: release

File details

Details for the file fontawesome_converter-1.1.0-py3-none-any.whl.

File metadata

Download URL: fontawesome_converter-1.1.0-py3-none-any.whl
Upload date: Mar 22, 2025
Size: 10.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for fontawesome_converter-1.1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3cdd094cd7bf308ff2a56afcc7d765ef90e3852e7bda28f23a86b4abf280613d`
MD5	`a097ee87ffa76e4a30bdb660446e5eb4`
BLAKE2b-256	`4fc4059167d6152f66b465fd878239ba49f7ebc49c47d7b0a9093fb51d2e8f95`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fontawesome_converter-1.1.0-py3-none-any.whl:

Publisher: python-publish.yml on SakuraPuare/fontawesome-converter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fontawesome_converter-1.1.0-py3-none-any.whl
- Subject digest: 3cdd094cd7bf308ff2a56afcc7d765ef90e3852e7bda28f23a86b4abf280613d
- Sigstore transparency entry: 186567043
- Sigstore integration time: Mar 22, 2025
Source repository:
- Permalink: SakuraPuare/fontawesome-converter@b9402c0f5fb7e12b87f272b7d714a00d5f3e9cbb
- Branch / Tag: refs/tags/v1.1.0
- Owner: https://github.com/SakuraPuare
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@b9402c0f5fb7e12b87f272b7d714a00d5f3e9cbb
- Trigger Event: release

Release history Release notifications | RSS feed

This release

1.1.0 This release

Mar 22, 2025 2 files

1.0.0

Mar 22, 2025 2 files

0.1.0

Mar 22, 2025 2 files

fontawesome-converter 1.1.0

FontAwesome Converter

📋 Overview

✨ Features

🚀 Installation

From PyPI (Recommended)

From Source

📖 Usage

📂 FontAwesome Path Requirements

💻 Command Line Interface

⚙️ Options

🐍 Python API

📊 Output Structure

🔍 Examples

🔧 Requirements

📜 License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed