{"id":15472058,"url":"https://github.com/pganssle/fa-subset","last_synced_at":"2026-07-01T04:31:56.544Z","repository":{"id":66144853,"uuid":"575946023","full_name":"pganssle/fa-subset","owner":"pganssle","description":null,"archived":false,"fork":false,"pushed_at":"2022-12-08T17:03:07.000Z","size":5914,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-12T00:13:21.982Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pganssle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-08T16:50:16.000Z","updated_at":"2022-12-08T16:51:03.000Z","dependencies_parsed_at":"2023-02-22T01:16:12.879Z","dependency_job_id":null,"html_url":"https://github.com/pganssle/fa-subset","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pganssle/fa-subset","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pganssle%2Ffa-subset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pganssle%2Ffa-subset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pganssle%2Ffa-subset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pganssle%2Ffa-subset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pganssle","download_url":"https://codeload.github.com/pganssle/fa-subset/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pganssle%2Ffa-subset/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34993435,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-02T02:25:09.411Z","updated_at":"2026-07-01T04:31:56.518Z","avatar_url":"https://github.com/pganssle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `fa-subset`: A utility for extracting glyphs from Font Awesome\n\n[Font Awesome](https://fontawesome.com/) is an icon font framework that is very useful for designing web sites and web applications, but because it's got extensive coverage of various icons, it can be a quite heavyweight solution when you only use a few of the glyphs. With `fa-subset`, you can extract only the glyphs you want to use, along with the CSS you need to use it.\n\nFor example, if you only want to use the `user`, `rss`, `arrow-right` and `arrow-left` glyphs, you'd need to serve `fa-regular-400.{ttf,woff2}`, which are currently 61k and 25k, respectively. With  `fa-subset`, those files are 1.8k and 0.8k, respectively.\n\n## Usage\n```\nUsage: fa-subset [OPTIONS] INPUT\n\n  A CLI for creating subsets of the font awesome icon framework.\n\n  \"INPUT\" should be a newline-delimited text file containing a list of glyphs\n  to include in the output.\n\n  If none of the `--font-awesome*` flags are specified, this tries to download\n  the latest version. Otherwise, you may specify exactly one of those options\n  to pick which version of font-awesome to use.\n\nOptions:\n  --output DIRECTORY           A directory (which may exist already, but will\n                               be made if it does not exist) where the outputs\n                               should go. If you would like to specify the CSS\n                               and font output locations separately, use\n                               `--css-output` and `--font-output`. If those\n                               are used, you must not specify `--output`.\n  --css-output DIRECTORY       A directory into which to put the CSS files. If\n                               specified, you must NOT specify `--output`, and\n                               you MUST specify `--font-output`.\n  --font-output DIRECTORY      A directory into which to put the font files.\n                               If specified, you must NOT specify `--output`,\n                               and you MUST specify `--css-output`.\n  --font-awesome PATH          If you already have a copy of font-awesome\n                               (either as a zip or a directory, use this\n                               option to point the subsetter at it.\n  --font-awesome-url TEXT      If you have a specific URL to download font\n                               awesome from, use this option to pass it to the\n                               subsetter.\n  --font-awesome-version TEXT  If you know what version of font awesome you\n                               want to download, pass it to this option.\n  -f, --flavor TEXT            Flavors of font to output. Currently supported\n                               options are: woff2, woff and ttf\n  --help                       Show this message and exit.\n```\n\n`fa_subset` can also be used as a library, for your font subsetting needs that are more complicated than something you can easily express in terms of the command line flags.\n\n## Installation\n\n`fa_subset` is available [on PyPI](https://pypi.org/project/fa-subset/). We recommend installing it with [`pipx`](https://pypa.github.io/pipx/) or in a virtual environment.\n\n## License\n\nAll images and documentation contained herein are licensed under [CC-0](https://creativecommons.org/publicdomain/zero/1.0/\u003e).\n\nThe code is released under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license.\n\nThese licenses do not cover Font Awesome. As of 2022, the free versions of Font Awesome use [SIL OFL 1.1, CC-BY 4.0 and MIT Licenses](https://fontawesome.com/license/free).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpganssle%2Ffa-subset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpganssle%2Ffa-subset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpganssle%2Ffa-subset/lists"}