Skip to content
A MagicMirror module for tracking moving objects through Traccar.org APIs.
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Capture.JPG Add files via upload May 3, 2018
LICENSE Initial commit May 3, 2018
MMM-TracCar.js Update MMM-TracCar.js Dec 5, 2018
README.md Update README.md Dec 5, 2018
node_helper.js Add files via upload May 3, 2018
package.json Add files via upload May 3, 2018

README.md

MMM-TracCar

A MagicMirror² module for tracking moving objects through 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.

This 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.

Upon 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.

The module is built with error handling procedures where it attempts to reconnect with the server after every 15 seconds.

picture

Using the module

  • Navigate to the modules directory via the follow command: cd MagicMirror/modules
  • Clone the module from github: git clone https://github.com/asimhsidd/MMM-TracCar.git
  • Navigate to the MMM-TracCar directory: cd MMM-TracCar
  • Install the dependencies: npm install
  • Add the following configuration to the modules array in the config/config.js file:
    modules: [
        {
			module: 'MMM-TracCar',
			position: 'top_left',
			config: {
				url: "", // Traccar Server URL (free server @ http://demo5.traccar.org )
				username: "", // Traccar Account username (email) (btw, there is a free account option too!) :)
				pass: "", // Traccar Account Password
				gmapid: "", // Google Apps key
				map_width: "300", // width of the map element
				map_height: "400", // height of the map element
				map_border_radius: "10", // border radius of the map element (optional)
				map_zoom: "15", // zoom level of the map (optional)
				map_shadow_color: "POWDERBLUE", // shadow color of the border element (optional)
			}
        }
    ]

Configuration options for MMM-TracCar

Option Required? Description
position 🔴 The position of the screencast window.
Options: ['bottomRight', 'bottomCenter', 'bottomLeft', 'center', 'topRight', 'topCenter', 'topLeft']
Type: string
Note: This module config actual sets the location, not the magic mirror position config.
url 🔴 The URL of the Traccar Server
username 🔴 Your Traccar Username (email)
pass 🔴 Your Traccar Password
gmapid 🔴 Your Google API key
map_width 🔴 The Width of the map element
map_height 🔴 The Height of the map element
map_border_radius ⚪️ The Border radius of the map element
map_zoom ⚪️ The Zoom level of the map element
map_shadow_color ⚪️ The Shadow color of the border element
You can’t perform that action at this time.