Configuration Window [F2]

The configuration window gives the user an interface to select general configuration options and access to scripts and plugins.


Under the Main tab, you can set your preferred language, the level of object Information details and save user settings or restore program defaults.


Select your preferred language from the drop down list.

Stellarium through the work of translator can be completely localized in any language. Currently, Stellarium is 100% translated to more than 10 languages, and partially available in many other languages. To know the level of translation to your language, check the Stellarium translation page in launchpad. You can also contribute to translating the software there.

Object Information

Object information can be presented in three levels: detailaed, summary or none.

Detailed information will display all information available about the object. 

Short information will display the type of the object and its coordinates.

None will not display any information about the selected object.

You can also specify what information to be displayed by selecting "customized" and pressing the "..." button to set the desired information through the next dialog:

Save Settings

The "Save settings" button will save all the settings of your current session. This includes the options selected in the "Sky and viewing" window and the options of the "Configuration" window and any other setting you performed like the field of view.

The "Restore Defaults" will restore the settings of Stellarium when it was first installed, like Paris for location, 60 ° for field of view, south for initial direction and Western for sky culture.



When you check the "Enable keyboard navigation",  you can use the keyboard arrow keys and PageUp and PageDown to pan the view or to zoom it. If you use shift+arrow keys or shift+page keys the movement or zooming will be slower.

 When you check the "Enable mouse navigation", you can use the left mouse button to drag the view in any direction and you can use the mouse wheel to zoom the view.

Startup Date and Time

You can let Stellarium starts with one of three Dates and Times:

- The system date and time which will be obtained from your computer clock
- A time you set and the system date 

 - A time and date you set. If you hit the "Use current" button the current system date and time will be used.


Mouse cursor timeout

You can also set the time after which the mouse cursor will be hidden if no action is performed. The default is 10 seconds.

Show flip buttons

You can have the flip buttons included in the horizontal bar by checking the "Show flip buttons" box. 

The flip buttons, will flip the view horizontally or vertically. This is to facilitate comparing what you see through a telescope which have the view flipped in a horizontal or vertical manner.

In addition to the buttons you can flip the image using  Ctrl+Shift+H  to flip horizontally and  Ctrl+Shift+V  to flip vertically.

Flip buttons included in the horizontal bar.


You can select the options used for planetarium projection, screenshots and extra star catalogs here. 

Planetarium Options

Spheric mirror distortion 

This option pre-warps the main view such that it may be projected onto a spherical mirror using a projector. The resulting image will be reflected up from the spherical mirror in such a way that it may be shown onto a small planetarium dome, making a cheap planetarium projection system. 

Current release 0.11.2 has this feature broken. A fix is under progress.

Disc Viewport

This option masks the main view producing the effect of a telescope
eyepeice. It is also useful when projecting Stellarium’s output with a fish-eye lens
planetarium projector.

Disc viewport with an effect of a telescope eyepiece

Disc viewport with fisheye projection - see Projections

Gravity labels

This option will display the labels of objects aligned to the nearest horizon. This way, labels are easier to read in a dome projection.

Select single constellation

When you enable display of constellation art or constellation lines, you can limit Stellarium to display only the constellation that you selected a star which defines one of its lines.

If you select a star that is not a member of any constellation line, all constellations lines or figures will be shown.

Auto zoom out return to initial direction

Using the key [\] after your zoom in, will zoom out to original field of view. If you enable this option, in addition to zoom out, the direction of view will return to original at the startup of Stellarium. See also Auto zoom.

You can find the direction of startup view under the Main tab in the configuration.

Screen shots

You can save a screenshot of the Stellarium view using Ctrl+S. The image will be saved in the location specified in the  screenshot directory. You can change this directory to another one using the folder button.

If you need to print your screenshot, it is better to enable the "invert colors" option. This will make the sky white while the stars will be black. This option will save your printer ink.

The folder button lets you select another screenshot directory

Extra Star Catalogs

Stellarium comes with 4 default catalogs that have around 600,000 stars up to magnitude 10.5.

You can download 5 more catalogs.

Catalog 5 has 1.7 million stars magnitude 10.5 to 12.
Catalog 6 has 7.7 million stars magnitude 12 to 13.5.
Catalog 7 has 26.6 million stars magnitude 13.5 to 15.
Catalog 8 has 57.8 million stars magnitude 15 to 16.5.
Catalog 9 has 116.9 million stars magnitude 16.5 to 18.


Under the scripts tab, you will find some scripts that were provided with Stellarium. Scripts are programs that automates execution of some user and program actions. To add scripts to Stellarium, install them in the script directory of the main program folder or in the Stellarium user directory.

To run the selected script press the run button under options. To stop the script press the stop button. If you want the configuration window closed when the scripts starts, check the "close window when script runs" box.

Additional scripts can be found in these links:


Plugins are additional features that can be enabled or disabled. The plugins will be discussed in details in the Plugins page.