Giter VIP home page Giter VIP logo

freetakserver's Introduction

FreeTAKServer

the Parrot is not dead

Welcome to the FreeTakServer (FTS) git repository.

FTS is a Python3 implementation of the TAK Server for devices like CivTAK , WinTAK and ITAK, it is cross-platform and is only dependent on python stdlib libraries. We use the Flask framework for web services. it's free and open source (released under the Eclipse Public License).

Use cases

FTS allows you to connect ATAK clients to share geo information, to chat with all the connected clients, exchange files and more. It intends to support all the major use cases of the original TAK server. the domain model with all the know objects used by CIVTAK/ wintak

Community

This code is currently in BETA STAGE Check out our roadmap @ FreeTakServer#25 to see what is planned If you have any issues don't hesitate to bring it up https://github.com/Tapawingo/FreeTakServer/issues, as TAKFreeServer is still in the early stages of development.

Public instance

we support a public instance of FTS.

Tell us what you think!

to discuss with the developer team Use the reddit server https://www.reddit.com/r/ATAK/ and the Discord chat https://discordapp.com/invite/XEPyhHA

Architecture

TAKFreeServer uses a MVC pattern, the concept of a COT is described in a set of Domain classes, generated from the UML model using a Model Driven Architecture approach. the domain model with all the know objects used by CIVTAK/ wintak The target architecture supports also the ability to implement "plugins", thanks to a listener, that is decouple from the main server the FreeTakServer component model

Documentation

under docs, you can find various documents including an UMl model of the model classes involved in a COT event.

Requirements

  • Python 3.6 (or better)

Installing and using FreeTakServer

Prerequisites

  • Install Python3
  sudo apt update && sudo apt install python3 && sudo apt install pip3` (Ubuntu)```

install FreeTakServer

Since version 0.8, FTS supports Pip installation, manual installation can be done with some modifications of the import paths, however we don't support it

  pip install FreeTAKServer

Optional: check if installation is correctly executed

pip check FreeTakServer 

note under windows it's installed under

C:\Users\user.name\AppData\Local\Programs\Python\PythonXX\Lib\site-packages

Run FreeTakServer

Linux

Run Server in console

sudo  python3 -m FreeTAKServer.controllers.Orchestrator -IP (yourIP)

this will start the server with Port 8087 and API port 8080 on the IP defined in [yourIP] to change that you can use

sudo python -m FreeTAKServer.controllers.Orchestrator -CoTPort 8099 -IP 192.127.1.1 -APIPort 9999

run the above command with

-h

to get a list of other supported commands

Run Server as Demon

sudo nohup python3 -m FreeTAKServer.controllers.Orchestrator -IP (yourIP) &

Windows

go to the start menu and type cmd to start a command prompt open a console with admin rights

python3 -m FreeTAKServer.controllers.Orchestrator -IP (yourIP)

Troubleshooting

if, trying to start FTS you get an error 'package not found'

'package not found'

navigate to the physical location where the controllers are installed and start the server from there

Update FreeTakServer

if you already installed FTS with pip you can use

pip install FreeTAKServer --upgrade

Project Structure

  • TakFreeServer
    • Controllers: Contains all the business Logic
    • Models: Contains all the COT object model
    • TAKLinuxService: a demon for linux OS
    • TakWinService: a service for the windows OS
  • Docs: Usefull documentation regarding COTS and different logs to understand how those are implemented
  • Model: a UML model in Sparx EnterpriseArchitect format (see https://sparxsystems.com/products/ea/trial/request.html).
  • Old: Legacy versions

freetakserver's People

Contributors

benking84 avatar brothercorvo avatar joshuafuller avatar mfhdwt avatar naman108 avatar rcaudill avatar tapawingo avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.