Built-in Plugins

From Stellarium Wiki
Revision as of 08:38, 15 August 2013 by Alexwolf (Talk | contribs)
Jump to: navigation, search
Information is actual for version 0.12.2

Since version 0.10.3, Stellarium's packages include a number of plug-ins: Angle Measure, Compass Marks, Oculars, Telescope Control, Text User Interface, Satellites, Solar System Editor, Time Zone, Historical Supernovae, Quasars, Pulsars, Exoplanets and Observability analysis. All these plug-ins are "built-in" in the standard Stellarium distribution and DON'T need to be downloaded separately.


Enabling plugins


To enable a plugin:

  1. Open the Configuration dialog (press F2 or use the left tool bar button)
  2. Select the Plugins tab
  3. Select the plugin you want to enable from the list
  4. Check the Load at startup option
  5. Restart Stellarium

If the plugin has configuration options, the configuration button will be enabled when the plugin is loaded and clicking it will open the plugin's configuration window.

Data for plugins

Some plugins contain files with different data, e.g. catalogs. JSON is a typical format for those files and you can edit it's manually. Of course, each plugin has specific format of data for the own catalogs and you should read documentation for plugin before editing of it catalog.

You can read some common instructions for editing catalogs of plugins below. In this example we use catalog.json file for identification of catalog for typical plugin.

You can modify the catalog.json files manually using a text editor. If you are using Windows, it is strongly recommended to use an advanced text editor such as Notepad++ to avoid problems with end-of-line characters. (It will also color the JSON code and make it easier to read.)

Warning: Before editing your catalog.json file, make a backup copy. Leaving out the smallest detail (such as a comma or forgetting to close a curly bracket) will prevent Stellarium from starting.

The path to the directory which contains catalog.json file is something like:

  • C:\Users\UserName\AppData\Roaming\Stellarium\modules\<Plugin name> (Windows Vista, Windows 7)
  • C:\Documents and Settings\UserName\Application Data\Stellarium\modules\<Plugin name> (Windows XP)
  • HomeDirectory/Library/Preferences/Stellarium/modules/<Plugin name> (Mac OS X)
  • ~/.stellarium/modules/<Plugin name> (Linux)

(Note that this is a hidden folder, so in order to find it you may need to change your computer's settings to display hidden files and folders.)

Angle Measure Plugin


The Angle Measure plugin is a small tool which is used to measure the angular distance between two points on the sky. *goes misty eyed* I recall measuring the size of the Cassini Division when I was a student. It was not the high academic glamor one might expect... It was cloudy... It was rainy... The observatory lab had some old scopes set up at one end, pointing at a photograph of Saturn at the other end of the lab. We measured. We calculated. We wished we were in Hawaii. A picture is worth a thousand words.

Using plugin

  1. Enable the tool by clicking the tool-bar button, or by pressing control-A. A message will appear at the bottom of the screen to tell you that the tool is active.
  2. Drag a line from the first point to the second point using the left mouse button
  3. To clear the measurement, click the right mouse button
  4. To deactivate the angle measure tool, press the tool-bar button again, or press control-A on the keyboard.

Plugin's home page


Compass Marks Plugin


Stellarium helps the user get their bearings using the cardinal point feature - the North, South, East and West markers on the horizon. Compass Marks takes this idea and extends it to add markings every few degrees along the horizon, and includes compass bearing values in degrees.

Using plugin

There is a tool bar button for toggling the compass markings, or you can press control-C.

Note that when you first enable compass marks, the cardinal points will be turned off. You can have both active at once, but there is a small bug which means you have to press Q two times to re-enable cardinal points after enabling the compass markings.

Plugin's home page


Text User Interface Plugin


Older versions of Stellarium used to have a little menu system which was controlled by the cursor keys. This was used primarily by planetarium system operators to change settings, run scripts and so on. In the 0.10.x series, this function vanished as we totally re-designed the user interface. This plugin re-implements the "TUI", as it was known.

Using plugin

  1. Activate the text menu using the M key
  2. Navigate the menu using the cursors keys.
  3. To edit a value, press the right cursor until the value you wish to change it highlighted with > and < marks, e.g. >3.142<. Then press the up and down cursors to change the value. You may also type in a new value with the other keys on th keyboard.

Plugin's home page


Personal tools
in this wiki
other languages