qtawesome

library1.4.2pypypiunverified

QtAwesome is a Python library that provides FontAwesome, Material Design, and other icon fonts for PyQt and PySide applications. It simplifies the integration of scalable vector icons, allowing developers to easily use them in buttons, menus, and other UI elements. The library is actively maintained, currently at version 1.4.2, and receives regular updates, typically every few months, incorporating new features, bug fixes, and improved Qt binding compatibility.

web-framework

pip install qtawesome

github ↗package ↗

INSTALL

IMPORT

SIG · QTAWESOME

qtawesome

web-frameworkpythonv1.4.2

Install

1.9s avg

Import

—

Disk

24MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.4.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

4/8 runs

✓ 1.78s

py 3.11

4/8 runs

✓ 1.9s

py 3.12

4/8 runs

✓ 1.8s

py 3.13

4/8 runs

✓ 1.75s

py 3.9

4/8 runs

✓ 2.03s

24MB installed

● package 24MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

qtawesome

✓ import qtawesome

✗ import qtawesome

This quickstart demonstrates how to initialize a Qt application, create an icon using `qtawesome`, and display it within a `QLabel`. It uses `qtpy.QtWidgets.QApplication` for compatibility across different Qt bindings.

import qtawesome as qa from qtpy.QtWidgets import QApplication, QLabel import sys app = QApplication(sys.argv) # Create a Font Awesome 5 Solid 'home' icon with custom styling icon = qa.icon('fa5s.home', color='blue', scale_factor=1.2) # Create a QLabel and display the icon as a pixmap (e.g., 64x64 pixels) label = QLabel() label.setPixmap(icon.pixmap(64, 64)) label.setWindowTitle("QtAwesome Icon Example") label.show() sys.exit(app.exec_())

Debug

Known issues

deprecatedFont Awesome 4.7 icon set is deprecated and will eventually be removed. While still available, it's recommended to migrate to newer icon sets like Font Awesome 5+ or Material Design.

fix

Use icons from 'fa5s', 'fa5r', 'fa5b', 'mdi', 'el', 'fc', 'go', 'ri', 'bi', 'io', 'md' collections. Refer to `qtawesome.icon('fa5s.icon_name')`.

affects: <=1.1.1

gotchaOn Windows, QtAwesome attempts to install bundled fonts system-wide or per-user. If the user lacks necessary permissions or if registry keys are missing/unavailable, font installation might fail silently or cause icons not to render correctly.

fix

Ensure appropriate user permissions for font installation. For persistent issues, manually install the required icon fonts (e.g., Font Awesome, Material Design Icons) into your system's font directory. QtAwesome versions >=1.4.0 include fallback mechanisms and utilities to check bundled font info.

affects: All versions

breakingOlder versions of QtAwesome (prior to 1.4.1) may exhibit instability or failed test jobs when used with PySide6 or certain PySide2 versions due to specific API differences or caching issues.

fix

Upgrade to `qtawesome>=1.4.1` for improved compatibility and stability with PySide6 and recent PySide2 versions. Ensure `qtpy` is also up to date.

affects: <1.4.1

Upgrade

Version history

1.4.2latest on PyPI · released Apr 10, 2026

Audit

Dependencies

qtpyrequiredInternal abstraction layer for Qt bindings (PyQt5, PyQt6, PySide2, PySide6).

PyQt5optionalOne of the supported Qt bindings is required to run a Qt application.

PyQt6optionalOne of the supported Qt bindings is required to run a Qt application.

PySide2optionalOne of the supported Qt bindings is required to run a Qt application.

PySide6optionalOne of the supported Qt bindings is required to run a Qt application.

Agent activity

44 hits · last 30 days

node

Resources

githubhttps://github.com/spyder-ide/qtawesome ↗

packagehttps://pypi.org/project/qtawesome/ ↗