You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Stephan Bösch-Plepelits 152e77cdad Update dependencies 2 years ago
bin Merge branch 'tags-display' 4 years ago
dist Make sure the dist/ directory is always created 7 years ago
doc Update 2 years ago
img GeoInfo: while tab is active, show crosshair over map view center 4 years ago
lang Translated using Weblate (Portuguese (Brazil)) 2 years ago
lib Update dependencies; fix Leaflet to 1.7 due to compatibility issues 2 years ago
locales Locale 'zh-hans': use 'zh-cn' for momentjs 2 years ago
modulekit@8c875354b7 Update submodules ; modulekit-lang follows master branch 6 years ago
src CategoryOverpass: re-throw twig compile errors for better debugging 2 years ago
test CategoryOverpassFilter: specify values via path into data 6 years ago
.babelrc Update dependencies 4 years ago
.gitignore Update .gitignore and install instructions 7 years ago
.gitmodules Use a mysql database for session handling 5 years ago
LICENCE.txt Add LICENCE file 6 years ago Update installation instructions to Ubuntu 22.04 2 years ago
ajax.php ajax.php: do not json_decode post data 2 years ago
asset.php Assets: caching 5 years ago
composer.json Instead of FreeGeoIP use local GeoIP database 7 years ago
conf.php-dist conf.php-dist: disable repositoriesGitea by default 2 years ago
customCategory.php CustomCategory: when loading file, add Content-Disposition 2 years ago
httpGet.php httpGet: fallback to load-via-server; option 'forceServerLoad' 6 years ago
index.php Improve babel and minify-ing code 3 years ago
init.sql CustomCategory: record each access to a category (once per day and session) 2 years ago
manifest.json manifest.json: add file 7 years ago
modulekit.php Update modulekit.php 2 years ago
package-lock.json Update dependencies 2 years ago
package.json Bump to version 5.3.0 2 years ago
repo.php repo.php: parameter file: load raw file from repository 2 years ago
style.css CustomCategory: a few style improvements 2 years ago


git clone
cd openstreetbrowser
npm install
composer install
git submodule init
git submodule update
cp conf.php-dist conf.php
nano conf.php
npm run build

=> more detailed Installation instructions


cd openstreetbrowser
git pull
npm update
git submodule init
git submodule update
npm run build


Develop categories

rm -r node_modules/openstreetbrowser-categories-main
git clone node_modules/openstreetbrowser-categories-main

You are welcome to send pull requests via Github!

Category definition

There are currently two types of categories: index (for sub categories) and overpass (for OpenStreetMap data, loaded via an Overpass API request). Each of them is defined via a JSON (old) or YAML (recommended) structure. They can be combined into a single file.

Check out the tutorial!

Category 'index'

