Need help with nmap-log-parse?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

131 Stars 8 Forks GNU Affero General Public License v3.0 80 Commits 1 Opened issues


Logs which devices are in your local network and draws graphs

Services available


Need anything else?

Contributors list

No Data


Logs which devices are in your local network and draws graphs




  1. Clone this repository and checkout the precompiled branch

    git clone
    cd nmap-log-parse
    git checkout gh-pages
  2. Add this line to your root crontab on your raspberry pi (or other device that is always on):

    */10 * * * * nmap -sn '192.168.178.*' -oX - >> /var/www/nmap-logs/$(date -I).xml

    You can edit the root crontab by running something like

    sudo EDITOR=nano crontab -e


    with your network range and
    with the target location.

    This takes about ~10MB of storage per month.

    The above command must be put into the root crontab! Otherwise, nmap can't read mac-addresses and the output will be wrong.

  3. create a

    file in the same folder as the built
    is in (dist), overriding any of the values in the default config.

    for example:


        "logFilesPath": "/nmap/logs/",
        "staticLogFiles": ["logs/oldlogs"],
        "deviceNames": {
            "AB:CD:EF:01:23": "John's PC"


    only if you have an undated log file from an older version.

    The logFilesPath is either relative to the root dirctory of the server (if starting with /) or the built index.html file (otherwise)

  4. Wait more than an hour. Make sure the first log file (in the form 2019-06-29.xml) exists and contains XML documents.

  5. Open

    in a browser. Open it from a server (like a minimal
    python3 -m http.server
    ) instead of from the filesystem because of Cross-Domain security.


Made with React, the Dexie.js database and Highcharts.

Get the dependencies using

yarn install
, then run
yarn build
to build the JS into the /dist directory. For development, run
yarn dev
to start the dev server.

This project is written in TypeScript, which is basically JavaScript (ES6), but strongly typed. I can recommend Visual Studio Code (on linux) for IntelliSense and Refactoring support.

If you have ideas to make this better please open an issue, or even better, send a pull request.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.