install/run stub

README.md

@@ -2,7 +2,7 @@
 Celestia is a "real-time space simulation that lets you experience our
 universe in three dimensions".
 
-It contains many celestial objects, but few that are man made, just
+It contains many celestial objects, but few that are man made, such
 as Hubble. It has a TLE for the ISS, but it doesn't update it.
 
 There is a spreadsheet that you can enter a TLE into it and it
@@ -127,11 +127,48 @@ cd blender-2.79b-linux-glibc219-x86_64
 ```
 
 Blender creates a new file on launch.
+
 Go to `File --> Import --> Wavefront (.obj)`.
+
 Import the file, such as `galileo.obj`.
+
 Go to `File --> Export --> 3D Studio (.3ds)`.
+
 Save the file, such as `galileo-gnss.3ds`.
 
+The `galileo-gnss.3ds` file created this way didn't render in Celestia. `:(`
+
+
+# Install celestia-gnss
+Install thusly.
+
+```
+git clone https://spacecruft.org/spacecruft/celestia-gnss
+cd celestia-gnss
+sudo apt update
+sudo apt install python3-pip
+# Many ways to do python setup, here is one:
+pip3 install --upgrade --user pip
+pip install --user -r requirements.txt
+```
+
+# Run celestia-gnss
+Run thusly.
+
+Convert a TLE, example:
+```
+./tle2ssc extras/galileo-gnss/galileo.txt
+```
+
+
+# Use in Celestia
+Then copy the satellites you want into your Celestia extras dir.
+Crufty bad way to do it, example:
+
+```
+sudo cp -a extras/galileo-gnss/ /usr/share/celestia/extras-standard/
+```
+
 
 # License / Copyright
 Upstream sources under their respective copyrights.

extras/galileo-gnss/galileo-gnss.ssc

@@ -1,6 +1,7 @@
 "2011-060A" "Sol/Earth" {
   Class "spacecraft"
-  # Mesh  
+# Fails to render
+#  Mesh "galileo-gnss.3ds"
   Radius  0.005
 
   EllipticalOrbit {

requirements.txt

@@ -0,0 +1 @@
+pyorbital

tle2ssc

@@ -0,0 +1,10 @@
+#!/usr/bin/python3
+# tle2ssc
+# Convert a TLE into an .ssc file for Celestia
+#
+# Usage:
+# tle2ssc [filename]
+# Example:
+# tle2ssc foo-tle.txt
+
+import pyorbital