diff --git a/README.md b/README.md index 04751df..851074f 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,63 @@ # satellite-server -Use raspberry pi imager to flash raspberry pi os lite (tested with 2022-01-28 release) +**Warning: This is still very much a work in progress** +The concept behind the satellite server is to have a central point to do satellite tracking. A raspberry pi acts as the server giving a browser view of satellite tracking. It also provides a central point for management of satellite TLE data. + +![overview](images/overview.png) + +# Basic Setup Instructions + +Use [Raspberry PI Imager](https://www.raspberrypi.com/software/) to flash Raspberry PI OS Lite (tested with 2022-01-28 release) + +Once the PI has booted you need to install the following dependencies: + +``` sudo apt-get update sudo apt-get install git sudo apt-get install python3-pip sudo apt-get install python3-numpy +``` + +Next up is cloning this repo and installing the python requirements +``` git clone https://github.com/tomvdb/satellite-server.git cd satellite-server pip install -r requirements.txt -python db_create.py - -configure qth coordinates +``` +Create initial database and configure you qth coordinates +``` +python db_create.py nano -w app/config.json +``` +You can now start the test server. + +``` python satserver.py +``` + +# Getting Started -add a satellite -iss - 25544 +Navigate your browser to http://:8080 -add satellite to default collection +To get started you need to add your first satellite. Browse to "Satellites" and click on "Add Satellite". You can now either enter all the details of the satellite into the form, or use the "Query Satnogs DB" section to enter a norad id. (For example the ISS is 25544. -tracking should now show up on homepag +Once you satellite is added you need to add it to a collection. Currently the "Default" Collection is what the main map uses. +Go back to the site home and your satellite will now show. You can select it to get more details and show the orbit and next pass. +# Rotator Control +This is still a work in progress, but essentially I have [Node-Red](https://nodered.org/) installed on the same pi. My flow contains a websocket component that listens for az/el requests. More information on this soon. + +# Radio Control + +Still working on this bit, but will be similar to rotator control. More information coming on this soon. # Credit -Satellite icons created by Freepik - Flaticon \ No newline at end of file +Polar Chart code is mostly from the [Satnogs System](https://satnogs.org/) + +Satellite icons created by Freepik - Flaticon