Skip to content
Snippets Groups Projects
Select Git revision
  • 8557ffb2b9a3ec3baac6292f025305b1bdd4c960
  • experimental default protected
  • v2023.2.5-ffs
  • nrb/ex400-remove-wps
  • nrb/airmax-test
  • v2023.2.4-ffs
  • nrb/ar9344-reset-sequence
  • autinerd/experimental-openwrt-24.10
  • v2023.2.3-ffs
  • v2023.2.2-ffs
  • v2023.2-ffs
  • v2023.1-ffs
  • v2022.1.4-ffs
  • feature/addMikrotikwAP
  • v2022.1.3-ffs
  • v2021.1.2-ffs
  • v2022.1.1-ffs
  • master protected
  • v2021.1.1-ffs
  • nrb/gluon-master-cpe510
  • v2021.1-ffs
  • experimental-2025-08-04
  • experimental-2025-08-04-base
  • experimental-2025-07-31
  • experimental-2025-07-31-base
  • experimental-2025-07-29
  • experimental-2025-07-29-base
  • experimental-2025-07-28
  • experimental-2025-07-28-base
  • experimental-2025-07-26
  • experimental-2025-07-26-base
  • experimental-2025-07-24
  • experimental-2025-07-24-base
  • experimental-2025-07-22
  • experimental-2025-07-22-base
  • experimental-2025-07-21
  • experimental-2025-07-21-base
  • experimental-2025-07-20
  • experimental-2025-07-20-base
  • experimental-2025-07-19
  • experimental-2025-07-19-base
41 results

dev

  • Clone with SSH
  • Clone with HTTPS
  • Build Status

    Main differences to https://github.com/ffnord/meshviewer

    Some features are maybe merged

    • Formatted Code
    • Grunt inline for some css and js - less requests
    • Icon font with only needed icons
    • Upgrade to grunt v1.x (NodeJS 6.2+ compatible)
      • Inline some css and js
    • Bower update all components
      • Load only german locale from 101 languages from moment.js
    • Right click open layermenu
    • Remove ruby dependency
    • FixedCenter is required

    Screenshots

    TODO new uptodate images

    Dependencies

    • npm
    • bower
    • grunt-cli

    Installing dependencies

    Install npm package-manager. On Debian-like systems run:

    sudo apt-get install npm

    Execute these commands on your server as a normal user to prepare the dependencies:

    git clone https://github.com/ffrgb/meshviewer.git
    cd meshviewer
    npm install
    npm install grunt-cli

    Building

    Just run the following command from the meshviewer directory:

    node_modules/.bin/grunt

    This will generate build/ containing all required files.

    Development

    Use grunt serve for development.

    Configure

    Copy config.json.example to build/config.json and change it to match your community.

    dataPath (string/array)

    dataPath can be either a string containing the address of a Nodes.json v2 compatible backend (e.g. ffmap backend) or an array containing multiple addresses. Don't forget the trailing slash! Also, proxying the data through a webserver will allow GZip and thus will greatly reduce bandwidth consumption. It may help with firewall problems too.

    siteName (string)

    Change this to match your communities' name. It will be used in various places.

    mapSigmaScale (float)

    This affects the initial scale of the map. Greater values will show a larger area. Values like 1.0 and 0.5 might be good choices.

    showContact (bool)

    Setting this to false will hide contact information for nodes.

    maxAge (integer)

    Nodes being online for less than maxAge days are considered "new". Likewise, nodes being offline for more than than maxAge days are considered "lost".

    mapLayers (List)

    A list of objects describing map layers. Each object has at least name property and optionally url and config properties. If no url is supplied name is assumed to name a Leaflet-provider.

    fixedCenter (array, optional)

    This option allows to fix the map at one specific coordinate depending on following case-sensitive parameters:

    • lat latitude of the center point
    • lng longitude of the center point
    • radius visible radius around the center in km

    Examples for fixedCenter:

    "fixedCenter": {
      "lat": 50.80,
      "lng": 12.07,
      "radius": 30
    }

    nodeInfos (array, optional)

    This option allows to show node statistics depending on following case-sensitive parameters:

    • name caption of statistics segment in infobox
    • href absolute or relative URL to statistics image
    • thumbnail absolute or relative URL to thumbnail image, can be the same like href
    • caption is shown, if thumbnail is not present (no thumbnail in infobox)

    To insert current node-id in either href, thumbnail or caption you can use the case-sensitive template string {NODE_ID}.

    Examples for nodeInfos:

    "nodeInfos": [
    
      { "name": "Clientstatistik",
        "href": "stats/dashboard/db/node-byid?var-nodeid={NODE_ID}",
        "thumbnail": "stats/render/dashboard-solo/db/node-byid?panelId=1&fullscreen&theme=light&width=600&height=300&var-nodeid={NODE_ID}",
        "caption": "Knoten {NODE_ID}"
      },
      { "name": "Uptime",
        "href": "stats/dashboard/db/node-byid?var-nodeid={NODE_ID}",
        "thumbnail": "stats/render/dashboard-solo/db/node-byid?panelId=2&fullscreen&theme=light&width=600&height=300&var-nodeid={NODE_ID}",
        "caption": "Knoten {NODE_ID}"
      }
    ]

    In order to have statistics images available, you have to set up an instance of each Prometheus and Grafana.

    globalInfos (array, optional)

    This option allows to show global statistics on statistics page depending on following case-sensitive parameters:

    • name caption of statistics segment in infobox
    • href absolute or relative URL to statistics image
    • thumbnail absolute or relative URL to thumbnail image, can be the same like href
    • caption is shown, if thumbnail is not present (no thumbnail in infobox)

    In contrast to nodeInfos there is no template substitution in href, thumbnail or caption.

    Examples for globalInfos using Grafana server rendering:

    "globalInfos": [
      { "name": "Wochenstatistik",
        "href": "stats/render/render/dashboard-solo/db/global?panelId=1&fullscreen&theme=light&width=600&height=300",
        "thumbnail": "nodes/globalGraph.png",
        "caption": "Bild mit Wochenstatistik"
      }
    ]

    linkInfos (array, optional)

    This option allows to show link statistics depending on the following case-sensitive parameters:

    • name caption of statistics segment in infobox
    • href absolute or relative URL to statistics image
    • thumbnail absolute or relative URL to thumbnail image, can be the same like href
    • caption is shown, if thumbnail is not present (no thumbnail in infobox)

    To insert the source or target node-id in either href, thumbnail or caption you can use the case-sensitive template strings {SOURCE} and {TARGET}.

    "linkInfos": [
      { "href": "stats/dashboard/db/links?var-source={SOURCE}&var-target={TARGET}",
        "thumbnail": "stats/render/dashboard-solo/db/links?panelId=1&fullscreen&theme=light&width=800&height=600&var-source={SOURCE}&var-target={TARGET}"
      }
    ]

    siteNames (array, optional)

    In this array name definitions for site statistics and node info can be saved. This requires one object for each site code. This object must contain:

    • site the site code
    • name the defined written name for this site code

    If neither siteNames nor showSites are set, site statistics and node info won't be displayed

    Example for siteNames:

    "siteNames": [
      { "site": "ffhl", "name": "Lübeck" },
      { "site": "ffeh", "name": "Entenhausen" ),
      { "site": "ffgt", "name": "Gothamcity" },
      { "site": "ffal", "name": "Atlantis" }
    ]