celestia/README.md

# Celestia
Celestia is a "real-time space simulation that lets you experience
our universe in three dimensions".

![celestia-screenshot](pics/celestia-screenshot.png)

# Upstream
This repo is a lesser fork of the upstream project,
which has been revived.

* https://celestia.space/

* https://github.com/CelestiaProject/Celestia

See also: `README-upstream`, `README-upstream.md`.

## License/Copyright
GPLv2+

Copyright © 2001-2021, Celestia Development Team

# Debian
Package was removed from Debian in the ancient days due to bitrot.
The upstream code has a new team and active development, using
recent libraries. The package can be built under Debian Ok, except
for the `data/` files.

Debian upstream bug:

* https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=809916

```
Upstream has not produced any new releases in the last 4 years. In the
mean time, the package is accumulating bugs due to bitrot. It already
wasn't a trouble-free package, due to some quite important resources not
being DFSG compliant.
```

I do see some of the resources now are CC-by-SA 4.0, a license which
didn't exist when the Debian bug was created. So it may be that it
can be built happily without DFSG issues using new data files.


Celestia depending on NASA's Spice/NAIF may be afoul of Debian's
DFSG because the terms are unique. It isn't really a standard license.


Debian tracker link:

* https://tracker.debian.org/pkg/celestia

# Build
Mini Debian package build howto.

```
# Install deps
sudo apt update
sudo apt install build-essential ccache devscripts \
debhelper chrpath cmake freeglut3-dev libeigen3-dev libfmt-dev \
libfreetype6-dev libepoxy-dev libglu1-mesa-dev libgtk2.0-dev \
libgtkglext1-dev libjpeg62-turbo-dev libluajit-5.1-dev libpng-dev \
libqt5opengl5-dev libtheora-dev qtbase5-dev qtbase5-dev-tools

# Add ccache to PATH in ~/.bashrc, and log back in
PATH=/usr/lib/ccache:$PATH

# Make dirs to put it all, as it writes packages to the *parent* dir.
mkdir celestia-deb
cd celestia-deb

git clone https://spacecruft.org/spacecruft/CelestiaContent
cd CelestiaContent

# Build the source package, writes to parent dir
dpkg-buildpackage -rfakeroot -S -uc -us -sa

# Build Debian Packages
dpkg-buildpackage -rfakeroot -b -uc

cd ..

# Install the data package
sudo dpkg -i celestia-data_1.7.0~git20211202+668347e9+0_all.deb

# Make sure apt is happy
sudo apt -f install

git clone --recursive https://spacecruft.org/spacecruft/celestia
cd celestia

# Build the source package, writes to parent dir
dpkg-buildpackage -rfakeroot -S -uc -us -sa

# Build Debian Packages
dpkg-buildpackage -rfakeroot -b -uc

cd ..

# Install
sudo dpkg -i celestia_1.7.0~git20220520+1_all.deb \
 celestia-common_1.7.0~git20220520+1_all.deb \
 celestia-qt_1.7.0~git20220520+1_amd64.deb \
 celestia-tools_1.7.0~git20220520+1_amd64.deb \
 libcelestia1.7_1.7.0~git20220520+1_amd64.deb 

# Make sure apt is happy
sudo apt -f install

```