Real-time 3D visualization of space.
Switch branches/tags
Nothing to show
Clone or download
Alexell Merge branch 'pr/87' into main
Replaced website links.
Latest commit 80a1abb Aug 4, 2018
Permalink
Failed to load latest commit information.
admin replace _BSD_SOURCE with _DEFAULT_SOURCE Mar 12, 2018
catalogs Updated object catalogs Dec 4, 2017
config.tests Check for system installed eigen & glew Jul 29, 2018
data Updated object catalogs Dec 4, 2017
fonts Updated language files Nov 17, 2016
images Added demo CEL/CELX scripts for overlay & verbosity Apr 3, 2017
locale Updated language files Nov 17, 2016
macosx Include glew in the prefix header on the Mac. Cleaned up all the glew_h Aug 21, 2009
macros Adding macros directory to autoconf automatically and updating gconf m4 Jan 25, 2008
models add Makefile for models/ subdir Mar 12, 2018
po Updated all language files May 28, 2018
po2 update for newer automake Mar 12, 2018
scripts Add Cel command setwindowbordersvisible (Closes: #53) Jul 13, 2018
shaders Fix for #1864979 - ambient light may look incorrect in legacy arb sha… Sep 22, 2008
sounds Added demo CEL/CELX scripts and sounds Mar 20, 2017
src Merge branch 'pr/87' into main Aug 4, 2018
textures Updated object catalogs Dec 4, 2017
thirdparty fix eigen library to remove warnings Jan 12, 2018
ts Checkbox name without newline Jul 8, 2018
windows Fmod library removed from project. May 23, 2018
.dockerignore Basic linux build Dockerfile Sep 16, 2017
.gitignore update .gitignore Mar 12, 2018
ABOUT-NLS Adding file required by gettext Jul 19, 2005
AUTHORS Added Andrew to the AUTHORS file. Feb 13, 2009
COPYING Added standard UNIX package files. Apr 30, 2001
ChangeLog Preserve the 1.6.1 changes in the log. May 23, 2012
Dockerfile Basic linux build Dockerfile Sep 16, 2017
INSTALL Removed line that was accidentally left in. May 2, 2004
Makefile.am Replace celestia.vcproj with celestia.vcxproj in Makefile.am Nov 14, 2017
Makefile.cvs New build system Apr 14, 2003
NEWS Added standard UNIX package files. Apr 30, 2001
README Committed Nils Larsson's patch to enable Qt version to be executed fr… Mar 7, 2011
README.md Updated contributors list. May 17, 2018
TRANSLATORS - Added Galician translation by Xabier Cancela Apr 11, 2010
acinclude.m4 replace _BSD_SOURCE with _DEFAULT_SOURCE Mar 12, 2018
appveyor.yml AppVeyor config updated Sep 20, 2017
celestia.cfg Updated object catalogs Dec 4, 2017
celestia.iss Merged in changes to the Windows installer script from the 1.6.1 branch May 23, 2012
celestia.pro Merge pull request #84 from 375gnu/git-commit Aug 4, 2018
celestia.sln Changed output build directory for x84/x64 Apr 20, 2017
celestia.vcxproj Fmod library removed from project. May 23, 2018
celestia.vcxproj.filters Upgrade code for 64-bit build in Visual Studio. Apr 9, 2017
coding-standards.html Added a portability section. Jan 16, 2002
configure.ac fix for linux QT build Jul 8, 2018
controls.txt - Updated controls help file. Feb 15, 2009
demo.cel Improved display of text in demo Sep 22, 2002
depcomp depcomp for automake 1.6.1 May 3, 2002
devguide.txt Improved missing package recognition in Unix configure Feb 18, 2002
guide.cel Fixed some very out-of-date descriptions in the tour guide file. Firs… Jan 18, 2008
install-sh UNIX build-related files. Apr 30, 2001
missing UNIX build-related files. Apr 30, 2001
mkinstalldirs UNIX build-related files. Apr 30, 2001
splash.png Made the version textbox larger (PNG tEXt chunk) Mar 27, 2007
start.cel Added preloadtex command for Earth and Moon Jun 18, 2004
update_pot.sh Added script for generating celestia.pot template May 28, 2018
win32-installer-image.bmp Added splash image for InnoSetup install script. Mar 14, 2008

README.md

Release Localized License Contribute
GitHub release Localization License Contribute

Celestia

Celestia
A real-time space simulation that lets you experience our universe in three dimensions.

Copyright (c) 2001-2017, Celestia Development Team
Celestia web site: https://celestia.space
Celestia WikiBook: https://en.wikibooks.org/wiki/Celestia
Celestia forums: http://celestia.space/forum/

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details, which you should have received along with this program (filename: COPYING). If not, request a copy from: Free Software Foundation, Inc. 59 Temple Place - Suite 330 Boston, MA 02111-1307 USA

Getting started

Celestia will start up in a window, and if everything is working correctly, you'll see Earth in front of a field of stars. Displayed on-screen, is some information about your target (Earth), your speed, and the current time (Universal Time, so it'll probably be a few hours off from your computer's clock).

Right drag the mouse to orbit Earth and you might see the Moon and some familiar constellations. Left dragging the mouse changes your orientation also, but the camera rotates about its center instead of rotating around Earth. Rolling the mouse wheel will change your distance to Earth--you can move light years away, then roll the wheel in the opposite direction to get back to your starting location. If your mouse lacks a wheel, you can use the Home and End keys instead.

When running Celestia, you will usually have some object selected. Currently, it's Earth, but it could also be a star, moon, spacecraft, galaxy, or some other object. The simplest way to select an object is to click on it. Try clicking on a star to select it. The information about Earth is replaced with some details about the star. Press G (or use the Navigation menu), and you'll zoom through space toward the selected star. If you press G again, you'll approach the star even closer.

Press H to select our Sun, and then G to go back to our Sun. Right click on the sun to bring up a menu of planets and other objects in the solar system. After selecting a planet from the menu, hit G again to travel toward it. Once there, hold down the right mouse button and drag to orbit the planet.

The Tour Guide is a list of some of the more interesting objects you can visit in Celestia. Select the Tour Guide option in the Navigation menu to display the Tour Guide window. Choose a destination from the list, click the Goto button, and you're off.

That covers the very basics. For a more in-depth look at Celestia and the controls available to you, download the "Celestia User's Guide" (written by Frank Gregorio), available in several languages, from: https://celestia.space/guides.html This web page also includes links to the Celestia README file translated into Japanese.

Star browser

By default, the Star Browser window displays a table of the 100 nearest stars, along with their Distance, Apparent and Absolute Magnitude, and Type. Clicking on the column headers will sort the stars. The table is not continuously updated, so if you travel to another star, you should press the Refresh button to update the table for your current position. The radio buttons beneath the table let you switch between viewing a list of Nearest, Brightest, or 'With planets' stars. As with the solar system browser, clicking on any star name in the table will select it. Use this feature along with the Center and Go To buttons to tour the stars visible from any night sky in the galaxy.

Solar system browser

The Solar System Browser displays a window with a tree view of all the objects in the nearest solar system (if there is one within a light year of your current position.) Clicking on the name of any object in the window will select it.
You can then use the Center or Go To buttons to display that object in the main Celestia window.

Selecting objects by name

Celestia provides several ways to select an object by name...

  1. Choose 'Select Object' from the Navigation menu, type in the object name, and click OK.
  2. Press Enter, type in the entire object name, and press Enter again.
  3. Press Enter, type in the first few characters of the object name, press the Tab key to move through the displayed listing until the object is highlighted, then press Enter again.

You can use common names, Bayer designations or catalog numbers for stars. Celestia currently supports the HIP, HD and SAO catalogs. Catalog numbers must be entered with a space between the prefix and the catalog number.

Known issues

For up-to-the-minute answers to some common problems encountered when running Celestia, please view either the FAQ in the Help menu or take a look at the "Celestia User's FAQ" located on the Celestia User's Forum: https://celestia.space/forum/

User modifiable elements

You can modify how Celestia starts up each time you run it, by defining your own start-up settings. Simply open the file "start.cel" in a plain text editor and follow the in-file instructions. Also, view the celestia.cfg file in a plain text editor to see additional settings.

Celestia allows you to easily add real, hypothetical, or fictional objects by creating new catalog files. It is not recommended that you alter the built-in data files; nearly all desired modifications and additions can be made by placing new catalog files in Celestia's extras folders. There are three types of catalog files:

  • ssc (solar system catalog: planets, moons, spacecraft, etc.)
  • stc (star catalog)
  • dsc (deep sky catalog: galaxies, star clusters, and nebulae) All three types of catalog file are text files that can be updated with your favorite text editing program.

Contributions

Authors Contributors Documentation Other
Chris Laurel, Clint Weisbrod, Fridger Schrempp, Bob Ippolito, Christophe Teyssier, Hank Ramsey, Grant Hutchison, Pat Suwalski, Toti , Da Woon Jung, Vincent Giangiulio, Andrew Tribick Deon Ramsey, Christopher ANDRE, Colin Walters, Peter Chapman, James Holmes, Harald Schmidt, Sergey Leonov, Alexell, Dmitry Brant, Janus, Pirogronian, Hleb Valoshka Frank Gregorio, Hitoshi Suzuki, Christophe Teyssier, Diego Rodriguez, Don Goyette, Harald Schmidt Creators of scientific data base, texture maps, 3D models and used librarys, you can see in full README.

Contributing

We welcome feedback, bug reports, and pull requests!

For pull requests, please stick to the following guidelines:

  • Be sure to test your any code changes.
  • Follow the existing code style (e.g., indents).
  • Put a of comments into the code, if necessary.
  • Separate unrelated changes into multiple pull requests.