[![GoDoc](https://godoc.org/git.darknebu.la/Satellite/tle2json?status.svg)](https://godoc.org/git.darknebu.la/Satellite/tle2json) [![Go Report Card](https://goreportcard.com/badge/git.darknebu.la/Satellite/tle2json)](https://goreportcard.com/report/git.darknebu.la/Satellite/tle2json)
[![Build Status](https://drone.nbg1.emile.space/api/badges/Satellite/tle2json/status.svg)](https://drone.nbg1.emile.space/Satellite/tle2json)
# TLE2JSON

http api returning TLEs as json

## Setup

### Run the server

standalone:
`go run . -p <port>`

docker (selfbuilt):
```
$ docker build . -t tle2json
$ docker run -p <port extern>:8080 tle2json
```

docker (prebuilt image):
```
$ docker pull registry.darknebu.la/emile/tle2json:latest
$ docker run -p 8080:8080 registry.darknebu.la/emile/tle2json
```

### Populate the cache

By accessing the `/dumpall` endpoint, you can download all the TLEs populating
the cache. The next time the file containing the TLE needs to be accessed, it
doesn't need to be downloaded resulting in somwhat faster results.

![](imgs/out.png)

## Api endpoints

`/`
index, some examples

`/dumpall`
manually dump all the TLEs from [celestack](https://celestrak.com/NORAD/elements/) into the `data/` folder.

`/{category}/{name}`
dump a specific TLE