Open main menu

Wikibooks β


< Celestia


What is Celestia?Edit

Celestia is a freely-distributed, multi-platform, open source software package that provides photo-realistic, real-time, three-dimensional viewing of the solar system, the galaxy and the universe. It has proved a valuable tool for astronomy education, and is used in homes, schools, museums and planetariums around the world. Versions are available for Windows, Macintosh (MacOS X) and Linux computers.

Where can I get more information about Celestia?Edit

The Celestia Website has some additional information about Celestia.

The Celestia Forum is a good place to look for or ask for additional information. You'll find lots of friendly people there.

The Celestia Motherlode has many Celestia resources.

Where can I get the most recent version of Celestia?Edit

You can download the latest version of Celestia (v1.6.1) from SourceForge.

Prerelease versions are announced in the Celestia Web Forum in its Users Forum.

What changes have been made to Celestia since the last version?Edit

The developers maintain a list of all new functionality and bug fixes in the Celestia ChangeLog, which is located at SourceForge (most recent changes listed at bottom).

Questions about how Celestia worksEdit

Celestia crashes, what it draws is messed up or it's extremely slow. What can I do?Edit

Celestia makes use of the most advanced features of OpenGL that your computer's graphics driver claims to support. Many older OpenGL implementations have serious bugs. Here are some options for improving Celestia's display, with the most likely ones first:

  1. Make sure full hardware acceleration is enabled in your display properties.
  2. Upgrade to the most recent drivers for your graphics card. Download them for free from the Web site of the manufacturer of your card, not from Microsoft.

Nvidia drivers can be downloaded from

ATI drivers can be downloaded from


  1. Graphics chipsets integrated into laptop systems usually require drivers provided by the manufacturer of the laptop itself. Too often proprietary "glue chips" prevent the chip vendor's drivers from working properly.
  2. Reduce or disable hardware acceleration to verify that the problem is hardware related.

Windows XPEdit

  1. Whenever you upgrade Microsoft's DirectX software, you must upgrade or reinstall the graphics hardware manufacturer's graphics drivers afterward. Installing DirectX installs Microsoft's copies of the drivers, which usually are several generations old.
  2. To disable hardware acceleration under Windows, open the "Display Properties" window. Select the "Settings/Advanced/Troubleshoot" tab. (not the "Troubleshoot..." button). Move the "Hardware acceleration" slider all the way to the left. Click on the "OK" buttons to change the settings in use. This will cause Windows to use Microsoft's Generic OpenGL v1.1 library, which is limited, but seems to have relatively few bugs. It does everything in software, works on 2D displays, and is quite slow.
  3. Driver Upgrade Procedure
    1. download driver installation program
    2. use the Control Panel / Add or Remove Programs menu to delete the current graphics drivers.
    3. Reboot
    4. Cancel out of XP's offer to install new drivers.
    5. Run the Installation program for the new drivers.
    6. Reboot
    7. Configure desktop resolution and other desirable features.
The two reboots are essential in order to cause the old low-level drivers to be deleted. Without those reboots, the old low-level drivers will not be deleted and the new installation will not work properly, although it may not generate any error messages.

MacOS XEdit

For Apple PPC and Intel computers running MacOS X, you must upgrade to the most recent version of the operating system. Updated drivers usually are not available separately.

Apple's OpenGL on MacOS X often has serious bugs which sometimes are not fixed in the most recent release of MacOS. You must report those problems to Apple, otherwise they will not get fixed.


For computers running Linux, you usually can download the drivers for free from the Web site of the manufacturer of your graphics card.

ATI's fglrx drivers for Linux often have serious bugs. Try to use the driver shipped with the most recent version of Xorg's X server software.

Celestia draws the Moon in shades of purple, blue and red. Why is it doing that and what can I do?Edit

Your graphics chipset and its drivers aren't drawing bumpmaps and normalmaps properly: their OpenGL routine "GL_ARB_vertex_program" is defective. (This is often seen with the newer Intel graphics chips.) Assuming you've already installed the most recent drivers,

  1. Download and install a different version of Celestia. The program is frequently revised.
  2. Turn off some of Celestia's advanced display features.
    1. Type a [Ctrl-V] several times to select "Basic" or "Multitexture" render paths instead of the OpenGL Vertex programs. This disables the use of vertex and shading programs temporarily. If this does improve things after you've followed the previous suggestions, then you need to do the next step:
    2. Tell Celestia to ignore specific features that your OpenGL library claims (falsely) to support. To do this, edit celestia.cfg. Remove the # that's in front of the line
