Google Fonts Tools
This project contains tools used for working with the Google Fonts collection, plus Google Fonts Glyph Set Documentation in the /encodings subdirectory. While these tools are primarily intended for contributors to the Google Fonts project, anyone who works with fonts could find them useful.
Additional documentation in /docs
The tools and files under this directory are available under the Apache License v2.0, for details see LICENSE
Google Fonts Official Glyph Sets
The glyph sets useful for type designers that were previously hosted in this repository have been moved to:
https://github.com/googlefonts/glyphsets/tree/main/GF_glyphsets
Tool Usage Examples
Compare fonts:
gftools compare-font font1.ttf font2.ttf
Add a METADATA.pb to a family directory
gftools add-font ../ofl/newfamily
Sanity check a family directory:
gftools sanity-check --repair_script=/tmp/fix.py ../ofl/josefinsans
gftools sanity-check --repair_script=/tmp/fix.py --fix_type=fsSelection ../ufl
Check a font family against the same family hosted on Google Fonts:
gftools qa [fonts.ttf] -gfb -a -o qa
Check a variable font family against the same family as static fonts:
gftools qa -f [vf_fonts] -fb [static_fonts] --diffenator --diffbrowsers -o ~/path/out
Fix a non hinted font
gftools fix-nonhinting font_in.ttf font_out.ttf
Package and PR a family update to google/fonts. Find much more detailed documentation in /docs/gftools-packager.
gftools packager "Family Sans" path/to/local/google/fonts -py
Tool Installation
Please note that gftools requires Python 3.7 or later.
Please install these tools using pip:
pip install gftools
If you would like to use gftools qa:
brew install pkg-config # needed for interpolation checks
pip install 'gftools[qa]'
Tool Requirements and Dependencies
gftools packager needs the command line git program in a version >= Git 2.5 (Q2 2015) in order to perform a shallow clone (--depth 1) of the font upstream repository and branch. This is not supported by pygit2/libgit2 yet.
gftools manage-traffic-jam requires two private files which contain sensitive data. Ask m4rc1e for them.
Google Fonts API Key
In order to use the scripts gftools qa and gftools family-html-snippet, you will need to generate a Google Fonts api key, https://developers.google.com/fonts/. You will then need to create a new text file located on your system at ~/.gf-api-key (where ~ is your home directory), which contains the following:
[Credentials]
key = your-newly-generated-googlefonts-api-key
Upstream project repos
Developers
Releasing a New Version
- Commit and push your final changes for the new version.
- Create an annotated Git tag of the version number, with a prepended "v", like so:
git tag -a v3.1.1 - Write the release notes into the tag message. They will show up as release notes on the release page in GitHub.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gftools-0.9.999.tar.gz.
File metadata
- Download URL: gftools-0.9.999.tar.gz
- Upload date:
- Size: 8.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ca3ca14f848542eec35282054ca98ec467b888a13f2969f01d8858ec941eff6f
|
|
| MD5 |
230726e80a00fdd7f59912621bd726c6
|
|
| BLAKE2b-256 |
8524d97a9f7ec742578e735fb3a32d4d858241f134a41ac5d217f090aeb1479d
|
Provenance
The following attestation bundles were made for gftools-0.9.999.tar.gz:
Publisher:
publish-release.yml on googlefonts/gftools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gftools-0.9.999.tar.gz -
Subject digest:
ca3ca14f848542eec35282054ca98ec467b888a13f2969f01d8858ec941eff6f - Sigstore transparency entry: 2450124330
- Sigstore integration time:
-
Permalink:
googlefonts/gftools@1d877c7fcd795fd49a2fb2d55ef0798f4c0223ad -
Branch / Tag:
refs/tags/v0.9.999 - Owner: https://github.com/googlefonts
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-release.yml@1d877c7fcd795fd49a2fb2d55ef0798f4c0223ad -
Trigger Event:
push
-
Statement type:
File details
Details for the file gftools-0.9.999-py3-none-any.whl.
File metadata
- Download URL: gftools-0.9.999-py3-none-any.whl
- Upload date:
- Size: 2.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
100660963d494822226d77eb83ef4fbebfc589a9fb42190172f7bfbcec26cbc8
|
|
| MD5 |
13699f615d934bc92f0b403d688167f7
|
|
| BLAKE2b-256 |
b124f7c52a30c8999a329ede1a4a3043f8f4f37fba50922147772e66e3313978
|
Provenance
The following attestation bundles were made for gftools-0.9.999-py3-none-any.whl:
Publisher:
publish-release.yml on googlefonts/gftools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
gftools-0.9.999-py3-none-any.whl -
Subject digest:
100660963d494822226d77eb83ef4fbebfc589a9fb42190172f7bfbcec26cbc8 - Sigstore transparency entry: 2450124365
- Sigstore integration time:
-
Permalink:
googlefonts/gftools@1d877c7fcd795fd49a2fb2d55ef0798f4c0223ad -
Branch / Tag:
refs/tags/v0.9.999 - Owner: https://github.com/googlefonts
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-release.yml@1d877c7fcd795fd49a2fb2d55ef0798f4c0223ad -
Trigger Event:
push
-
Statement type:
