{"id":13557824,"url":"https://github.com/maputnik/osm-liberty","last_synced_at":"2025-04-03T12:31:15.046Z","repository":{"id":10261227,"uuid":"65086788","full_name":"maputnik/osm-liberty","owner":"maputnik","description":"A free Mapbox GL basemap style for everyone","archived":false,"fork":false,"pushed_at":"2025-03-24T01:17:22.000Z","size":10902,"stargazers_count":464,"open_issues_count":11,"forks_count":103,"subscribers_count":16,"default_branch":"gh-pages","last_synced_at":"2025-03-28T21:40:30.534Z","etag":null,"topics":["cartography","mapbox-gl","mapbox-gl-js","maps"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maputnik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2016-08-06T14:41:20.000Z","updated_at":"2025-03-28T14:57:29.000Z","dependencies_parsed_at":"2023-10-14T22:24:27.554Z","dependency_job_id":"f67e71fc-efbf-40a8-b8e6-e307d7ac0b35","html_url":"https://github.com/maputnik/osm-liberty","commit_stats":null,"previous_names":["lukasmartinelli/osm-liberty"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maputnik%2Fosm-liberty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maputnik%2Fosm-liberty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maputnik%2Fosm-liberty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maputnik%2Fosm-liberty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maputnik","download_url":"https://codeload.github.com/maputnik/osm-liberty/tar.gz/refs/heads/gh-pages","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247002249,"owners_count":20867432,"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","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":["cartography","mapbox-gl","mapbox-gl-js","maps"],"created_at":"2024-08-01T12:04:34.211Z","updated_at":"2025-04-03T12:31:12.177Z","avatar_url":"https://github.com/maputnik.png","language":"Python","funding_links":[],"categories":["Python","others"],"sub_categories":[],"readme":"# OSM Liberty [![BSD licensed](https://img.shields.io/badge/license-BSD-blue.svg)](https://github.com/maputnik/osm-liberty/blob/gh-pages/LICENSE.md) [![GitHub CI status](https://github.com/maputnik/osm-liberty/workflows/CI/badge.svg)](https://github.com/maputnik/osm-liberty/actions?query=workflow%3ACI)\n\n\u003cimg align=\"right\" alt=\"OSM Liberty\" src=\"logo.png\" /\u003e\n\nA free Maplibre and Mapbox GL basemap style for everyone with complete liberty to use and self host. OSM Liberty is a fork of OSM Bright based on free data sources with a mission for a clear good looking design for the everyday user. It is based on the vector tile schema of [OpenMapTiles](https://github.com/openmaptiles/openmaptiles).\n\n**[Preview OSM Liberty with Maputnik](https://maplibre.org/maputnik/?style=https://maputnik.github.io/osm-liberty/style.json)**\n\n## Usage\n\nYou can use the style in your Maplibre and Mapbox GL maps.\n\nBy default, the vector tiles are served from [Maptiler Cloud](https://www.maptiler.com/cloud/) and the relief shading, glyphs and sprites directly from GitHub.\nYou would need to create a [MapTiler](https://www.maptiler.com) account to get an access key and replace the placeholder {key} for the [vector source](https://github.com/maputnik/osm-liberty/blob/gh-pages/style.json#L11) with your own key.\n\nOther options are:\n- Create your own vector tiles with [OpenMapTiles](https://github.com/openmaptiles/openmaptiles) and host the tiles yourself for complete liberty.\n- Use another vector tile source that is based on the vector tile schema of [OpenMapTiles](https://github.com/openmaptiles/openmaptiles) \n\n## Data Sources\n\n- [OpenMapTiles](http://openmaptiles.org/) as vector data source\n- [Natural Earth Tiles](https://klokantech.github.io/naturalearthtiles/) for relief shading\n- [Maki](https://www.mapbox.com/maki-icons/) as icon set\n- [Orange Mug](https://github.com/orangemug/font-glyphs) as font glyphs\n\n## Map Design\n\nThe map design originates from OSM Bright but strives to reach a unobtrusive and clean design for everyday use.\nColored relief shading from Natural Earth make the low zoom levels look good.\n\n[![OSM Liberty Map demo](demo/zoom.gif)](https://maputnik.github.io/osm-liberty/)\n\n## Edit the Style\n\nYou can [edit the style directly online in Maputnik](https://maplibre.org/maputnik?style=https://maputnik.github.io/osm-liberty/style.json).\n\nThis style actually triggered the need for the development of [Maputnik](https://github.com/maplibre/maputnik).\n\nA pre-commit hook is included to validate and format the JSON styles using\n[`maplibre-gl-style-spec`](https://www.npmjs.com/package/@maplibre/maplibre-gl-style-spec).\nTo use, just install the NPM dev dependencies:\n```\nnpm install\n```\nand then validate or format the style with\n```\nnpm run validate\nnpm run format\n```\n\nValidation and reformatting will happen automatically on commit if you have the\ndependencies installed.\n\n## Icon Design\n\nA [Maki](https://github.com/mapbox/maki) icon set using colors to distinguish between icon categories.\n\nMaki is a living project and adds new icons over time, which means that there\ncould be new icons that OSM Liberty could use for POIs. `sources_list.py` is a\nsimple script to list both the names in OSM Liberty's iconset that don't map to\nany valid Maki name, and the Maki names that are not currently used in OSM\nLiberty's iconset. You can run the script with `python3 sources_list.py`.\n\n**Color Palette**\n\nColor Name   | Hex Value\n-------------|----------\nBlue         | `#5d60be`\nLight Blue   | `#4898ff`\nOrange       | `#d97200`\nRed          | `#ba3827`\nBrown        | `#725a50`\nGreen        | `#76a723`\n\n**Modify Icons**\n\n_When submitting a PR, no need to include the sprites. They will be automatically created when merging a PR.\u003cbr\u003e\nThe size 11 icons are included in the sprites for backward compatability. Please don't include new size 11 icons._\n\n1. Take the `iconset.json` and import it to the [Maki Editor](https://www.mapbox.com/maki-icons/editor/).\n2. Apply your changes and download the icons in SVG format and the iconset in JSON format.\nSave the downloaded SVGs from Maki Editor to the folder [svgs_iconset](https://github.com/maputnik/osm-liberty/tree/gh-pages/svgs/svgs_iconset).\n3. Mandatory if the updated `iconset.json` should become part of this repo: Format the JSON with `cat iconset.json | jq -MS '.'` for better legibility.\n4. There are also SVGs in the folder [svgs_not_in_iconset](https://github.com/maputnik/osm-liberty/tree/gh-pages/svgs/svgs_not_in_iconset).\nThese are the SVGs for road shields, the dot used for city and town layers and the road area pattern which could not be modified using the Maki Editor. To modify these you could use e.g. [Inkscape](https://inkscape.org).\n5. Generate the low and high resolution sprites: `npm run build_sprites`\n\n## Have a look at ...\n\n- [OSM Liberty Topo](https://github.com/nst-guide/osm-liberty-topo) - a topographic fork of OSM Liberty\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaputnik%2Fosm-liberty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaputnik%2Fosm-liberty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaputnik%2Fosm-liberty/lists"}