IgnoreGLExtensions [ "GL_ARB_vertex_program" ]
Celestia's Help menu lists all of the routines in your system's OpenGL library. Add equivalent Ignore lines for other suspicious routines.

Addendum provided Tech Sgt. Chen:

Shut down all background programs on your system before running Celestia (i.e., antivirus software, multimedia software such as REAL Player, Musicmatch, etc.) Graphics programs are notorious for consuming system resources and even the best of graphics cards are better off without competing for those resources.

Celestia still crashes, draws funny stuff or is extremely slow. What can I do?Edit

Report the exact circumstances and details of your hardware and software in the "Celestia Bugs" forum. Celestia runs on many different hardware and software configurations. It is not appropriate to ask people to guess what you have. For example:

Problem: Celestia crashes when I look at Saturn with Ring Shadows enabled 
System: 256MB 1GHz Pentium 4, Windows 98 2nd ed 
Graphics: 128MB Radeon 9700, Catalyst 3.2, OpenGL v1.3.9088 
Program: Celestia v1.3.0 

Hopefully you know the System information. If you're running Windows, System details usually are available in the Control Panel's System Properties menu.

Some of the Graphics information can be found in Celestia's Help menu. If you're running Windows, more details can be found in the Control Panel's Display Properties menu.

Where can I get another version of Celestia that might work better?Edit

Older versions of Celestia are available on SourceForge v1.2.4 is extremely robust, but does not include many recent features.

"Prerelease" versions of Celestia for Windows often are available on Look in and The most recent "prerelease" (e.g. V1.5.0pre3 or later) may work for you, but may be even worse.

I want to see all possible Celestia eye candy. What kind of graphics card should I get?Edit

Cards based on Nvidia FX 5nnn, GF 6nnn, 7nnn, 8nnn or newer chipsets with 128MB of memory or more will show all of Celestia's eye candy. For example, an inexpensive FX 5200 will show all of the eye candy drawn by Celestia v1.3.2 and v1.4.0, althogh not as quickly as more expensive cards.

All other cards have limitations or problems when used with the current versions of Celestia.

  1. Any graphics card with drivers that support OpenGL v1.4 will show most, but not all, of the eye candy. (e.g. Nvidia GF4 Ti 4nnn series cards cannot show smooth shadow borders although it can show haze; No ATI Radeon cards can show haze or smooth shadow borders. The ATI limitations may be solved in Celestia v1.4.0 when it is finished.)
  2. Other cards work, too, but with various additional limitations. (e.g. Nvidia MX cards cannot show ring shadows cast on planets; ATI Rage cards cannot show specular highlights or bumpmap shadows.)
  3. Many graphics chipset designs, as well as Microsoft's OpenGL software, are limited to displaying Celestia's Basic and Multitexture "Render Paths". They can't display bumpmaps or specular reflections, for example.


Starting with Celestia v1.4.0, you will be able to see multiple shadows cast by multiple light sources if your card supports "GL_ARB_shading_language_100" and "GL_ARB_fragment_shader". These routines are part of the OpenGL V2.0 standard, but are included in the v66.nn and later ForceWare graphics drivers for Nvidia FX 5nnn and later cards. They also are included in the v4.nn and later Catalyst graphics drivers for ATI's Radeon 9500 cards and higher.

Starting with Celestia v1.3.2, improved eclipse and ring shadows are visible if your card has "GL_ARB_fragment_program" and uses floating point to do the graphics calculations. Unfortunately, Celestia v1.3.2 supports these features only on Nvidia FX 5nnn and GF 6nnn cards and not on any others.

In order for Celestia to be able to show bumpmap shadows and specular reflections, your card's OpenGL library must support OpenGL v1.4. In particular, it needs to include "GL_ARB_vertex_program".

As of February, 2004, only Nvidia and ATI have invested the effort in providing OpenGL v1.4 and later. The other graphics chip vendors have not yet upgraded their OpenGL libraries. However, Matrox Parhelia cards seem to have many of the necessary v1.4 features in their v1.3 libraries.

Note: The authors of Celestia only have cards with Nvidia graphics chips. Other types of cards sometimes have problems.

Sometimes when Celestia captures an image of its window, there's an ugly bright rectangle in the picture. How can I get rid of it?Edit

Sometimes a bright area is recorded where the file requestor menu or any other window overlaps Celestia's main window.

This bug seems to be fixed in Celestia v1.4.0 and later, which is available on SourceForge.

Here are some suggestions for minimizing this problem:

  1. Often the problem will go away if you toggle "Show Galaxies" off and on again before you take your snapshot. Either you can use the Render/View Options menu or you can type the letter "U" twice before you press "F10".
  2. Run Celestia in windowed mode, not full-screen. Drag the file requestor away from in front of the main window before you click on "Save".
  3. If your graphics card supports it, you can connect a secondary display. Some CRTs are very inexpensive. Drag the file requestor to the other screen.
  4. Use an external screen-dump command or program.

Windows includes a "print-screen" command. Under XP, you can use the keyboard combination Ctrl Print-Screen to write the screen image to the clipboard. You can then use any Paint program and Paste the image into it.

Sometimes a screenshot captured in Celestia will have multiple boxes around it, as if Multiview was on. How can I get rid of it?Edit

To make a good clean screenshot image, press [Ctrl + D] before you capture the image. This cancels Multiview.

(provided by ElPelado)

I can't turn off the Red/Green diamond in the center of the selected planets.Edit

You have to press Ctrl+k. Markers can be turned on and off in the "Render/View Options..." menu of Celestia v1.3.1 pre3 and later.

(provided by ElPelado)

Why won't the "Set Simulation Time" menu let me put in a date before 1752?Edit

This problem has been fixed in Celestia v1.4.1 and later, available on SourceForge: the Windows date/time input routine is no longer used.

September 1752 is when Great Britain and its colonies converted from the Julian calendar to the Gregorian calendar. This changed the day on which the new year started and also lost 11 days from that year.

Earlier versions of the Windows version of Celestia used Microsoft's date/time input routines. Microsoft didn't want to bother with the complexities of converting between Gregorian and Julian dates. This problem does not exist in the Linux version of Celestia.

I want to write some scripts for Celestia. How can I do it?Edit


Celestia includes a very simple scripting language of its own which understands commands like "go here, look there, set flag, display text". These commands should go into a file with the filetype .CEL

For more information see Celestia/Scripting

Questions about objects (not) seen in CelestiaEdit

Why are my favorite stars not in Celestia?Edit

Celestia v1.3.2 includes only stars that had their distances measured by the Hipparcos satellite. Hipparcos was not used to measure the distances to many dim, variable or close double stars. Someone may have created an Add-on that includes your stars, though. Or consider creating the necessary STC file yourself and contributing it.

More recent versions of Celestia include all of the stars within 20 LY of the Sun, as well as about 200 double stars. (There are actually many more double stars than that, but relatively few have had their orbital parameters accurately measured.)

The Sun and the Moon are much too small in Celestia. What's wrong?Edit

Their diameters are exactly right. As seen from the earth, they both are about a half-degree across. Celestia's window is about 45 degrees across, so the Sun and Moon are about 1% of that. They are drawn only 10 pixels wide if your screen is 1024x768.

Remember that your computer screen is only about 10-20 degrees wide in your own field of view. Celestia's 45 degree field provides a "wide angle" view of the sky. This makes objects look smaller than you might expect.

The apparent large size of the Sun and Moon as we see them in the sky is a psychological illusion. There are several different explanations for this. If you take a picture of the moon with a camera lens that has the same field of view as Celestia, you may be surprised at the small size of its image.

At least one book has been written about this effect: The Mystery of the Moon Illusion: Exploring Size Perception, by Helen Ross and Cornelis Plug. Review of their book

A simple experiment was suggested by "HarrieS", a guest on the Celestia forum:

Here is something you might try: a finger at arm's length is about two degrees wide for most people. That means that you can fit four moons side by side. Go outside and check it. Now have a direct look at your finger indoors. Can you still believe that four moons will fit on it?

And Dalle of the Forum wrote

But if your head is positioned e.g. 70 cm away from your e.g. 17" monitor, which measures 32 cm across (at least mine does), then the effective field of view looking at the Celestia sky "through" your monitor screen is 2*arctan((32/2)/70)) ~ 26 °. Hence, if you decrease the Celestia field-of-view to 26° you may get a more accurate appearence of what you would see looking out the window.

Celestia's galaxies are ugly, dim, grey blobs. How can I get colorful galaxies that look like the real things?Edit

The real things are dim, grey blobs. Your eyes are not sensitive to color at the very low light levels emitted by distant galaxies.

Many of the colorful pictures you're used to seeing are enhanced by long exposures on sensitive color film. Others are imaginative "false color" combinations of narrow-band CCD images designed to make visible the specific features of interest to the investigators. The colors of those pictures aren't realistic at all.

You can add a colorful object to Celestia by creating a 3DS model with appropriate images as surface textures. Define it as a Nebula in a DSC file. Use the Search command in the Celestia "Development" and "Add-On" forums to find examples.

Why are there no stars beyond about 16,000 light years? Why are there no stars in distant galaxies?Edit

