forestryailab / freetakhub

the FreeTAKHub is a component to integrate FreeTAKServer with other systems. It's based on Node Red.

FreeTAKHub

the different services of FTSHub will be moved in separate repository.

Welcome to the FTH repository! the FreeTAKHub is a component to integrate FreeTAKServer with other (non-TAK) systems. It's based on Node Red.

Services

• World Wide Emergencies: connects to an external system, pull global EMS information and push periodically to FTS
• TelegramTAK: Connects to FTS emergency and send a Telegram location and a message to a specific Telegram group chat. From a same chat, you can create an emergency OR send a regular chat to all in FTS.Finally you can also send an image to the group and this will be transformed into a Data Package into FTS.
• WebMap: Get the flow of COT from FTS and display on a web map (credit @ampledata#8354). The FTH WebMap integration can be installed as part of FTS UI or a stand alone, e.g. for a dashboard.
• Video Server: a RTSP / RTPM capable server to stream in real time from / to TAK devices

Architecture

it's suggested to deploy each FTH integration on a separate node.

Installation

each of the FTH component is a microservice that can be installed stand alone, with no dependency between erach other

FreeTAKServer configuration

FreeTAKHub uses FTS REST API. You will need to have a working FTS 1.8 or better, with the API service activated. On the FTS web UI you need to create a user and to assign a token

WebMap Packaged

please see the updated user docs

• the installation supports Ubuntu, other linuxes may work but they are not supported
• Download the last webmap package in your filesystem, the file name has the following convention:
• [SYSTEM][SERVICE][PLATFORM][MAJORVERSION][MINORVERSION]
• e.g. FTH_WebMap_Ubuntu_1.8_RC2
• open a terminal
• navigate to your download dir
• make the file executable sudo chmod +x [package_name]
• edit the JSON file webMAP_config.json set the
• "FTH_FTS_URL": "[YOUR_FTS_IP]" "FTH_FTS_TCP_Port": [YOUR_FTS_PORT]
• save the file
• in the console type:

./[package_name] /[PATHTOCONFIGURATIONFILE]/webMAP_config.json

• navigate to your IP:8000/tak-map
• e.g. http://10.0.2.15:8000/tak-map

configuring FTS-UI for WebMAP

the webmap is a component that works standalone, since V. 1.8, the FTS UI supports it. in your FreeTAKServer-UI package, edit the config.py file and set the loaction of your webmap service.

Telegram Integration

Create telegram Robot

• go to telegram and create a new bot with botfather
• /newbot
• set a name for the bot
• note the token for you bot (if you forget it, you can styill ask botfather for it)
• create a user name
• register the API
• Create a new telegram group
• add the new created bot to the group
• add the "What's my Telegram ID?" bot to the group
• note the ID of your group
• ensure that you bot has Groups enabled. In bot father type /setjoingroups
• turn off privacy

configure Telegram integration

• download the installation package
• e.g. FTH_Telegram_Ubuntu_1.8_RC2.zip
• unzip the file
• edit the JSON file TelegramTAK_config.json set the

{

  "BOT_TOKEN": "[BotToken]",
  "FTH_FTS_URL": "[YOURIP]",
  "ChatId": "[ChatGroupid]",
  "FTH_FTS_API_Auth": "[FTSAPIKey]",
  "FTH_FTS_API_Port": 19023,
  "FTH_FTS_TCP_Port": 8087
}

• save the file

• open a terminal

• navigate to your download dir

• make the file executable sudo chmod +x [package_name]

• in the console type:

./[package_name] /[PATHTOCONFIGURATIONFILE]/TelegramTAK_config.json

Video Server

the FreeTAKHub video server is a modified version of mediamtx formerly rtsp-simple-server. It allow to connect a drone or use tools such as TAK ICU.

The modified version is not yet released because of stability issues. To install the standard version. Download and extract a precompiled binary from the release page.

Start the server:

./mediamtx