Stellarium is an open source desktop planetarium for Linux/Unix, Windows and MacOSX. It renders the skies in realtime using OpenGL, which means the skies will look exactly like what you see with your eyes, binoculars, or a small telescope. Stellarium is very simple to use, which is one of its biggest advantages: it can easily be used by beginners.

+

The Stellarium project was started by Fabien Chéreau during the summer of 2001 and uses Sourceforge intensively. Access the Sourceforge project page [http://sourceforge.net/projects/stellarium/ here].

+

+

===პროგრამა უფასოა?===

+

Yes! Stellarium is open source software. Anyone has the right to download and use the software for free, to distribute it without modifying to other people, or modify the source code, all of this under the terms of the [http://www.gnu.org/copyleft/gpl.html GNU General Public License (GPL)].

+

+

===როგორ შემიძლია ჩამოვტვირთო პროგრამა?===

+

Via the [[Download|download page]]. Stellarium is hosted on Sourceforge servers. After clicking on the right link of the download page, you will be taken to a list of Sourceforge servers, each with their location. Click on the file icon of the one geographically closest to you, it ensures a speedy download.

Your ideas and comments are invaluable to Stellarium. Have a look at [http://www.stellarium.org the homepage] to see where you can get personal support, ask for new features, report bugs and even submit your own patches.

+

+

==Stellarium - ჩადგმა==

+

+

===რა სისტემური მოთხოვნები აქვს პროგრამას?===

+

A graphics card capable of rendering OpenGL. A Riva TNT2, released in 1999 or 2000, should do. Stellarium is also fairly processor intensive, so you will get higher framerates with faster processors. Any reasonably recent computer should be able to run Stellarium. Furthermore your computer should be running a Linux, Windows or MacOSX operating system.

+

+

To give you an idea of what's possible, we've had success with these older computers:

*Mac PPC's back to about 667MHz, running at least OSX 10.3.9, any Mac Intel

+

+

===როგორ ჩავდგა პროგრამა?===

+

For Windows users, run the downloaded file &quot;setup.exe&quot; and follow the instructions.

+

For Linux users, the easiest is to find a pre-compiled package for your distribution.

+

But it is also possible to compile the program yourself: detailed compilation instructions for Linux, Posix, Cygwin and MacOSX are available in the &quot;INSTALL&quot; file. Mac OSX users should download the dmg file, double click on it to open, the application is contained inside, drag the application to your Applications folder.

+

+

===როგორ ამოვიღო პროგრამა?===

+

* For Windows users, uninstall Stellarium using the &quot;Add or Remove Programs&quot; applet in the Windows control panel.

+

* For Linux users, use your package manager if you installed a pre-compiled version.

+

* If you compiled yourself you can uninstall by typing "make uninstall" in the compilation directory.

+

* If you compiled yourself, ran make install as root afterwards, and removed the compilation directory

+

** First redownload (if necessary) and extract '''the source of the version that is installed'''

+

*** To see what version you've installed run: <code>stellarium --version</code>

+

** Then run: <code>./configure && sudo make uninstall</code>

+

+

==Stellarium პროგრამით სარგებლობა==

+

+

===როგორ დავიწყო პროგრამით სარგებლობა?===

+

<li>Set your location first! The default location is Paris, France. You can click on your location on the map in the configuration window, or enter coordinates manually. Don't forget to save the changes. Do that by clicking &quot;set as default&quot;. From now on, the sky will look exactly as it looks where you live when you run Stellarium. If you take Stellarium along on a trip with a laptop, you will need to adjust your location of course.</li>

+

<li>Use the mouse or arrow keys to look around.</li>

+

<li>Use the page up and page down keys to zoom in and out.</li>

+

<li>Use the left mouse button to select an object, the right button to deselect the object and middle mouse button or spacebar to center on the selected object.</li>

+

<li>Zooming on nebulas or planets is very interesting...</li>

+

<li>J slows down or reverses speed, L increases time speed, and K makes time return to normal speed.</li>

You are running Stellarium on one of those fancy widescreen laptops, and there is no option specifying your screen resolution in the menu. In that case, just open the config.ini file with a text editor, and find the screen_w and screen_h values. Set the numbers to the desired dimensions, save the file and restart Stellarium: enjoy the view!

+

+

===არსებობს სახელმძღვანელო?===

+

Yes. Find out everything you want to know about Stellarium, and the astronomic principles you see demonstrated in the program. Essential reading. [[:Category:User's_Guide|See here for more information]]

+

+

===როგორ მივუთითო თარიღი ღილაკებზე უამრავი დაწკაპვის გარეშე?===

+

You can type in a specific date using the text menu (also known as the Text User Interface, or TUI):

+

#Press the '''m''' key to bring up the TUI.

+

#Use the cursor keys to navigate to item '''2.1 Sky Time'''.

+

#Use the left/right cursor to highlight the year/month/day/hour which you wish to change.

+

#You can increment or decrement the value using the up/down cursors, or

+

#Type in the required value

+

#Press RETURN or ESC to go back to selecting TUI menu items if you want to change another setting, or simply press '''m''' to close the TUI.

+

Note: in version 0.9.1 there is a known bug meaning it is not possible to select years before 1 A.D. We're working on it.

+

+

==მორგება==

+

+

===როგორ გამოვიყენო ხომლთა სხვა ნახატები?===

+

Want to use other drawings than the ones included in Stellarium, like your own drawings, or antique drawings from the Uranographia?

+

+

You will need to change the constellation textures, and possibly adjust their coordinates in the constellationsart.fab file.

+

If they're not burdened by restrictive copyrights, you can share the set you made with the rest of the community.

+

+

===შესაძლებელია სხვა ვარსკვლავების ჩვენებაც?===

+

Stellarium uses the Hipparcos catalog, which contains over 120000 stars. It is currently not possible to use other star catalogs. Additional stars allowed in Stellarium may be found at the sourceforge download site:

Starting from version 0.8.0, Stellarium can be tailored to show your language. Settings are in the preferences window, or in the config.ini file. It is possible that the translation isn't complete yet, so we would be grateful if the talented translators among the Stellarium users would contribute to the translations. Info about the process is on the [[Translation_using_gettext|translation page]].

+

+

==პრობლემები==

+

+

===ვერ ვახერხებ პროგრამის ჩადგმას.===

+

Read the installation instructions contained in the &quot;INSTALL&quot; file, which comes with Stellarium.

+

+

===ჩადგმა მოხერხდა, მაგრამ პროგრამა არ იხსნება===

+

'''0.9.0 / OSX''' If you have upgraded from an older version of Stellarium, and your old config.ini file was set so that Stellarium started in full screen mode, 0.9.0 will fail to start. Just edit your config.ini file and edit the line with the fullscreen setting so the value is false.

+

+

For other problems, we can offer some accounts of what people experienced in the past. Maybe a file necessary for Stellarium was corrupted or badly formatted in some way. Try reinstalling, don't forget to backup any Stellarium files you might have customized.

+

+

Stellarium reports basic actions on standard output and standard error. This output can be read in the cmd window on Windows, or can be seen by starting Stellarium from a terminal in Linux and OS X. Have a read of this output and see if there is any helpful information. If you can't fix your problem, post a support request, and include this output.

+

+

====კონსოლოს გზავნილი, "locale::facet::_S_create_c_locale name not valid"====

+

If stellarium does not start, and you see this message on the console:

+

terminate called after throwing an instance of 'std::runtime_error'

+

what(): locale::facet::_S_create_c_locale name not valid

+

Abort trap

+

+

Try setting the LC_ALL environment variable to "C" and re-run.

+

+

===ასახვა და კადრების ცვლა ძალიან ნელია ჩემს კომპიუტერზე===

+

This happens when hardware rendering is disabled. If you have a 3D video card, make sure that your OpenGL drivers are installed and up to date.

+

+

===პროგრამა ითიშება გარკვეული დროით მუშაობის შემდეგ===

+

Stellarium is pretty processor intensive. This means things can get quite warm inside your computer. If you experience freezes or computer crashes, you might have a heat problem. If this is the case, other processor intensive tasks such as mp3 encoding should lead to the same problem. In the newest versions, a frame rate limiter is present. That should solve your problem.

+

+

===ზოგიერთი მთვარე მართებულ პოზიციებში არაა განთავსებული===

+

Currently we have no accurate ephemeris for Charon and no ephemeris for Neptunian satellites at all. The other satellite ephemeris should be correct. When you compare with what you see in your telescope you should enable light travel time compensation in config.ini.

+

+

===ჩემი ენის შრიფტი არ ჩანს===

+

Chances are your language is included, but the program doesn't include a font for your language, as we're concerned about download size. Find a font for your language, and tell the program which font to use in the config.ini file. See [[Display complex characters in Stellarium]] for more details.

+

+

===სიხშირეზე 60Hz პროგრამა სრულეკრანოვან რეჟიმში მუშაობს===

+

This is a bug in Windows XP. There are numerous fixes, and there is a small program available for it here (install at your own risk): (Search Google for 'RefreshLock').

+

+

===ჩემი ენისთვის თარგმანი დაუსრულებელი ან მცდარია===

+

Translations in Stellarium are a community effort, so it is possible that a local translator started the project, but never finished it, or didn't find help with some specific words. You can help us! Translation tips are on this page: [[Translation using gettext]]

Many GUI enhancement, theme engine and skinning programs for Windows can cause problems with OpenGL applications including Stellarium. Please try disabling these if you have them running: WindowBlinds, WindowFX, ObjectDock, IconPackager and Entbloess (and similar programs).

+

+

===ვერ ვახერხებ სცენარების ჩაწერას (Windows)===

+

Stellarium attempts to save a Stellarium script file (.sts) in your user directory. On international versions of Windows, this doesn't work perfectly yet, as the program is looking for the English "Documents and Settings" folder. Workaround: open the stderr.txt file in the Stellarium directory to see where Stellarium is trying to write, create that folder, and you should be able to record scripts now.

If you run WindowBlinds or another skinning/theme program, try de-activating it, or adding Stellarium to the list of applications which should be excluded.

+

+

===ვერ ვახერხებ ეკრანის ანაბეჭდების შენახვას (Windows Vista)===

+

Vista doesn't allow most user programs to write to the Desktop directory. You can choose another directory to save screenshots to by editing the shortcut in the start menu which is used to start Stellarium, like this:

+

+

stellarium.exe --screenshot-dir "C:\Path\To\Dir"

+

+

In future versions of Stellarium, the screenshot save directory will be a setting available via the GUI.

Probably. Please have a read of [https://sourceforge.net/forum/message.php?msg_id=4720018 this thread in the forums] which discusses the legal implications of using Stellarium screenshots. If you are embarking on a commercial venture, you should probably talk to a lawyer and/or your publisher about it.

+

+

==="წელი 0 არ არის", ან "წელთაღრიცხვამდე წლები ერთით ნაკლებია"===

+

Stellarium 0.9.1 and later uses [http://en.wikipedia.org/wiki/Astronomical_year_numbering astronomical year numbering].

+

+

The conventional BC/AD (or BCE/CE) scheme has no year 0 because at the time of it's creation, Europeans were widely ignorant of the concept of the number zero, thus the year before 1 AD is 1 BC. This makes arithmetic awkward, and for this reason astronomers often use a different scheme, referring to AD dates as a positive integer, and re-designating 1 BC/BCE as the year 0. Thus:

Stellarium is an open source desktop planetarium for Linux/Unix, Windows and MacOSX. It renders the skies in realtime using OpenGL, which means the skies will look exactly like what you see with your eyes, binoculars, or a small telescope. Stellarium is very simple to use, which is one of its biggest advantages: it can easily be used by beginners.
The Stellarium project was started by Fabien Chéreau during the summer of 2001 and uses Sourceforge intensively. Access the Sourceforge project page here.

Yes! Stellarium is open source software. Anyone has the right to download and use the software for free, to distribute it without modifying to other people, or modify the source code, all of this under the terms of the GNU General Public License (GPL).

Via the download page. Stellarium is hosted on Sourceforge servers. After clicking on the right link of the download page, you will be taken to a list of Sourceforge servers, each with their location. Click on the file icon of the one geographically closest to you, it ensures a speedy download.

A graphics card capable of rendering OpenGL. A Riva TNT2, released in 1999 or 2000, should do. Stellarium is also fairly processor intensive, so you will get higher framerates with faster processors. Any reasonably recent computer should be able to run Stellarium. Furthermore your computer should be running a Linux, Windows or MacOSX operating system.

To give you an idea of what's possible, we've had success with these older computers:

For Windows users, run the downloaded file "setup.exe" and follow the instructions.
For Linux users, the easiest is to find a pre-compiled package for your distribution.
But it is also possible to compile the program yourself: detailed compilation instructions for Linux, Posix, Cygwin and MacOSX are available in the "INSTALL" file. Mac OSX users should download the dmg file, double click on it to open, the application is contained inside, drag the application to your Applications folder.

Set your location first! The default location is Paris, France. You can click on your location on the map in the configuration window, or enter coordinates manually. Don't forget to save the changes. Do that by clicking "set as default". From now on, the sky will look exactly as it looks where you live when you run Stellarium. If you take Stellarium along on a trip with a laptop, you will need to adjust your location of course.</li>

Use the mouse or arrow keys to look around.</li>

Use the page up and page down keys to zoom in and out.</li>

Use the left mouse button to select an object, the right button to deselect the object and middle mouse button or spacebar to center on the selected object.</li>

Zooming on nebulas or planets is very interesting...</li>

J slows down or reverses speed, L increases time speed, and K makes time return to normal speed.</li>

You are running Stellarium on one of those fancy widescreen laptops, and there is no option specifying your screen resolution in the menu. In that case, just open the config.ini file with a text editor, and find the screen_w and screen_h values. Set the numbers to the desired dimensions, save the file and restart Stellarium: enjoy the view!

Want to use other drawings than the ones included in Stellarium, like your own drawings, or antique drawings from the Uranographia?

You will need to change the constellation textures, and possibly adjust their coordinates in the constellationsart.fab file.
If they're not burdened by restrictive copyrights, you can share the set you made with the rest of the community.

Starting from version 0.8.0, Stellarium can be tailored to show your language. Settings are in the preferences window, or in the config.ini file. It is possible that the translation isn't complete yet, so we would be grateful if the talented translators among the Stellarium users would contribute to the translations. Info about the process is on the translation page.

0.9.0 / OSX If you have upgraded from an older version of Stellarium, and your old config.ini file was set so that Stellarium started in full screen mode, 0.9.0 will fail to start. Just edit your config.ini file and edit the line with the fullscreen setting so the value is false.

For other problems, we can offer some accounts of what people experienced in the past. Maybe a file necessary for Stellarium was corrupted or badly formatted in some way. Try reinstalling, don't forget to backup any Stellarium files you might have customized.

Stellarium reports basic actions on standard output and standard error. This output can be read in the cmd window on Windows, or can be seen by starting Stellarium from a terminal in Linux and OS X. Have a read of this output and see if there is any helpful information. If you can't fix your problem, post a support request, and include this output.

[edit]კონსოლოს გზავნილი, "locale::facet::_S_create_c_locale name not valid"

If stellarium does not start, and you see this message on the console:

terminate called after throwing an instance of 'std::runtime_error'
what(): locale::facet::_S_create_c_locale name not valid
Abort trap

Stellarium is pretty processor intensive. This means things can get quite warm inside your computer. If you experience freezes or computer crashes, you might have a heat problem. If this is the case, other processor intensive tasks such as mp3 encoding should lead to the same problem. In the newest versions, a frame rate limiter is present. That should solve your problem.

Currently we have no accurate ephemeris for Charon and no ephemeris for Neptunian satellites at all. The other satellite ephemeris should be correct. When you compare with what you see in your telescope you should enable light travel time compensation in config.ini.

Chances are your language is included, but the program doesn't include a font for your language, as we're concerned about download size. Find a font for your language, and tell the program which font to use in the config.ini file. See Display complex characters in Stellarium for more details.

Translations in Stellarium are a community effort, so it is possible that a local translator started the project, but never finished it, or didn't find help with some specific words. You can help us! Translation tips are on this page: Translation using gettext

Many GUI enhancement, theme engine and skinning programs for Windows can cause problems with OpenGL applications including Stellarium. Please try disabling these if you have them running: WindowBlinds, WindowFX, ObjectDock, IconPackager and Entbloess (and similar programs).

Stellarium attempts to save a Stellarium script file (.sts) in your user directory. On international versions of Windows, this doesn't work perfectly yet, as the program is looking for the English "Documents and Settings" folder. Workaround: open the stderr.txt file in the Stellarium directory to see where Stellarium is trying to write, create that folder, and you should be able to record scripts now.

Vista doesn't allow most user programs to write to the Desktop directory. You can choose another directory to save screenshots to by editing the shortcut in the start menu which is used to start Stellarium, like this:

stellarium.exe --screenshot-dir "C:\Path\To\Dir"

In future versions of Stellarium, the screenshot save directory will be a setting available via the GUI.

Probably. Please have a read of this thread in the forums which discusses the legal implications of using Stellarium screenshots. If you are embarking on a commercial venture, you should probably talk to a lawyer and/or your publisher about it.

The conventional BC/AD (or BCE/CE) scheme has no year 0 because at the time of it's creation, Europeans were widely ignorant of the concept of the number zero, thus the year before 1 AD is 1 BC. This makes arithmetic awkward, and for this reason astronomers often use a different scheme, referring to AD dates as a positive integer, and re-designating 1 BC/BCE as the year 0. Thus: