Skip to content

Latest commit

 

History

History
43 lines (31 loc) · 1.59 KB

README.md

File metadata and controls

43 lines (31 loc) · 1.59 KB
Raw

Telegram Tracker Bot

A C++ Telegram bot for interfacing with a GPS tracker, using LibTelegram.

This is a standalone bot intended to be run on your own server with an individual GPS tracker.

Currently a work in progress.

Supported tracker models

  • TK103 / TK102B clones using the KX402 protocol.

Building

The quickest way to build the bot is using CMake:

  • mkdir build
  • cd build
  • cmake ..
  • make

A Code::Blocks workspace and project are also included for easy building.

Usage

You'll need a bot token for your bot from the BotFather.

  • Save the token in the telegramtrackerbot.conf config file, or provide it on the commandline with the --token option.
  • Optionally, set a custom port for the tracking server to bind to.
  • The --help commandline option provides help for other options.
  • You will then need to get your tracker to talk to your tracking server.

Configuring your tracker

The configuration below is for a TK103 / TK102B type tracker; they may need to be adapted to other types. Send the following SMS commands to your tracker to configure it for gprs mode and point it to your server:

  • reset123456
  • begin123456
  • apn123456 <apn name> <apn username> <apn password>
  • gprs123456
  • adminip123456 <ip of your server> <port of your server>
  • tracker123456

Enable tracking, in the example below with a 30 second interval. Use m and h for minutes and hours instead:

  • t030s***n123456

Minimum tracking period is 20 seconds.

TODO: Twilio integration to allow automatic tracker configuration