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