Hipparcos could only measure parallax to a value of about 1 milli-arc-second. For details, please read the thread [1] Celestia currently has technical limitations which prevent it from drawing stars beyond a distance of about 16,000 LY from the sun.

On the second page of the thread mentioned above [2], Chris wrote about some of the tradeoffs in the current version of Celestia.

Sometimes the planets and moons are way far away from where their orbits are drawn. Why?Edit

To draw the orbits, Celestia only calculates 100 or so precise locations and then draws straight lines between them. If the orbiting body doesn't happen to be close to one of those 100 points, then it won't be very close to the line, either. The position of the orbiting body is calculated very accurately. The lines aren't.

Celestia only calculates a few points around the orbit in order to minimize the amount of computation needed between frames. The more calculations are required, the slower the frame rate is.

Starting with Celestia v1.3.2, you can specify the number of segments in an orbit track. Use your favorite text editor to modify the file celestia.cfg. Change the line

OrbitPathSamplePoints  100

Increase 100 to 500 or larger.

Why does the illumination level in Celestia not fall off the farther from the Sun I go - surely it should be very dark by the time I get to Pluto?Edit

The human eye can adapt to a very wide range of illuminations, so it wouldn't be as dark out there as you think - about the level of moderate indoor lighting, in which you can see very well. At the other end of the scale, your computer monitor is physically incapable of generating the brightness of illumination that pertains on the inner planets. Fortunately it doesn't need to, since all that would happen would be that your pupils would constrict to reduce the incoming light to a more comfortable level.

So in summary -

  1. There's no way Celestia can display "realistic" brightnesses on your computer screen; but
  2. such "realism" is unnecessary because your eyes merely adapt to compensate.

(Provided by Grant Hutchison)

When I try to capture a picture or movie, the image is stretched out of proportion.Edit

(Thanks to DaveMc for these tips!) Here are three things you can try...

  1. Check the OpenGL anti-aliasing setting of your graphics card. If it is on, try turning it off, or setting it to another option. This seems unrelated to the anti-aliasing setting inside of Celestia.
  2. Set your graphics card OpenGL options to "default".
  3. Get the most recent drivers for your graphics card.

(Provided by Don G.)

How can I make Celestia work like a planetarium? I want to see how the sky should look from my backyard.Edit

If you're running Celestia v1.3.0 or later

  1. Select the body from which to observe; e.g. type H then 3 to select Earth,
  2. Use the GoTo menu to specify your Longitude and Latitude and GoTo there (lat & long are entered in decimal format - there are websites that convert to/from degrees/minute/seconds format, such as this one,)
  3. Type y = Sync Orbit (this locks you into position above the location you set),
  4. Type (Windows:Ctrl-G) (Linux:Alt-S) = Goto Surface,
  5. Type (Windows:Ctrl-F) (Linux:Alt-F) = change Arrow keys to AltAzimuth mode (this keeps the horizon level when panning left & right),
  6. Use the arrow keys to look toward the sky, you can adjust the field of view (FOV - how much sky you see at once) with the , & . keys.

Unfortunately, there is not (yet) an alt-az coordinate system display, but typing a ; will turn on the equatorial coordinate system display. There are some scripts which add alt-az display, such as Planetarium.

Why can't I see Mir or Galileo? I know they're defined in Celestia.Edit

Set Celestia's simulation time to be when the spacecraft was in orbit. Celestia does not display spacecraft if they are not in orbit at the time of the simulation.

For example, Mir was launched on February 20, 1986, and reentered the Earth's atmosphere on March 23, 2001, at 05:55 GMT. Celestia will show Mir only if you set the time to be somewhere between those two dates.

This is controlled by Beginning and Ending directives in the definition of Mir in solarsys.ssc. If you remove those statements, Celestia will always draw Mir in orbit.

Addendum provided Tech Sgt. Chen:

