{"id":13830515,"url":"https://github.com/asimhsidd/MMM-TracCar","last_synced_at":"2025-07-09T11:33:19.589Z","repository":{"id":217324846,"uuid":"131950100","full_name":"asimhsidd/MMM-TracCar","owner":"asimhsidd","description":"A MagicMirror module for tracking moving objects through Traccar.org APIs.","archived":false,"fork":false,"pushed_at":"2018-12-05T11:05:01.000Z","size":43,"stargazers_count":10,"open_issues_count":1,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-04T10:03:16.464Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/asimhsidd.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}},"created_at":"2018-05-03T06:15:46.000Z","updated_at":"2023-09-01T16:17:42.000Z","dependencies_parsed_at":"2024-01-15T19:43:58.639Z","dependency_job_id":"92aa220c-6c61-4355-9f9a-3ba7b3924482","html_url":"https://github.com/asimhsidd/MMM-TracCar","commit_stats":null,"previous_names":["asimhsidd/mmm-traccar"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asimhsidd%2FMMM-TracCar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asimhsidd%2FMMM-TracCar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asimhsidd%2FMMM-TracCar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asimhsidd%2FMMM-TracCar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asimhsidd","download_url":"https://codeload.github.com/asimhsidd/MMM-TracCar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225539423,"owners_count":17485326,"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":[],"created_at":"2024-08-04T10:01:01.356Z","updated_at":"2024-11-20T11:30:53.203Z","avatar_url":"https://github.com/asimhsidd.png","language":"JavaScript","funding_links":[],"categories":["Travel"],"sub_categories":[],"readme":"# MMM-TracCar\nA [MagicMirror²](https://github.com/MichMich/MagicMirror/) module for tracking moving objects through [Traccar.org](http://www.traccar.org) on a map. A single map (default size: 300x400, can be changed through config settings) is built inside the module, no iframe is used. The best position is bottom left, although it depends upon the user. The map may have nice rounded and shadow borders which adds a nice aesthetic sense to the overall MM. All these settings are adjustable through config settings.\n\nThis module is based upon Traccar.org so you must have their server running (you may use their free servers too, if you are  okay with your location saved on their server). For the maps, this module uses Google Maps API. It takes Traccar.org login credentials, server url and Google Maps API key as configuration input.\n\nUpon load, the model initiates contact with the Traccar.org server using HTTP Request. Once contact is successful, it extracts information regarding all the devices that are listed on the server for constant location updates. Then the module formulate a socket connection with the Traccar.org server to receive real-time location updates as and when they are received from the respective devices. Each device is then shown on the map as an individual marker (green for online, red for offline devices) with the respective device name in the popup above each marker. These markers are moved on the map as location updates are received i.e. when a respective device is moving.\n\nThe module is built with error handling procedures where it attempts to reconnect with the server after every 15 seconds.\n\n![picture](Capture.JPG)\n\n## Using the module\n\n* Navigate to the modules directory via the follow command: `cd MagicMirror/modules`\n* Clone the module from github: `git clone https://github.com/asimhsidd/MMM-TracCar.git`\n* Navigate to the MMM-TracCar directory: `cd MMM-TracCar`\n* Install the dependencies: `npm install`\n* Add the following configuration to the modules array in the `config/config.js` file:\n```js\n    modules: [\n        {\n\t\t\tmodule: 'MMM-TracCar',\n\t\t\tposition: 'top_left',\n\t\t\tconfig: {\n\t\t\t\turl: \"\", // Traccar Server URL (free server @ http://demo5.traccar.org )\n\t\t\t\tusername: \"\", // Traccar Account username (email) (btw, there is a free account option too!) :)\n\t\t\t\tpass: \"\", // Traccar Account Password\n\t\t\t\tgmapid: \"\", // Google Apps key\n\t\t\t\tmap_width: \"300\", // width of the map element\n\t\t\t\tmap_height: \"400\", // height of the map element\n\t\t\t\tmap_border_radius: \"10\", // border radius of the map element (optional)\n\t\t\t\tmap_zoom: \"15\", // zoom level of the map (optional)\n\t\t\t\tmap_shadow_color: \"POWDERBLUE\", // shadow color of the border element (optional)\n\t\t\t}\n        }\n    ]\n```\n\n## Configuration options for MMM-TracCar\n\n| Option    \t| Required? | Description |\n|:------------- |:--------- |:----------- |\n| `position`\t| :red_circle: | The position of the screencast window. \u003cbr\u003e**Options:** `['bottomRight', 'bottomCenter', 'bottomLeft', 'center',  'topRight', 'topCenter', 'topLeft']` \u003cbr\u003e**Type:** `string` \u003cbr\u003e**Note:** This module config actual sets the location, not the magic mirror position config. |\n| `url`  \t| :red_circle: | The URL of the [Traccar Server](https://www.traccar.org/demo-server/) |\n| `username`   \t| :red_circle: | Your Traccar Username (email) |\n| `pass`   \t| :red_circle: | Your Traccar Password |\n| `gmapid`   \t| :red_circle: | Your Google API key |\n| `map_width`   \t| :red_circle: | The Width of the map element |\n| `map_height`   \t| :red_circle: | The Height of the map element |\n| `map_border_radius`   | :white_circle: | The Border radius of the map element |\n| `map_zoom`   | :white_circle: | The Zoom level of the map element |\n| `map_shadow_color`   \t| :white_circle: | The Shadow color of the border element |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasimhsidd%2FMMM-TracCar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasimhsidd%2FMMM-TracCar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasimhsidd%2FMMM-TracCar/lists"}