File: dir.json

    "type": "index",
    "subCategories": [
            "id": "foo"
            "id": "bar",
            "type": "overpass",
            "query": "node[amenity=bar]"

or File: dir.yaml

type: index
  - id: foo
  - id: bar
    type: overpass
    query: node[amenity=bar]

This will define a category with the id 'dir' (from the file name) with two sub-categories: 'foo' (which will be loaded from the file foo.json) and 'bar' (which is defined inline as category of type 'overpass' and will show all nodes with the tag 'amenity' set to value 'bar' - see below for more details).

Category 'overpass'

File: foo.json

    "type": "overpass",
    "query": {
        "12": "(node[highway~'^(motorway_junction)$'];way[highway~'^(motorway|trunk)$'];)",
        "14": "(node[highway~'^(motorway_junction|mini_roundabout|crossing)$'];way[highway~'^(motorway|trunk|primary)$'];)",
        "16": "(node[highway];way[highway];)"
    "feature": {
        "style": {
            "color": "{% if tags.highway == 'motorway' %}#ff0000{% elseif tags.highway == 'trunk' %}#ff7f00{% elseif tags.highway == 'primary' %}#ffff00{% else %}#0000ff{% endif %}"
        "markerSign": "{% if tags.highway == 'motorway_junction' %}↗{% elseif tags.highway == 'mini_roundabout' %}↻{% elseif tags.highway == 'crossing' %}▤{% endif %}",
        "title": "{{ localizedTag(tags, 'name') |default(localizedTag(tags, 'operator')) | default(localizedTag(tags, 'ref')) | default(trans('unnamed')) }}",
        "description": "{{ tagTrans('highway', tags.highway) }}",
        "body": "Foo value: {{ }}"
    "const": {
        "foo": "foo value"

This will define a category with the id 'foo' (from the file name). It will show some highway amenities, depending on the current zoom level.

The following values are possible for categories (the only mandatory value is query):

  • query: either a string or an object of strings with the minimal zoom level as index. Give the Overpass API queries without the header (e.g. [out:json] or bounding box) and footer (e.g. out meta geom or so).
  • minZoom: Show layer only from the given zoom level (default: 14). If query is an object and minZoom is not set, the lowest zoom level of a query will be used.
  • maxZoom: Show layer only up to the given zoom level (default: no limit).
  • feature: an object describing how the feature will be formatted resp. styled.
    • style: a Leaflet style.
      • stroke: Whether to draw stroke along the path. Set it to false or empty string to disable borders on polygons or circles. (boolean, true)
      • width: Stroke width, optionally with unit ('px' for width in screen pixels (default) or 'm' for width in world meters). Default: '3px'.
      • color: Stroke color (string, '#3388ff')
      • opacity: Stroke opacity (number, 1.0)
      • offset: Offset stroke to left or right ('px' for width in screen pixels (default) or 'm' for width in world meters). Default: '0px'.
      • lineCap: shape at end of the stroke (string, 'round')
      • lineJoin: shape at corners of the stroke (string, 'round')
      • dashArray: stroke dash pattern (string, null)
      • dashOffset: distrance into the dash pattern to start dash (string, null)
      • fill: whether to fill the path with color. Set it to false or empty string to disable filling on polygons or circles. (boolean, depends)
      • fillColor: Fill color. Defaults to the value of the color option. (string)
      • fillOpacity: Fill opacity. (number, 0.2)
      • fillRule: define how the inside of a shape is determined. (string, 'evenodd')
      • smoothFactor: (unclosed ways only) How much to simplify the polyline on each zoom level. (number, 1.0)
      • noClip: (unclosed ways only) Disable polyline clipping. (boolean, false)
      • nodeFeature: (nodes only) Which type of feature to show on nodes. Valid values: 'Marker', 'Circle', 'CircleMarker'. (string, 'CircleMarker')
      • radius: (nodes with nodeFeature 'Circle' or 'CircleMarker' only) Radius of the circle (for 'Circle': in meters, for 'CircleMarker': in pixels, default: 10). (number)
      • pattern: false/empty: no pattern, 'arrowHead', 'dash', 'marker'
      • pattern-offset: Offset of the first pattern symbol, from the start point of the line. Default: 0.
      • pattern-endOffset: Minimum offset of the last pattern symbol, from the end point of the line. Default: 0.
      • pattern-repeat: Repetition interval of the pattern symbols. Defines the distance between each consecutive symbol's anchor point.
      • pattern-polygon: true/false (arrowHead only)
      • pattern-pixelSize: size of pattern (arrowHead and dash only)
      • pattern-headAngle: Angle of the digits (arrowHead only)
      • pattern-angleCorrection: degrees (arrowHead and marker only)
      • pattern-rotate: false (marker only)
      • pattern-path-*: Options for the path, e.g. pattern-path-width, pattern-path-color.
      • pane: show vector on the specified pane (usually defined: 'overlayPane' (default), 'hover', 'selected', 'casing')
    • title: the title of the feature popup, the object in the list and the details page. (default: localized tags for 'name', 'operator' or 'ref', default: 'unknown')
    • body: the body for the feature popup and the details page.
    • description: a short description shown in the list next to the title.
    • popupDescription: like description, but an alternative if the description in popups should be different from the list.
    • markerSign: a HTML string which will be shown within the marker and in the list. (default: '')
    • priority: a numeric value by which the elements in the list will be sorted (lower values first)
    • preferredZoom: At which max. zoom level will the map zoom when showing details
  • const: an object variable which is available as prefix in twig functions.

All values in the "feature" section may use the TwigJS language for evaluation.


With the function register_hook you can hook into several functions. The following hooks are available:

  • state-get: modules can add values into the current state. Parameters: state: an object, which can be modified by modules.
  • state-apply: when a state is applied to the app. Parameters: state: state which should be applied.
  • show-details: called when details are being displayed. Parameters: data (see properties in doc/, category, dom, callback.
  • hide-details: called when the details page is left. No parameters.
  • show-popup: called when a popup is being displayed. Parameters: data (see properties in doc/, category, dom, callback.
  • options_save: called when options are saved. Parameters: options (the new object), old_options (before save)
  • initFinish: called when the app initialization finishes

New locale

  • Add language code to the $languages array in conf.php (and conf.php-dist)
  • Create file locales/CODE.js with:
global.locale = {
  id: 'CODE',
  moment: require('moment'),
  // replace 'en' by 'CODE', when a translation for date-format has been submitted
  osmDateFormatTemplates: require('openstreetmap-date-format/templates/en')

  • Run npm run build-locales