Mir, along with certain other spacecraft models, were modeled within an historical time frame and can only be viewed between the mission start and end dates. You can override ending dates by opening the solarsys.ssc or other specific craft related .SSC files and placing a pound sign (#) in front of the ending date string. Then save the new setting. This way you can always view your installed Space Crafts. Consequently, removing the pound sign will return the craft to its natural time frame.

Positions on Mars are on the opposite side of the planet or bumps seem to be half a world away from the mountains or it's dark where it should be daylight. Why????Edit

You have a misaligned map.

Celestia requires that all maps have 0 degrees of longitude in the center, with 180 degrees of longitude at the edges. All of the surface texture image maps of all of the moons and planets that come with Celestia have this alignment.

In contrast, many maps of Mars were created with 0 degrees of longitude at the left and right edges, and with 180 degrees of longitude in the center. This includes the maps on in Fridger's "Texture Foundry".

Using a map with 0 at the edge would cause the symptoms you describe. You need to cut the map in half and exchange the halves or you need to find a map that's properly aligned.

My planet's rings are drawn as a featureless oval. It used to work. What's wrong?Edit

You need to use a smaller ring image, one that is no wider than your graphic card's OpenGL texture buffer.

To see how large your OpenGL texture buffer is, use Celestia's menu Help "OpenGL Info". Near the beginning it has a line that starts with "Max texture size:"

Older versions of Celestia scaled down large ring texture images so they'd fit into the smaller texture buffer of your OpenGL graphics driver. Celestia v1.3.1 and later no longer do that.

Some older cards, like 3dfx Voodoos, only have a 256 byte buffer. Modern cards have a 2K or 4K buffer. Microsoft's software version of OpenGL only has a 1K buffer.

Celestia's orbit for the ISS is out of date. How can I get a better one?Edit

The orbit of the International Space Station changes continuously in ways that are almost impossible to predict due to things like atmospheric drag, light pressure, cargo ship docking, etc. If you want an accurate orbit, you'll have to update it on a daily basis.

ISS TLEs (Two Line Elements) are posted to the AMSAT SAREX mailing list regularly by "Dave Larsen PhD". [3]

Here are the ISS TLE orbital parameters for August 16th, 2004:

   1 25544U 98067A   04229.23839543  .00019757  00000-0  15906-3 0  4532
   2 25544  51.6323  19.1941 0005251 117.9988 304.8582 15.70921896327755

Grant Hutchison has provided a spreadsheet to convert TLEs into Celestia SSCs[4]

Also, don't forget that Celestia models the shape of the Earth using a spheroid. The actual shape of our planet is much more complicated. As a result, a view from the Earth's surface in Celestia is not accurate enough to show the correct path across the sky of satellites in low Earth orbit like the ISS. Another issue is that Celestia v1.5.1 and earlier use a fixed rotation speed for the Earth. Since the Earth's rotation is variable, the surface of Celestia's Earth is displaced from where it should be. Celestia v1.6 will use a more accurate variable rotation speed. In other words, you can't use Celestia to find out where to look in the sky to see the ISS.

I have a previous version of Celestia with tons of addons, custom textures, etc. How can I update to the latest version without having to reinstall all of those addons, textures, etc?Edit

You can have more than one copy of Celestia on your system at the same time.

Rename the directory (folder) where you have Celestia now, maybe to Celestia131.

Verify that things still work: Double-click on the icon for Celestia131\Celestia.exe and look around in your universe.

Install the new copy of Celestia and tell it to use the directory Celestia. It'll create the folder again and install itself there.

Move your Addons at leisure.

Cel:// URLs run the copy of Celestia that is in the folder named Celestia. If you want to change back to using your old Celestia that way, just rename the directories again: rename Celestia to be Celestia132 and rename Celestia131 to be Celestia.

A description of how to organize your Addons so they can be moved easily.[5]

I've compared the Celestia texture for Venus/Ida/Miranda with one I've found in a book or on the Web, and Celestia's map is upside down. What's going on?Edit

Many sources for planetary maps (such as the USGS) use a mapping convention called "ecliptic north" - the north pole of any planet or asteroid is defined as being whichever rotational pole points north of the plane of the ecliptic (the plane of the Earth's orbit around the Sun). Each planet or asteroid can then be classified as a "direct" rotator, if it rotates in the same direction as the Earth when observed from above its north pole (i.e. counterclockwise); or as a "retrograde" rotator, if it rotates in the opposite direction.

But Celestia uses an equally valid mapping convention called "rotational north" - north is defined as being the pole around which the planet appears to rotate counterclockwise, irrespective of that pole's orientation relative to the ecliptic.

For direct rotators, this difference is irrelevant - "north" turns out to be the same direction in both mapping conventions. But for retrograde rotators, Celestia's north pole corresponds to ecliptic south - so you will find many maps of retrograde rotators like Venus, Ida and the moons of Uranus that appear to be upside down relative to those in Celestia. If you want to convert such maps for use in Celestia, you'll have to turn them through 180 degrees.

(Provided by Grant Hutchison)

What if I have more questions?Edit

If you have a question about Celestia that is not answered above or elsewhere in this WikiBook, please ask your question in the Celestia Web Forum, not here. There are many experts reading the Forum, but very few knowledgeable people read the WikiBook. If a question is asked more than once or twice in the Forum, it'll be added to this FAQ.