Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kylesayrs/atak_push_cots
Push Cursor on Target messages to TAK clients with attachments and other information
https://github.com/kylesayrs/atak_push_cots
android atak civtak wintak
Last synced: 2 days ago
JSON representation
Push Cursor on Target messages to TAK clients with attachments and other information
- Host: GitHub
- URL: https://github.com/kylesayrs/atak_push_cots
- Owner: kylesayrs
- License: mit
- Created: 2021-02-13T17:17:31.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-02T02:14:43.000Z (6 months ago)
- Last Synced: 2024-08-03T03:59:41.024Z (6 months ago)
- Topics: android, atak, civtak, wintak
- Language: Python
- Homepage:
- Size: 99.6 KB
- Stars: 33
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ATAK_push_cots
Push Cursor on Target messages to TAK clients with attachments and other information without requiring a TAK server.
## Background ##
The Android Tactical Awareness Kit (ATAK) is a software platform used to enable geospatial awareness and multiuser collaboration. ATAK was originally developed by the Air Force Research Laboratory (AFRL) and is now maintained by the TAK Product Center (TPC) as a civilian application. This package exists to allow the easy sharing of markers (CoTs) to users of ATAK and other CivTAK distributions exist such as iTAK (iOS) and WinTAK (Windows).A summary of the cursor on target schema (CoT) can be found [here](https://www.mitre.org/sites/default/files/pdf/09_4937.pdf).
For troubleshooting, create an issue or ask on the [reddit](https://www.reddit.com/r/ATAK/wiki/index) or [discord](https://discord.com/invite/xTdEcpc).
## Install ##
```bash
git clone https://github.com/kylesayrs/ATAK_push_cots
cd ATAK_push_cots
python3 -m pip install -e .
```## Usage ##
Pushing a standard CoT message can be done using the `push_cot` function
```python
from atakcots import CotConfig, push_cotcot_config = CotConfig(
uid="Message",
latitude=40.74931973338903,
longitude=-73.96791282024928
)
push_cot(cot_config, "192.168.0.2")
```Pushing CoTs which include attachments such as images must be done using `CotServer.push_cot`
```python
from atakcots import CotConfig, CotServercot_config = CotConfig(
uid="Message",
latitude=40.74931973338903,
longitude=-73.96791282024928,
attachment_paths="sandeot.png"
)
with CotServer("192.168.0.1", 8000) as server:
server.push_cot(cot_config, "192.168.0.2")
server.push_cot(cot_config, "192.168.0.3")
server.push_cot(cot_config, "192.168.0.4")# you should keep the context alive for as long as
# you want clients to fetch the attachments
```If you'd rather not use a context manager, you can use `start` and `stop` functions
```python
from atakcots import CotConfig, CotServercot_config = CotConfig(
uid="Message",
latitude=40.74931973338903,
longitude=-73.96791282024928,
attachment_paths="sandeot.png"
)server = CotServer("192.168.0.1", 8000)
server.start()server.push_cot(cot_config, "192.168.0.2")
server.push_cot(cot_config, "192.168.0.3")
server.push_cot(cot_config, "192.168.0.4")# stop when clients no longer need to fetch attachments
server.stop()
```See `examples` for more use cases.
## Feature requests ##
If you have any features or changes you'd like added to this repo, please create an issue and I'll make sure to implement/address it.