{"id":13552877,"url":"https://github.com/fonttools/region-flags","last_synced_at":"2026-03-16T20:38:38.047Z","repository":{"id":19607383,"uuid":"22858482","full_name":"fonttools/region-flags","owner":"fonttools","description":"Collection of flags for BCP 47 region codes in SVG / PNG","archived":false,"fork":false,"pushed_at":"2024-05-02T03:29:11.000Z","size":83145,"stargazers_count":208,"open_issues_count":17,"forks_count":107,"subscribers_count":19,"default_branch":"gh-pages","last_synced_at":"2025-10-09T05:15:22.018Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"nats-io/nats-server","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fonttools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-08-11T23:42:40.000Z","updated_at":"2025-09-18T05:44:30.000Z","dependencies_parsed_at":"2024-12-15T17:41:31.336Z","dependency_job_id":null,"html_url":"https://github.com/fonttools/region-flags","commit_stats":null,"previous_names":["behdad/region-flags"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/fonttools/region-flags","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonttools%2Fregion-flags","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonttools%2Fregion-flags/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonttools%2Fregion-flags/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonttools%2Fregion-flags/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fonttools","download_url":"https://codeload.github.com/fonttools/region-flags/tar.gz/refs/heads/gh-pages","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fonttools%2Fregion-flags/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27770253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-16T02:00:10.477Z","response_time":57,"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-08-01T12:02:12.409Z","updated_at":"2025-12-16T19:47:52.933Z","avatar_url":"https://github.com/fonttools.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"# Introduction\n\nThis package is a collection of flags for geographic region and sub-region codes.\nThe regions are based on the data from [BCP 47][0] and selected sub-regions (US\nstates, Canadian provinces and territories, and some sub-regions of Great Britain)\nare based on [ISO 3166-2:US][1], [ISO 3166-2:CA][2], and [ISO-3166-2:GB][2].\n\nMost people think of these regions from BCP 47 as country flags, but there are a\nfew codes / flags that do not correspond to countries. The flags are in SVG and\nPNG format and named by their BCP 47 region code, which for countries is the same\nas ISO 3166-2 country code. In case of sub-regions, ISO 3166-2 is used for naming\nthe files; e.g. `US-DE.png` is the flag of the State of Delaware.\n\nThe canonical way to get all BCP 47 region codes is to look for records in\n`language-subtag-registry` (which is downloaded from [IANA Language Subtag\nRegistry][0]) with the following fields:\n\n\tType: region\n\tSubtag: [A-Z]{2}\n\tAND NOT Description: Private use\n\tAND NOT Deprecated: .*\n\nRegions not in that repository can be added to `language-subtag-private`.\nOne such region has been added.\n\nSome regions do not have their own flag. In such cases, they are symlinked to\nthe best flag to represent them, which in most cases is the flag of their\nregional or political parent. These are listed in file `ALIASES`.\n\nThe sub-regions currently covered are:\n\n- US states and the District of Columbia\n- Canadian provinces and territories\n- Countries of England, Scotland, and Wales in Great Britain\n- The province Northern Ireland in Great Britain\n- Australia's states and its two self-governing internal territories\n- German states\n- Spain's regions\n- Mexico's states and one federal district\n\nThe flags are downloaded from Wikipedia. When Wikipedia flags were copyrighted,\nwe worked we Wikipedia editors to either relicense them, or drew / sourced and\nuploaded new public-domain versions.  In particular, the license for these\nflags were resolved for the initial import:\n\n- Montenegro\n- Nicaragua\n- Sint Maarten\n- Ascension Island\n- Lesotho\n- Kosovo\n\n# Scripts\n\n- The script `regions.py` lists all regions and some selected sub-regions with their metadata.\n- The script `regions-wp.py` shows the Wikipedia URL for the flag page.\n- The script `missing.sh` shows all such regions that we don't have flags for.\n- The script `make-aliases.sh` makes symlinks for regions that use flag of another region.\n- The script `download-wp.sh` downloads missing flags from Wikipedia and optionally you can generate optimized SVG and PNG versions (e.g., download-wp.sh true).\n- The script `update.sh` automatically regenerates all files and outputs optimized png.\n- The script `convert.sh` converts SVG to PNG with ability to specify Width or Height.\n\nYou can use the [waveflag script from the Noto Emoji project](https://github.com/googlefonts/noto-emoji/blob/main/waveflag.c)\nto _wave_ PNG flags.\n\n# Requirements\n\n- Python 3\n- [`dos2unix`](http://sourceforge.net/projects/dos2unix/)\n- `rsvg-convert` part of [`librsvg`](https://wiki.gnome.org/Projects/LibRsvg)\n- [`optipng`](http://optipng.sourceforge.net/)\n\n# Updating\n\nIf new regions are needed, update `language-subtag-registry` from [IANA Language\nSubtag Registry][0], or add new regions to `language-subtag-private` before.  Then\nupdate `data/ALIASES` and `data/ALIASES-WP` as needed.\n\nIf a specific flag on Wikipedia flag is under Creative Commons, work with Wikipedia\neditors to relicense it to public domain.  If the flag is not explicitly marked\n`public_domain` but otherwise exempt from Copyright (typically, because of\nnational laws), make a note of it in file `COPYING`.\n\nTo download missing flags, run `download-wp.sh`.\n\nTo update to latest flags from Wikipedia, delete the `html`, `svg`, and `png`\ndirectories, then run `make-aliases.sh` followed by `download-wp.sh` or you can use `update.sh`.\n\n\n\n# License\n\nSee file `COPYING` for details.\n\n[0]: http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry\n[1]: https://www.iso.org/obp/ui/#iso:code:3166:US\n[2]: https://www.iso.org/obp/ui/#iso:code:3166:GB\n[3]: https://www.iso.org/obp/ui/#iso:code:3166:CA\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffonttools%2Fregion-flags","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffonttools%2Fregion-flags","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffonttools%2Fregion-flags/lists"}