From 95cc3d0e79aa30f1d957784b2b802e4c9f12ab87 Mon Sep 17 00:00:00 2001
From: Jeff Moe <moe@spacecruft.org>
Date: Sat, 21 May 2022 12:39:21 -0600
Subject: [PATCH] install/run stub

---
 README.md                            | 39 +++++++++++++++++++++++++++-
 extras/galileo-gnss/galileo-gnss.ssc |  3 ++-
 requirements.txt                     |  1 +
 tle2ssc                              | 10 +++++++
 4 files changed, 51 insertions(+), 2 deletions(-)
 create mode 100644 requirements.txt
 create mode 100755 tle2ssc

diff --git a/README.md b/README.md
index 650b40a..5e90bea 100644
--- a/README.md
+++ b/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.
diff --git a/extras/galileo-gnss/galileo-gnss.ssc b/extras/galileo-gnss/galileo-gnss.ssc
index fbbe362..e1f5bde 100644
--- a/extras/galileo-gnss/galileo-gnss.ssc
+++ b/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 {
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..f5434eb
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1 @@
+pyorbital
diff --git a/tle2ssc b/tle2ssc
new file mode 100755
index 0000000..2260066
--- /dev/null
+++ b/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