Metadata-Version: 2.4
Name: FindSystemFontsFilename
Version: 0.3.3
Summary: Find the system fonts filename.
Author-email: moi15moi <moi15moismokerlolilol@gmail.com>
License-Expression: MIT
Project-URL: Source, https://github.com/moi15moi/FindSystemFontsFilename/
Project-URL: Tracker, https://github.com/moi15moi/FindSystemFontsFilename/issues/
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Android
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: comtypes>=1.4.13; platform_system == "Windows"
Provides-Extra: dev
Requires-Dist: coverage>=7.0.0; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Dynamic: license-file

# FindSystemFontsFilename
[![FindSystemFontsFilename - CI Build Status](https://github.com/moi15moi/FindSystemFontsFilename/workflows/Run%20Tests/badge.svg)](https://github.com/moi15moi/FindSystemFontsFilename/actions/workflows/run_test.yml)
[![FindSystemFontsFilename - Version](https://img.shields.io/pypi/v/findsystemfontsfilename.svg)](https://pypi.org/project/FindSystemFontsFilename)
[![FindSystemFontsFilename - Python Version](https://img.shields.io/pypi/pyversions/findsystemfontsfilename.svg)](https://pypi.org/project/FindSystemFontsFilename)
[![FindSystemFontsFilename - Coverage](https://img.shields.io/codecov/c/github/moi15moi/FindSystemFontsFilename)](https://app.codecov.io/github/moi15moi/FindSystemFontsFilename)

This tool allows you to get the font filename on your system. It will collect TrueType (.ttf), OpenType (.otf), TrueType Collection (.ttc) and OpenType Collection (.otc) font format.

It uses some APIs to find the font filename:
- Windows (Vista SP2 and more are supported): [DirectWrite API](https://learn.microsoft.com/en-us/windows/win32/directwrite/direct-write-portal) and [GDI API](https://learn.microsoft.com/en-us/windows/win32/gdi/windows-gdi)
- macOS (10.6 and more are supported): [Core Text API](https://developer.apple.com/documentation/coretext)
- Unix: [Fontconfig API](https://www.freedesktop.org/wiki/Software/fontconfig/)
- Android (SDK/API 29 and more are supported): [NDK Font API](https://developer.android.com/ndk/reference/group/font)

## Installation
```
pip install FindSystemFontsFilename
```

## How to use it
```python
from find_system_fonts_filename import get_system_fonts_filename, FindSystemFontsFilenameException

try:
    fonts_filename = get_system_fonts_filename()
except FindSystemFontsFilenameException:
    # Deal with the exception
    pass
```
