{"id":18402496,"url":"https://github.com/woodbri/vrm-gps-tracking","last_synced_at":"2026-05-02T02:38:15.119Z","repository":{"id":72553031,"uuid":"441790952","full_name":"woodbri/vrm-gps-tracking","owner":"woodbri","description":"GPS Tracking Application for VRM Installation","archived":false,"fork":false,"pushed_at":"2021-12-26T02:04:54.000Z","size":725,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T17:59:08.680Z","etag":null,"topics":["npm","openlayers5","vrm"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/woodbri.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2021-12-26T01:56:52.000Z","updated_at":"2021-12-26T02:04:57.000Z","dependencies_parsed_at":"2023-05-24T13:00:26.120Z","dependency_job_id":null,"html_url":"https://github.com/woodbri/vrm-gps-tracking","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodbri%2Fvrm-gps-tracking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodbri%2Fvrm-gps-tracking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodbri%2Fvrm-gps-tracking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/woodbri%2Fvrm-gps-tracking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/woodbri","download_url":"https://codeload.github.com/woodbri/vrm-gps-tracking/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248610387,"owners_count":21132920,"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":["npm","openlayers5","vrm"],"created_at":"2024-11-06T02:42:39.789Z","updated_at":"2026-05-02T02:38:15.039Z","avatar_url":"https://github.com/woodbri.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VRM GPS Tracking Application\n\n## What is it?\n\nThis is a simple mapping application that downloads the GPS tracks from\na VRM portal for an installation and displays them on a map alonf with the\ncurrent location.\n\n## Why Do I Care?\n\nIf you have a Victron GX monitoring device with a GPS attached in your RV, boat\nor other vehicle, and want to share your location with friends or family, then\nthis application does it.\n\n## How does it Work?\n\nThere is a ``index.php`` script that handles connecting to the VRM portal\nand downloading the current GPS information along with the track for some\nnumber of days in the past.\n\nEach installation that is connected to VRM allows monitoring and control of\nthat configuration via the VRM portal. Since you probably don't want people\ncontrolling your installation the script handles that and then emits an HTML\npage with just the GPS current info and the request GPS track. Obviously you\nneed to make sure you have proper protection on whatever system you host this\non.\n\n### Here is the VRM API Documentation\n\nhttps://docs.victronenergy.com/vrmapi/overview.html\n\n## How do I Install It?\n\nThis repository cantains an NPM project that uses OpenLayers web mapping\npackage displaying OpenStreetMap (OSM) map tiles. If you want to modify the\nproject you can install NPM and go for that, but if you just want to use\nthe existing project as is, then all you need to do is edit ``index.php``\nand copy the following file to a directory on your webserver.\n\n```\n// ****************** edit these for your configuration ****************\n// vrm info\n$installationID = '*****';\n$user = '******';\n$userID = '******';\n$pass = '******';\n$ptoken = '******';\n\n// set some defaults for the map in case we fail to reach vrm portal\n// I picked my home lat, lon\n$title = 'My Tracking Map Page';\n$lat = '42.902734';\n$lon = '-71.258601';\n$speed = 'unknown';\n$altitude = 'unknown';\n\n// default days in the past you want you track to show\n$days = 3;\n\n// ****** don't edit below this line unless you know what your doing ****\n```\n\nThen copy the following files to a directory in your webserver. For example, if you web ROOT is like ``/html/`` and you create a directory ``/trackmyrv/``, \nthen copy each of the files below into ``/html/trackmyrv/`` and you should be\nable to access the from a browser at: ``http://example.com/trackmyrv/index.php``.\nMake sure you have your webserver configured to run PHP.\n\n```\ndist/index.js.map\ndist/main.1f19ae8e.css.map\ndist/main.1f19ae8e.js.map\ndist/index.js\ndist/main.1f19ae8e.css\ndist/main.1f19ae8e.js\nindex.php\n```\n\n## Notes on vrm info above\n\nIf you are using the vrm portal, then the ``installationID`` is in your\nexisting url. Your ``user`` and ``pass`` are the same you use to login to\nthe portal. Getting ``ptoken`` is a little convoluted as in my case I have\n2 factor authentication turned on.\n\nI have included a ``token-tool.php`` that might be useful for testing\n connections to the VRM API and for getting a ptoken needed for ``index.php``.\n\nThis script has four steps where each step requires uncommenting that step \nand commenting out the other step can copying information from each step \nback into the script for the next step. At the end, you will end up with a\nptoken that can be used in index.php.\n\nHere is the VRM API documentation, but it took a few tries to figure it out\nhence the script.\n\nhttps://docs.victronenergy.com/vrmapi/overview.html\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoodbri%2Fvrm-gps-tracking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwoodbri%2Fvrm-gps-tracking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwoodbri%2Fvrm-gps-tracking/lists"}