{"id":27733720,"url":"https://github.com/freetakteam/freetakhub","last_synced_at":"2025-08-01T06:03:07.147Z","repository":{"id":44092816,"uuid":"360186743","full_name":"FreeTAKTeam/FreeTAKHub","owner":"FreeTAKTeam","description":"the FreeTAKHub is a component to integrate FreeTAKServer with other systems. It's based on Node Red.","archived":false,"fork":false,"pushed_at":"2023-05-08T12:34:35.000Z","size":7813,"stargazers_count":24,"open_issues_count":6,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-28T12:59:51.275Z","etag":null,"topics":["freetakserver","fts","integration","javascript","node","node-red","tak"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FreeTAKTeam.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}},"created_at":"2021-04-21T13:46:47.000Z","updated_at":"2025-02-04T22:59:10.000Z","dependencies_parsed_at":"2023-01-27T14:45:33.702Z","dependency_job_id":null,"html_url":"https://github.com/FreeTAKTeam/FreeTAKHub","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeTAKTeam%2FFreeTAKHub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeTAKTeam%2FFreeTAKHub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeTAKTeam%2FFreeTAKHub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FreeTAKTeam%2FFreeTAKHub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FreeTAKTeam","download_url":"https://codeload.github.com/FreeTAKTeam/FreeTAKHub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251319599,"owners_count":21570426,"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":["freetakserver","fts","integration","javascript","node","node-red","tak"],"created_at":"2025-04-28T12:59:59.107Z","updated_at":"2025-04-28T13:00:01.897Z","avatar_url":"https://github.com/FreeTAKTeam.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# FreeTAKHub\n![OFFICIAL logo of  FTH to annoy the censors and hopefully spark some sort of controversy ](FTHLOGO3.png)\n\nthe different services of FTSHub will be moved in separate repository.\n\nWelcome to the FTH repository!\nthe FreeTAKHub is a component to integrate FreeTAKServer with other (non-TAK) systems. It's based on Node Red.\n\n## Services\n* World Wide Emergencies: connects to an external system, pull global EMS information and push periodically to FTS\n*  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.\n*  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. \n*  Video Server: a RTSP / RTPM capable server to stream in real time from / to TAK devices\n\n\n## Architecture\n![image](https://user-images.githubusercontent.com/60719165/125168213-ae368380-e17a-11eb-9b18-bf782f2d34bf.png)\nit's suggested to deploy each FTH integration on a separate node.\n\n## Installation\neach of the FTH component is a microservice that can be installed stand alone, with no dependency between erach other\n\n### FreeTAKServer configuration\nFreeTAKHub 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\n![image](https://user-images.githubusercontent.com/60719165/118305634-9f0ac080-b4be-11eb-8b0f-47344f7d2fc2.png)\n\n## WebMap Packaged\nplease see the updated [user docs](https://github.com/FreeTAKTeam/FreeTAKServer-User-Docs/blob/main/docs/docs/FreeTAKHub/WebMap/Installation.md)\n![webmap](https://user-images.githubusercontent.com/60719165/118400733-47449480-b639-11eb-8583-93e52cdcfb80.png)\n\n* the installation supports Ubuntu, other linuxes may work but they are not supported\n* Download the last webmap  [package](https://github.com/FreeTAKTeam/FreeTAKHub/releases/) in your filesystem, the file name has the following convention:\n* [SYSTEM]_[SERVICE]_[PLATFORM]_[MAJORVERSION]_[MINORVERSION]\n* e.g. FTH_WebMap_Ubuntu_1.8_RC2\n* open a terminal\n* navigate to your download dir\n* make the file executable\n```sudo chmod +x [package_name]```\n* edit the JSON file webMAP_config.json set the \n*   \"FTH_FTS_URL\": \"[YOUR_FTS_IP]\" \n  \"FTH_FTS_TCP_Port\": [YOUR_FTS_PORT]\n*  save the file\n*  in the console type:\n```\n./[package_name] /[PATHTOCONFIGURATIONFILE]/webMAP_config.json\n```\n* navigate to your IP:8000/tak-map \n* e.g. http://10.0.2.15:8000/tak-map\n\n### configuring FTS-UI for WebMAP\nthe webmap is a component that works standalone, since V. 1.8, the FTS UI supports it.\nin your FreeTAKServer-UI package, edit the config.py file and set the loaction of your webmap service.\n\n## Telegram Integration\n\n### Create telegram Robot\n* go to telegram and create a new bot with botfather\n* /newbot\n* set a name for the bot\n* **note the token for you bot** (if you forget it, you can styill ask botfather for it)\n* create a user name\n* register the API\n* Create a new telegram group\n* add the new created bot to the group\n* add the \"What's my Telegram ID?\" bot to the group\n* **note the ID of your group**\n* ensure that you bot has Groups enabled. In bot father type\n``` /setjoingroups```\n* turn off privacy\n### configure Telegram integration\n* download the installation package\n*  e.g. FTH_Telegram_Ubuntu_1.8_RC2.zip\n*  unzip the file\n* edit the JSON file TelegramTAK_config.json set the \n```  \n{\n\n  \"BOT_TOKEN\": \"[BotToken]\",\n  \"FTH_FTS_URL\": \"[YOURIP]\",\n  \"ChatId\": \"[ChatGroupid]\",\n  \"FTH_FTS_API_Auth\": \"[FTSAPIKey]\",\n  \"FTH_FTS_API_Port\": 19023,\n  \"FTH_FTS_TCP_Port\": 8087\n}\n ```\n*  save the file\n* open a terminal\n* navigate to your download dir\n* make the file executable\n```sudo chmod +x [package_name]```\n\n*  in the console type:\n```\n./[package_name] /[PATHTOCONFIGURATIONFILE]/TelegramTAK_config.json\n```\n## Video Server\n![image](https://user-images.githubusercontent.com/60719165/125315214-449aae80-e30d-11eb-9af0-a316dccbefd3.png)\n\nthe FreeTAKHub video server is a modified version of [mediamtx](https://github.com/aler9/rtsp-simple-server) formerly rtsp-simple-server.\nIt allow to connect a [drone](https://github.com/FreeTAKTeam/FreeTAKServer-User-Docs/blob/main/docs/docs/tools/FreeTAKUAS.md) or use tools such as [TAK ICU](https://github.com/FreeTAKTeam/FreeTAKServer-User-Docs/blob/442cbe7eccf1c026b28921ffc2cc759eb9908c6e/docs/docs/tools/takICU.md).\n\nThe modified version is not yet released because of stability issues. To install the standard version.\nDownload and extract a precompiled binary from the [release](https://github.com/aler9/mediamtx) page.\n\nStart the server:\n```\n./mediamtx\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreetakteam%2Ffreetakhub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreetakteam%2Ffreetakhub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreetakteam%2Ffreetakhub/lists"}