Configuration file

From Stellarium Wiki
(Difference between revisions)
Jump to: navigation, search
m (Section [search])
 
(78 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{ActualVersion|0.12.0}}
+
See [[Advanced_Use#The_Main_Configuration_File|Advanced Use, The Main Configuration File]] for information about this file, including its default installed location, name, and command line options that can effect how it is processed.
 +
 
 +
Deprecate parameters marked by gray background. Possible new parameters marked by yellow background.
 +
{{ActualVersion|0.13.0}}
 +
 
 +
==Section [astro]==
 
{| class="guidetable"
 
{| class="guidetable"
|''Section''
 
 
  |''ID''
 
  |''ID''
 
  |''Type''
 
  |''Type''
  |"Description''
+
  |''Version''
 +
|''Description''
 
  |-  
 
  |-  
  |[video]
+
  |nebula_magnitude_limit
  |fullscreen
+
  |float
  |boolean
+
  |0.12.1+
  |if ''true'', Stellarium will start up in full-screen mode. If ''false'', Stellarium will start in windowed mode
+
  |Value of limit magnitude of the deep-sky objects
 
  |-  
 
  |-  
  |[video]
+
  |star_magnitude_limit
  |screen_w
+
  |float
  |integer
+
  |0.12.1+
  |sets the display width when in windowed mode (value in pixels, e.g. ''1024'')
+
  |Value of limit magnitude of the stars
 
  |-  
 
  |-  
  |[video]
+
  |flag_nebula_magnitude_limit
  |screen_h
+
  |bool
  |integer
+
  |0.12.1+
  |sets the display height when in windowed mode (value in pixels, e.g. ''768'')
+
  |Set to ''true'' to set limits for showing deep-sky objects
 
  |-  
 
  |-  
  |[video]
+
  |flag_star_magnitude_limit
  |distorter
+
  |bool
  |string
+
  |0.12.1+
  |This is used when the spheric mirror display mode is activated. Values include ''none'' and ''fisheye_to_spheric_mirror''
+
  |Set to ''true'' to set limits for showing stars
 
  |-  
 
  |-  
  |[video]
+
  |flag_extinction_below_horizon
  |minimum_fps
+
  |bool
  |integer
+
  |0.11.2+
  |sets the minimum number of frames per second to display at (hardware performance permitting)
+
  |Set to ''true'' to apply extinction effects to sky below horizon
|-
+
  |-
|[video]
+
  |extinction_mode_below_horizon
|maximum_fps
+
|integer
+
|sets the maximum number of frames per second to display at. This is useful to reduce power consumption in laptops.
+
  |-  
+
  |[projection]
+
|type
+
 
  |string
 
  |string
  |sets projection mode. Values: ''perspective, equal_area, stereographic, fisheye, cylinder, mercator'', or ''orthographic''.
+
  |0.13.0+
 +
|Set extinction mode for atmosphere below horizon. Possible values: ''zero'', ''mirror'' and ''max''. Default value is ''zero''.
 
  |-  
 
  |-  
  |[projection]
+
  |flag_stars
  |viewport
+
  |bool
  |string
+
  |''all''
  |how the view-port looks. Values: ''maximized, disk''
+
  |Set to ''false'' to hide the stars on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_star_name
  |distorter_max_fov
+
  |bool
  |float
+
  |''all''
  |Set the maximum field of view for the spheric mirror distorter in degrees. Typical value, ''180''
+
  |Set to ''false'' to hide the star labels on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_planets
  |flag_use_ext_framebuffer_object
+
  |bool
  |boolean
+
  |''all''
  |Some video hardware incorrectly claims to support some GL extension, GL_FRAMEBUFFER_EXTEXT. If, when using the spheric mirror distorter the frame rate drops to a very low value (e.g. 0.1 FPS), set this parameter to false to tell Stellarium ignore the claim of the video driver that it can use this extension
+
  |Set to ''false'' to hide the planet labels on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_planets_hints
  |flip_horz
+
  |bool
  |boolean
+
  |''all''
  |Flip the projection horizontally
+
  |Set to ''false'' to hide the planet hints on start-up (names and circular highlights)
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_planets_orbits
  |flip_vert
+
  |bool
  |boolean
+
  |''all''
  |Flip the projection vertically
+
  |Set to ''true'' to show the planet orbits on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_planets_markers
  |projector_gamma
+
  |bool
  |float
+
  |0.13.0+
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Set to ''true'' to show the planet pointer markers on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |planet_pointers_color
  |projector_position_x
+
  |float R,G,B
  |float
+
  |0.13.0+
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Sets the colour of the planet pointers in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_light_travel_time
  |projector_position_y
+
  |bool
  |float
+
  |0.8.0+
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Set to ''true'' to improve accuracy in the movement of the planets by compensating for the time it takes for light to travel. This has an impact on performance.
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_object_trails
  |projector_position_z
+
  |bool
  |float
+
  |0.8.0+
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Turns on and off drawing of object trails (which show the movement of the planets over time)
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_nebula
  |mirror_position_x
+
  |bool
  |float
+
  |''all''
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Set to ''false'' to hide the nebulae on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_nebula_name
  |mirror_position_y
+
  |bool
  |float
+
  |''all''
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Set to ''true'' to show the nebula labels on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_nebula_long_name
  |mirror_position_z
+
  |bool
  |float
+
  |0.8.0+
  |This parameter controls the properties of the spheric mirror projection mode
+
  |Set to ''true'' to show the nebula long labels on start-up
 
  |-
 
  |-
  |[spheric_mirror]
+
  |flag_nebula_display_no_texture
|mirror_radius
+
|float
+
|This parameter controls the properties of the spheric mirror projection mode
+
|-
+
|[spheric_mirror]
+
|dome_radius
+
|float
+
|This parameter controls the properties of the spheric mirror projection mode
+
|-
+
|[spheric_mirror]
+
|zenith_y
+
|float
+
|This parameter controls the properties of the spheric mirror projection mode
+
|-
+
|[spheric_mirror]
+
|scaling_factor
+
|float
+
|This parameter controls the properties of the spheric mirror projection mode
+
|-
+
|[localization]
+
|sky_culture
+
|string
+
|sets the sky culturesky culture to use. Valid values are defined in the second column of <code>data/skycultures.fab</code>. Values: ''western, polynesian, egyptian, chinese, lakota, navajo, inuit, korean, norse, tupi, maori, aztec, sami''. The sky culture affects the constellations
+
|-
+
|[localization]
+
|sky_locale
+
|string
+
|Sets langauge used for names of objects in the sky (e.g. planets). The value is a short locale code, e.g. ''en, de, en_GB''
+
|-
+
|[localization]
+
|app_locale
+
|string
+
|Sets language used for Stellarium's user interface. The value is a short locale code, e.g. ''en, de, en_GB''
+
|-
+
|[stars]
+
|relative_scale
+
|float
+
|changes the relative size of bright and faint stars. Higher values mean that bright stars are comparitively larger when rendered. Typical value: ''1.0''
+
|-
+
|[stars]
+
|absolute_scale
+
|float
+
|changes how large stars are rendered. larger value lead to larger depiction. Typical value: ''1.0''
+
|-
+
|[stars]
+
|star_twinkle_amount
+
|float
+
|sets the amount of twinkling. Typical value: ''0.3''
+
|-
+
|[stars]
+
|flag_star_twinkle
+
 
  |bool
 
  |bool
  |set to ''false'' to turn star twinkling off, true to allow twinkling.
+
  |0.8.0+
 +
|Set to ''true'' to suppress displaying of nebula textures
 
  |-
 
  |-
  |[stars]
+
  |flag_milky_way
|flag_point_star
+
 
  |bool
 
  |bool
  |set to ''false'' to draw stars at a size that corresponds to their brightness. When set to true all stars are drawn at single pixel size
+
  |''all''
 +
|Set to ''false'' to hide the Milky Way
 
  |-
 
  |-
  |[stars]
+
  |milky_way_intensity
|mag_converter_max_fov
+
 
  |float
 
  |float
  |sets the maximum field of view for which the magnitude conversion routine is used
+
  |0.8.0+
 +
|Sets the relative brightness with which the milky way is drawn. Typical value: ''1'' to ''10''
 
  |-
 
  |-
  |[stars]
+
  |max_mag_nebula_name
|mag_converter_min_fov
+
 
  |float
 
  |float
  |sets the maximum field of view for which the magnitude conversion routine is used
+
  |''all''
 +
|Sets the magnitude of the nebulae whose name is shown. Typical value: ''8''
 
  |-
 
  |-
  |[gui]
+
  |nebula_scale
|base_font_size
+
|int
+
|sets the font size. Typical value: ''15''
+
|-
+
|[gui]
+
|base_font_name
+
|string
+
|Selects the name for base font , e.g. ''DejaVu Sans''
+
|-
+
|[gui]
+
|safe_font_name
+
|string
+
|Selects the name for safe font, e.g. ''Verdana''
+
|-
+
|[gui]
+
|base_font_file
+
|string
+
|Selects the name for font file, e.g. ''DejaVuSans.ttf''
+
|-
+
|[gui]
+
|flag_show_fps
+
|bool
+
|set to ''false'' if you don't want to see at how many frames per second Stellarium is rendering
+
|-
+
|[gui]
+
|flag_show_fov
+
|bool
+
|set to ''false'' if you don't want to see how many degrees your field of view is
+
|-
+
|[gui]
+
|flag_show_script_bar
+
|bool
+
|set to ''true'' if you want to have access to the script bar
+
|-
+
|[gui]
+
|mouse_cursor_timeout
+
 
  |float
 
  |float
  |set to ''0'' if you want to keep the mouse cursor visible at all times. non-0 values mean the cursor will be hidden after that many seconds of inactivity
+
  |0.8.0+
 +
|Sets how much to scale nebulae. a setting of ''1'' will display nebulae at normal size
 
  |-
 
  |-
  |[gui]
+
  |flag_bright_nebulae
|flag_script_allow_ui
+
 
  |bool
 
  |bool
  |when set to false the normal movement controls will be disabled when a script is playing true enables them
+
  |''all''
 +
|Set to ''true'' to increase nebulae brightness to enhance viewing (less realistic)
 
  |-
 
  |-
  |[gui]
+
  |flag_nebula_ngc
|flag_show_flip_buttons
+
 
  |bool
 
  |bool
  |enables/disables display of the image flipping buttons in the main toolbar (see section [sec:imageflipping])
+
  |0.8.0+
 +
|Enables/disables display of all NGC objects
 +
|}
 +
 
 +
==Section [chart_color]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|- class="deprecated"
 +
|azimuthal_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the azimuthal grid in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|gui_base_color
 +
|float R,G,B
 +
| 0.8.0
 +
|These three numbers determine the colour of the interface in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|gui_text_color
 +
|float R,G,B
 +
| 0.8.0
 +
|These three numbers determine the colour of the text in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|equatorial_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the equatorial gride in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|equator_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the equatorial line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|ecliptic_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the ecliptic line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|meridian_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the meridian line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|const_lines_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the constellation lines in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|const_names_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the constellation names in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|const_boundary_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the constellation boundaries in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|nebula_label_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the nebula labels in RGB values, where "1" is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|nebula_circle_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the circle of the nebula labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|star_label_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the star labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|star_circle_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the circle of the star labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|cardinal_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the cardinal points in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|planet_names_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the planet names in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|planet_orbits_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the orbits in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|object_trails_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the planet trails in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|chart_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the chart in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|telescope_circle_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the telescope location indicator. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|- class="deprecated"
 +
|telescope_label_color
 +
|float R,G,B
 +
| 0.8.0
 +
|Sets the colour of the telescope location label. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|}
 +
 
 +
==Sections [color] and [night_color]<ref>Section [night_color] was removed since version 0.13.0.</ref>==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 
  |-
 
  |-
  |[gui]
+
  |default_color
  |day_key_mode
+
  |float R,G,B
  |string
+
  |0.9.0+
  |Specifies the amount of time which is added and subtracted when the [ ] - and = keys are pressed - calendar days, or sidereal days. This option only makes sense for Digitalis planetariums. Values: ''calendar'' or ''sidereal''
+
  |Sets the default colour in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |azimuthal_color
 
  |azimuthal_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the azimuthal grid in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the azimuthal grid in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |gui_base_color
 
  |gui_base_color
 
  |float R,G,B
 
  |float R,G,B
  |these three numbers determine the colour of the interface in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  |0.10.1+
 +
|These three numbers determine the colour of the interface in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |gui_text_color
 
  |gui_text_color
 
  |float R,G,B
 
  |float R,G,B
  |these three numbers determine the colour of the text in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  |0.10.1+
 +
|These three numbers determine the colour of the text in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |equatorial_color
 
  |equatorial_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the equatorial gride in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the equatorial grid (on date) in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|equatorial_J2000_color
 +
|float R,G,B
 +
|0.10.2+
 +
|Sets the colour of the equatorial grid (J2000) in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|galactic_color
 +
|float R,G,B
 +
|0.10.4+
 +
|Sets the colour of the galactic grid in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|galactic_plane_color
 +
|float R,G,B
 +
|0.11.2+
 +
|Sets the colour of the galactic plane line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |equator_color
 
  |equator_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the equatorial line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the equatorial line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |ecliptic_color
 
  |ecliptic_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the ecliptic line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the ecliptic line (J2000) in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|ecliptic_J2000_color
 +
|float R,G,B
 +
|0.11.3+
 +
|Sets the colour of the ecliptic grid (J2000) in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |meridian_color
 
  |meridian_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the meridian line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the meridian line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|horizon_color
 +
|float R,G,B
 +
|0.11.0+
 +
|Sets the colour of the horizon line in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |const_lines_color
 
  |const_lines_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the constellation lines in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the constellation lines in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |const_names_color
 
  |const_names_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the constellation names in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the constellation names in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |const_boundary_color
 
  |const_boundary_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the constellation boundaries in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the constellation boundaries in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |nebula_label_color
 
  |nebula_label_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the nebula labels in RGB values, where "1" is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the nebula labels in RGB values, where "1" is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |nebula_circle_color
 
  |nebula_circle_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the circle of the nebula labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the circle of the nebula labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |star_label_color
 
  |star_label_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the star labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
  |-
+
|Sets the colour of the star labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
|[color]
+
  |- class="deprecated"
[night_color]
+
[chart_color]
+
 
  |star_circle_color
 
  |star_circle_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the circle of the star labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  |0.8.0
 +
|Sets the colour of the circle of the star labels in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |cardinal_color
 
  |cardinal_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the cardinal points in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the cardinal points in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |planet_names_color
 
  |planet_names_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the planet names in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white  
+
  | ''all''
 +
|Sets the colour of the planet names in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white  
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |planet_orbits_color
 
  |planet_orbits_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the orbits in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the orbits in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |object_trails_color
 
  |object_trails_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the planet trails in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
  |-
+
|Sets the colour of the planet trails in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
|[color]
+
  |- class="depreacated"
[night_color]
+
[chart_color]
+
 
  |chart_color
 
  |chart_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the chart in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  |0.8.0-0.8.2
 +
|Sets the colour of the chart in RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |telescope_circle_color
 
  |telescope_circle_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the telescope location indicator. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the telescope location indicator. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
|[color]
 
[night_color]
 
[chart_color]
 
 
  |telescope_label_color
 
  |telescope_label_color
 
  |float R,G,B
 
  |float R,G,B
  |sets the colour of the telescope location label. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
+
  | ''all''
 +
|Sets the colour of the telescope location label. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 
  |-
 
  |-
  |[tui]
+
  |script_console_keyword_color
  |flag_enable_tui_menu
+
|float R,G,B
 +
|0.10.5+
 +
|Sets the colour of the keywords in the script console. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|script_console_module_color
 +
|float R,G,B
 +
|0.10.5+
 +
|Sets the colour of the modules in the script console. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|script_console_comment_color
 +
|float R,G,B
 +
|0.10.5+
 +
|Sets the colour of the comments in the script console. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|script_console_function_color
 +
|float R,G,B
 +
|0.10.5+
 +
|Sets the colour of the functions in the script console. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-
 +
|script_console_constant_color
 +
|float R,G,B
 +
|0.10.5+
 +
|Sets the colour of the constants in the script console. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|-class="comingsoon"
 +
|daylight_color
 +
|float R,G,B
 +
|0.13.1+
 +
|Sets the colour of the info text at daylight. RGB values, where 1 is the maximum, e.g. ''1.0,1.0,1.0'' for white
 +
|}
 +
 
 +
==Section [custom_selected_info]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
  |flag_show_absolutemagnitude
 
  |bool
 
  |bool
  |enables or disables the TUI menu
+
  |0.11.3+
 +
|If ''true'', Stellarium will be show absolute magnitude for objects.
 +
|-
 +
|flag_show_altaz
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show horizontal coordinates for objects.
 +
|-
 +
|flag_show_catalognumber
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show catalog designations for objects.
 +
|-
 +
|flag_show_distance
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show distance to object.
 +
|-
 +
|flag_show_extra1
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show extra info for object.
 +
|-
 +
|flag_show_extra2
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show extra info for object.
 +
|-
 +
|flag_show_extra3
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show extra info for object.
 +
|-
 +
|flag_show_hourangle
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show hour angles for object.
 +
|-
 +
|flag_show_magnitude
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show magnitude for object.
 +
|-
 +
|flag_show_name
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show common name for object.
 +
|-
 +
|flag_show_radecj2000
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show geocentrical equatorial coordinates (J2000) of object.
 +
|-
 +
|flag_show_radecofdate
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show geocentrical equatorial coordinates (of date) of object.
 +
|-
 +
|flag_show_size
 +
|bool
 +
|0.11.3+
 +
|If ''true'', Stellarium will be show size of object.
 +
|}
 +
 
 +
==Section [custom_time_correction]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|coefficients
 +
|[float,float,float]
 +
|0.12.1+
 +
|Coefficients for custom equation of DeltaT
 +
|-
 +
|ndot
 +
|float
 +
|0.12.1+
 +
|n-dot value for custom equation of DeltaT
 +
|-
 +
|year
 +
|int
 +
|0.12.1+
 +
|Year for custom equation of DeltaT
 +
|}
 +
 
 +
==Section [files]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|removable_media_path
 +
|string
 +
|0.9.0+
 +
|Path to removable mediaremovable media (CD/DVD). This is usually only used in Digitalis planetariums products.
 
  |-
 
  |-
  |[tui]
+
  |scripts_can_write_files
|flag_show_gravity_ui
+
 
  |bool
 
  |bool
  |[color][night_color][chart_color]
+
  |0.9.0+
 +
|Some scripting commands will cause files to be written. Unless this option is set to true, these scripting commands will fail.
 +
|}
 +
 
 +
==Section [gui]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 
  |-
 
  |-
  |[tui]
+
  |base_font_size
  |flag_show_tui_datetime
+
  |int
 +
|''all''
 +
|Sets the font size. Typical value: ''15''
 +
|-
 +
| rowspan="2" | base_font_name
 +
| rowspan="2" | string
 +
| class="deprecated" | 0.8.0-0.11.4
 +
| class="deprecated" | Selects the name for font file, e.g. ''DejaVuSans.ttf''
 +
|-
 +
| 0.12.0+
 +
| Selects the name for base font, e.g. ''DejaVu Sans''
 +
|-
 +
|safe_font_name
 +
|string
 +
|0.12.0+
 +
|Selects the name for safe font, e.g. ''Verdana''
 +
|-
 +
|base_font_file
 +
|string
 +
|0.12.0+
 +
|Selects the name for font file, e.g. ''DejaVuSans.ttf''
 +
|-
 +
|flag_show_fps
 
  |bool
 
  |bool
  |set to ''true'' if you want to see a date and time label suited for dome projections
+
  |''all''
 +
|Set to ''false'' if you don't want to see at how many frames per second Stellarium is rendering
 
  |-
 
  |-
  |[tui]
+
  |flag_show_fov
|flag_show_tui_short_obj_info
+
 
  |bool
 
  |bool
  |set to ''true'' if you want to see object info suited for dome projections
+
  |''all''
 +
|Set to ''false'' if you don't want to see how many degrees your field of view is
 +
|- class="deprecated"
 +
|flag_show_script_bar
 +
|bool
 +
|0.7.1-0.10.0
 +
|Set to ''true'' if you want to have access to the script bar
 
  |-
 
  |-
  |[navigation]
+
  |flag_mouse_cursor_timeout
 +
|float
 +
|0.8.0+
 +
|set to ''0'' if you want to keep the mouse cursor visible at all times. non-0 values mean the cursor will be hidden after that many seconds of inactivity
 +
|- class="deprecated"
 +
|flag_script_allow_ui
 +
|bool
 +
|0.8.0-0.10.0
 +
|When set to false the normal movement controls will be disabled when a script is playing true enables them
 +
|-
 +
|flag_show_flip_buttons
 +
|bool
 +
|0.8.2+
 +
|Enables/disables display of the image flipping buttons in the main toolbar (see section [sec:imageflipping])
 +
|-
 +
|flag_show_nebulae_background_button
 +
|bool
 +
|0.10.1+
 +
|Set to ''true'' if you want to have access to the button for enabling/disabling backgrounds for deep-sky objects
 +
|-
 +
|flag_use_degrees
 +
|bool
 +
|0.12.2+
 +
|
 +
|-
 +
|selected_object_info
 +
|string
 +
|0.10.0+
 +
|Values: ''all'', ''short'' and ''none''. Value ''custom'' added since version 0.12.0.
 +
|-
 +
|auto_hide_horizontal_toolbar
 +
|bool
 +
|0.10.1+
 +
|Set to ''true'' if you want auto hide the horizontal toolbar.
 +
|-
 +
|auto_hide_vertical_toolbar
 +
|bool
 +
|0.10.1+
 +
|Set to ''true'' if you want auto hide the vertical toolbar.
 +
|-
 +
|day_key_mode
 +
|string
 +
|0.9.0+
 +
|Specifies the amount of time which is added and subtracted when the [ ] - and = keys are pressed - calendar days, or sidereal days. This option only makes sense for Digitalis planetariums. Values: ''calendar'' or ''sidereal''
 +
|- class="deprecated"
 +
|flag_menu
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_help
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_infos
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_show_topbar
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_show_time
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_show_date
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_show_appname
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|flag_show_selected_object_info
 +
|bool
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|gui_base_color
 +
|float R,G,B
 +
|0.6.2-0.10.0
 +
|
 +
|- class="deprecated"
 +
|gui_text_color
 +
|float R,G,B
 +
|0.6.2-0.10.0
 +
|
 +
|-
 +
|flag_use_window_transparency
 +
|bool
 +
|0.13.0+
 +
|Set to ''false'' if you want see the opacity for bars
 +
|- class="comingsoon"
 +
|flag_show_datetime
 +
|bool
 +
|0.13.1+
 +
|Set to ''true'' if you want display date and time in the bottom bar
 +
|- class="comingsoon"
 +
|flag_time_jd
 +
|bool
 +
|0.13.1+
 +
|Set to ''true'' if you want using JD format for time in the bottom bar
 +
|- class="comingsoon"
 +
|flag_show_location
 +
|bool
 +
|0.13.1+
 +
|Set to ''true'' if you want display location in the bottom bar
 +
|- class="comingsoon"
 +
|flag_fov_dms
 +
|bool
 +
|0.13.1+
 +
|Set to ''true'' if you want using DMS format for FOV in the bottom bar
 +
|}
 +
 
 +
==Section [init_location]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|- class="deprecated"
 +
|name
 +
|string
 +
|0.6.2-0.10.0
 +
|Sets your location's name. This is an arbitrary string, For example, ''Paris''
 +
|- class="deprecated"
 +
|latitude
 +
|DMS
 +
|0.6.2-0.9.1
 +
|Sets the latitude coordinate of the observer. Value is in degrees, minutes, seconds. Positive degree values mean North / negative South. e.g. ''+55d14'30.00"''
 +
|- class="deprecated"
 +
|longitude
 +
|DMS
 +
|0.6.2-0.9.1
 +
|Sets the longitude coordinate of the observer. Value is in degrees, minutes, seconds. Positive degree values mean East / negative West. e.g. ''-01d37'6.00"''
 +
|- class="deprecated"
 +
|altitude
 +
|float
 +
|0.6.2-0.9.1
 +
|Observer's altitude above mean sea level in meters, e.g. ''53''
 +
|-
 +
|landscape_name
 +
|string
 +
|''all''
 +
|sets the landscape you see. Other options are ''garching, guereins, trees, moon, ocean, hurricane, hogerielen''
 +
|- class="deprecated"
 +
|time_zone
 +
|string
 +
|0.6.2-0.9.1
 +
|Sets the time zonetime zone. Valid values: ''system_default'', or some region/location combination, e.g. ''Pacific/Marquesas''
 +
|- class="deprecated"
 +
|time_display_format
 +
|string
 +
|0.6.2-0.9.1
 +
|Set the time display formattime display format mode: can be ''system_default'', ''24h'' or ''12h''.
 +
|- class="deprecated"
 +
|date_display_format
 +
|string
 +
|0.6.2-0.9.1
 +
|Set the date display format mode: can be ''system_default'', ''mddyyyy'', ''ddmmyyyy'' or ''yyyymmdd'' (ISO8601).
 +
|- class="deprecated"
 +
|home_planet
 +
|string
 +
|0.6.2-0.9.1
 +
|Name of solar system body on which to start stellarium. This may be set at runtime from the TUI menu.
 +
|-
 +
|location
 +
|string
 +
|0.10.1+
 +
|Name of location on which to start stellarium.
 +
|- class="comingsoon"
 +
|last_location
 +
|string
 +
|0.13.1+
 +
|Coordinates of last used location in stellarium.
 +
|}
 +
 
 +
==Section [landscape]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|flag_landscape
 +
|bool
 +
|''all''
 +
|Set to false if you don't want to see the landscape at all
 +
|-
 +
|flag_fog
 +
|bool
 +
|''all''
 +
|Set to ''false'' if you don't want to see fog on start-up
 +
|-
 +
|flag_atmosphere
 +
|bool
 +
|''all''
 +
|Set to ''false'' if you don't want to see atmosphere on start-up
 +
|-
 +
|flag_landscape_sets_location
 +
|bool
 +
|''all''
 +
|Set to ''true'' if you want Stellarium to modify the observer location when a new landscape is selected (changes planet and longitude/latitude/altitude if that data is available in the landscape.ini file)
 +
|-
 +
|initial_brightness
 +
|float
 +
|0.12.1+
 +
|Set initial brightness for landscapes. Typical value: ''0.01''
 +
|-
 +
|atmospheric_extinction_coefficient
 +
|float
 +
|0.11.0+
 +
|Set atmospheric extinction coefficient
 +
|-
 +
|temperature_C
 +
|float
 +
|0.11.0+
 +
|Set atmospheric temperature (Celsius)
 +
|-
 +
|pressure_mbar
 +
|float
 +
|0.11.0+
 +
|Set atmospheric pressure (mbar)
 +
|}
 +
 
 +
==Section [localization]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|sky_culture
 +
|string
 +
|''all''
 +
|Sets the sky culture to use. E.g. ''western, polynesian, egyptian, chinese, lakota, navajo, inuit, korean, norse, tupi, maori, aztec, sami''.
 +
|-
 +
|sky_locale
 +
|string
 +
|''all''
 +
|Sets language used for names of objects in the sky (e.g. planets). The value is a short locale code, e.g. ''en, de, en_GB''
 +
|-
 +
|app_locale
 +
|string
 +
|''all''
 +
|Sets language used for Stellarium's user interface. The value is a short locale code, e.g. ''en, de, en_GB''.
 +
|-
 +
|time_zone
 +
|string
 +
|0.10.6+
 +
|Sets the time zone. Valid values: ''system_default'', or some region/location combination, e.g. ''Pacific/Marquesas''
 +
|-
 +
|time_display_format
 +
|string
 +
|0.10.6+
 +
|Set the time display format mode: can be ''system_default'', ''24h'' or ''12h''.
 +
|-
 +
|date_display_format
 +
|string
 +
|0.10.6+
 +
|Set the date display format mode: can be ''system_default'', ''mmddyyyy'', ''ddmmyyyy'' or ''yyyymmdd'' (ISO8601).
 +
|}
 +
 
 +
==Section [main]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|invert_screenshots_colors
 +
|bool
 +
|0.10.1+
 +
|If ''true'', Stellarium will saving the screenshorts with inverted colors.
 +
|-
 +
|restore_defaults
 +
|bool
 +
|0.10.1+
 +
|If ''true'', Stellarium will be restore default settings at startup.
 +
|-
 +
|screenshot_dir
 +
|string
 +
|0.10.1+
 +
|Path for saving screenshots
 +
|-
 +
|version
 +
|string
 +
|''all''
 +
|Version of Stellarium. This parameter using for updating config.ini file
 +
|- class="comingsoon"
 +
|use_separate_output_file
 +
|bool
 +
|0.13.1+
 +
|Set to ''true'' if you want to create a new file for output for each start of Stellarium
 +
|}
 +
 
 +
==Section [navigation]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 
  |preset_sky_time
 
  |preset_sky_time
 
  |float
 
  |float
  |preset sky time used by the dome version. Unit is Julian Day. Typical value: ''2451514.250011573''
+
  |''all''
 +
|Preset sky time used by the dome version. Unit is Julian Day. Typical value: ''2451514.250011573''
 
  |-
 
  |-
|[navigation]
 
 
  |startup_time_mode
 
  |startup_time_mode
 
  |string
 
  |string
  |set the start-up time mode, can be ''actual'' (start with current real world time), or ''Preset'' (start at time defined by preset_sky_time)
+
  |''all''
 +
|Set the start-up time mode, can be ''actual'' (start with current real world time), or ''Preset'' (start at time defined by preset_sky_time)
 
  |-
 
  |-
|[navigation]
 
 
  |flag_enable_zoom_keys
 
  |flag_enable_zoom_keys
 
  |bool
 
  |bool
  |set to ''false'' if you want to disable the zoom
+
  |''all''
 +
|Set to ''false'' if you want to disable the zoom
 
  |-
 
  |-
|[navigation]
 
 
  |flag_manual_zoom
 
  |flag_manual_zoom
 
  |bool
 
  |bool
  |set to'' false'' for normal zoom behaviour as described in this guide. When set to true, the auto zoom feature only moves in a small amount and must be pressed many times
+
  |''all''
 +
|Set to'' false'' for normal zoom behaviour as described in this guide. When set to true, the auto zoom feature only moves in a small amount and must be pressed many times
 
  |-
 
  |-
|[navigation]
 
 
  |flag_enable_move_keys
 
  |flag_enable_move_keys
 
  |bool
 
  |bool
  |set to ''false'' if you want to disable the arrow keys
+
  |''all''
 +
|Set to ''false'' if you want to disable the arrow keys
 
  |-
 
  |-
  |[navigation]
+
  |flag_enable_mouse_navigation
|flag_enable_move_mouse
+
 
  |bool
 
  |bool
  |doesn't seem to do very much
+
  |''all''
 +
|Set to ''false'' if you want to disable the mouse navigation.
 
  |-
 
  |-
|[navigation]
 
 
  |init_fov
 
  |init_fov
 
  |float
 
  |float
  |initial field of view, in degrees, typical value:'' 60''
+
  |''all''
 +
|Initial field of view, in degrees, typical value:'' 60''
 
  |-
 
  |-
|[navigation]
 
 
  |init_view_pos
 
  |init_view_pos
 
  |floats
 
  |floats
  |initial viewing direction. This is a vector with x,y,z-coordinates. x being N-S (S +ve), y being E-W (E +ve), z being up-down (up +ve). Thus to look South at the horizon use ''1,0,0''. To look Northwest and up at 45&deg;, use ''-1,-1,1'' and so on.
+
  |''all''
 +
|Initial viewing direction. This is a vector with x,y,z-coordinates. x being N-S (S +ve), y being E-W (E +ve), z being up-down (up +ve). Thus to look South at the horizon use ''1,0,0''. To look Northwest and up at 45&deg;, use ''-1,-1,1'' and so on.
 
  |-
 
  |-
|[navigation]
 
 
  |auto_move_duration
 
  |auto_move_duration
 
  |float
 
  |float
  |duration for the program to move to point at an object when the space bar is pressed. Typical value: ''1.4''
+
  |''all''
 +
|Duration for the program to move to point at an object when the space bar is pressed. Typical value: ''1.4''
 
  |-
 
  |-
|[navigation]
 
 
  |mouse_zoom
 
  |mouse_zoom
 
  |float
 
  |float
 +
|''all''
 
  |Sets the mouse zoom amount (mouse-wheel)
 
  |Sets the mouse zoom amount (mouse-wheel)
 
  |-
 
  |-
|[navigation]
 
 
  |move_speed
 
  |move_speed
 
  |float
 
  |float
 +
|''all''
 
  |Sets the speed of movement
 
  |Sets the speed of movement
 
  |-
 
  |-
|[navigation]
 
 
  |zoom_speed
 
  |zoom_speed
 
  |float
 
  |float
 +
|''all''
 
  |Sets the zoom speed
 
  |Sets the zoom speed
 
  |-
 
  |-
|[navigation]
 
 
  |viewing_mode
 
  |viewing_mode
 
  |string
 
  |string
  |if set to ''horizon'', the viewing mode simulate an alt/azi mount, if set to ''equator'', the viewing mode simulates an equatorial mount
+
  |''all''
 +
|If set to ''horizon'', the viewing mode simulate an alt/azi mount, if set to ''equator'', the viewing mode simulates an equatorial mount
 
  |-
 
  |-
|[navigation]
 
 
  |flag_manual_zoom
 
  |flag_manual_zoom
 
  |bool
 
  |bool
  |set to ''true'' if you want to auto-zoom in incrementally.
+
  |''all''
 +
|Set to ''true'' if you want to auto-zoom in incrementally.
 
  |-
 
  |-
  |[landscape]
+
  |auto_zoom_out_resets_direction
|flag_langscape
+
 
  |bool
 
  |bool
  |set to false if you don't want to see the landscape at all
+
  |''all''
 +
|Set to ''true'' if you want to auto-zoom restoring direction.
 
  |-
 
  |-
  |[landscape]
+
  |time_correction_algorithm
  |flag_fog
+
|string
  |bool
+
|0.12.1+
  |set to ''false'' if you don't want to see fog on start-up
+
|Algorithm of DeltaT correction.
 +
|}
 +
 
 +
==Section [plugins_load_at_startup]==
 +
{| class="guidetable"
 +
  |''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
| AngleMeasure
 +
  | bool
 +
  | 0.10.3+
 +
| If ''true'', Stellarium will be load Angle Measure plugin at startup.
 +
|-
 +
| CompassMarks
 +
| bool
 +
| 0.10.3+
 +
| If ''true'', Stellarium will be load Compass Marks plugin at startup.
 +
|-  
 +
| Exoplanets
 +
| bool
 +
| 0.11.4+
 +
| If ''true'', Stellarium will be load Exoplanets plugin at startup.
 +
|-
 +
| Observability
 +
| bool
 +
| 0.11.4+
 +
| If ''true'', Stellarium will be load Observability Analysis plugin at startup.
 +
|-
 +
| Oculars
 +
| bool
 +
| 0.10.3+
 +
| If ''true'', Stellarium will be load Oculars plugin at startup.
 +
|-
 +
| Pulsars
 +
| bool
 +
| 0.11.2+
 +
| If ''true'', Stellarium will be load Pulsars plugin at startup.
 +
|-
 +
| Quasars
 +
| bool
 +
| 0.11.2+
 +
| If ''true'', Stellarium will be load Quasars plugin at startup.
 +
|-
 +
| Satellites
 +
| bool
 +
| 0.10.3+
 +
| If ''true'', Stellarium will be load Satellites plugin at startup.
 +
|-
 +
| SolarSystemEditor
 +
| bool
 +
| 0.10.6+
 +
| If ''true'', Stellarium will be load Solar System Editor plugin at startup.
 +
|-
 +
| Supernovae
 +
| bool
 +
| 0.11.0+
 +
| If ''true'', Stellarium will be load Historical Supernovae plugin at startup.
 +
|-
 +
| TelescopeControl
 +
| bool
 +
| 0.10.3+
 +
| If ''true'', Stellarium will be load Telescope Control plugin at startup.
 +
|-
 +
| TextUserInterface
 +
| bool
 +
| 0.10.3+
 +
| If ''true'', Stellarium will be load Text User Interface plugin at startup.
 +
|-
 +
| TimeZoneConfiguration
 +
| bool
 +
| 0.10.6+
 +
| If ''true'', Stellarium will be load Time Zone plugin at startup.
 +
|-
 +
| Novae
 +
| bool
 +
| 0.12.3+
 +
| If ''true'', Stellarium will be load Bright Novae plugin at startup.
 +
|}
 +
 
 +
==Section [projection]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
| rowspan="2" | type
 +
| rowspan="2" | string
 +
| class="deprecated" | 0.8.0+
 +
| class="deprecated" | Sets projection mode. Values: ''perspective, equal_area, stereographic, fisheye, cylinder, mercator'', or ''orthographic''.
 
  |-
 
  |-
  |[landscape]
+
  | 0.10.3+
  |flag_atmosphere
+
  | Sets projection mode. Values: ''ProjectionPerspective, ProjectionEqualArea, ProjectionStereographic, ProjectionFisheye, ProjectionHammer, ProjectionCylinder, ProjectionMercator'' or ''ProjectionOrthographic''.
 +
|-
 +
|viewport
 +
|string
 +
|''all''
 +
|How the view-port looks. Values: ''none, disk''.
 +
|-
 +
|viewportMask
 +
|string
 +
|''all''
 +
|How the view-port looks. Values: ''none''.
 +
|-
 +
|flag_use_gl_point_sprite
 
  |bool
 
  |bool
  |set to ''false'' if you don't want to see atmosphere on start-up
+
  |''all''
  |-
+
  |
  |[landscape]
+
  |-
  |flag_landscape_sets_location
+
  |flip_horz
 
  |bool
 
  |bool
  |set to ''true'' if you want Stellarium to modify the observer location when a new landscape is selected (changes planet and longitude/latitude/altitude if that data is available in the landscape.ini file)
+
  |''all''
 +
|
 +
|-
 +
|flip_vert
 +
|bool
 +
|''all''
 +
|
 +
|}
 +
 
 +
==Section [proxy]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|host_name
 +
|string
 +
|0.10.3+
 +
|Name of host for proxy. E.g. ''proxy.org''
 +
|-
 +
|port
 +
|int
 +
|0.10.3+
 +
|Port of proxy. E.g. ''8080''
 +
|-
 +
|user
 +
|string
 +
|0.10.3+
 +
|Username for proxy. E.g. ''michael_knight''
 +
|-
 +
|password
 +
|string
 +
|0.10.3+
 +
|Password for proxy. E.g. ''xxxxx''
 +
|}
 +
 
 +
==Section [scripts]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|flag_script_allow_ui
 +
|bool
 +
|0.9.1+
 +
|
 +
|-
 +
|scripting_allow_write_files
 +
|bool
 +
|0.9.1+
 +
|
 +
|}
 +
 
 +
==Section [search]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|flag_search_online
 +
|bool
 +
|0.11.2+
 +
|If ''true'', Stellarium will be use SIMBAD for search.
 +
|-
 +
|simbad_server_url
 +
|string
 +
|0.11.2+
 +
|URL for SIMBAD mirror
 +
|-
 +
|flag_start_words
 +
|bool
 +
|0.12.3+
 +
|If ''false'', Stellarium will be search phrase only from start of words
 +
|- class="comingsoon"
 +
|coordinate_system
 +
|string
 +
|0.13.1+
 +
|Specifies the coordinate system. ''Possible values:'' equatorialJ2000, equatorial, horizontal, galactic. ''Default value:'' equatorialJ2000.
 +
|}
 +
 
 +
==Section [spheric_mirror]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 
  |-
 
  |-
  |[landscape]
+
  |distorter_max_fov
|initial_brightness
+
 
  |float
 
  |float
  |set initial brightness for landscapes. Typical value: ''0.01'' (Since 0.12.1)
+
  |''all''
 +
|Set the maximum field of view for the spheric mirror distorter in degrees. Typical value, ''180''
 
  |-
 
  |-
  |[viewing]
+
  |flag_use_ext_framebuffer_object
|atmosphere_fade_duration
+
|float
+
|sets the time it takes for the atmosphere to fade when de-selected
+
|-
+
|[viewing]
+
|flag_constellation_drawing
+
 
  |bool
 
  |bool
  |set to ''true'' if you want to see the constellation line drawing on start-up
+
  |''all''
 +
|Some video hardware incorrectly claims to support some GL extension, GL_FRAMEBUFFER_EXTEXT. If, when using the spheric mirror distorter the frame rate drops to a very low value (e.g. 0.1 FPS), set this parameter to false to tell Stellarium ignore the claim of the video driver that it can use this extension
 
  |-
 
  |-
  |[viewing]
+
  |flip_horz
|flag_constellation_name
+
 
  |bool
 
  |bool
  |set to ''true'' if you want to see the constellation names on start-up
+
  |''all''
 +
|Flip the projection horizontally
 
  |-
 
  |-
  |[viewing]
+
  |flip_vert
|flag_constellation_art
+
 
  |bool
 
  |bool
  |set to ''true'' if you want to see the constellation art on start-up
+
  |''all''
 +
|Flip the projection vertically
 
  |-
 
  |-
  |[viewing]
+
  |projector_gamma
  |flag_constellation_boundaries
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want to see the constellation boundaries on start-up
+
| colspan="11" | This parameter controls the properties of the spheric mirror projection mode.
 
  |-
 
  |-
  |[viewing]
+
  |projector_position_x
  |flag_constellation_isolate_selected
+
  |float
  |bool
+
  |''all''
|when set to ''true'', constellation lines, boundaries and art will be limited to the constellation of the selected star, if that star is ”on” one of the constellation lines.
+
 
  |-
 
  |-
  |[viewing]
+
  |projector_position_y
  |flag_constellation_pick
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you only want to see the line drawing, art and name of the selected constellation star
+
 
  |-
 
  |-
  |[viewing]
+
  |projector_position_z
  |flag_azimutal_grid
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want to see the azimuthal grid on start-up
+
 
  |-
 
  |-
  |[viewing]
+
  |mirror_position_x
  |flag_equatorial_grid
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want to see the equatorial grid on start-up
+
 
  |-
 
  |-
  |[viewing]
+
  |mirror_position_y
  |flag_equator_line
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want to see the equator line on start-up
+
 
  |-
 
  |-
  |[viewing]
+
  |mirror_position_z
  |flag_ecliptic_line
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want to see the ecliptic line on start-up
+
 
  |-
 
  |-
  |[viewing]
+
  |mirror_radius
  |flag_meridian_line
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want to see the meridian line on start-up
+
 
  |-
 
  |-
  |[viewing]
+
  |dome_radius
  |flag_cardinal_points
+
  |float
  |bool
+
  |''all''
|set to ''false'' if you don't want to see the cardinal points
+
 
  |-
 
  |-
  |[viewing]
+
  |zenith_y
  |flag_gravity_labels
+
  |float
  |bool
+
  |''all''
|set to ''true'' if you want labels to undergo gravity (top side of text points toward zenithzenith). Useful with dome projection.
+
 
  |-
 
  |-
  |[viewing]
+
  |scaling_factor
  |flag_moon_scaled
+
|float
  |bool
+
|''all''
  |change to ''false'' if you want to see the real moon size on start-up
+
|}
 +
 
 +
==Section [stars]==
 +
{| class="guidetable"
 +
  |''ID''
 +
  |''Type''
 +
|''Version''
 +
  |''Description''
 
  |-
 
  |-
  |[viewing]
+
  |relative_scale
|moon_scale
+
 
  |float
 
  |float
  |sets the moon scale factor, to correlate to our perception of the moon's size. Typical value: ''4''
+
  |''all''
 +
|Changes the relative size of bright and faint stars. Higher values mean that bright stars are comparitively larger when rendered. Typical value: ''1.0''
 
  |-
 
  |-
  |[viewing]
+
  |absolute_scale
|constellation_art_intensity
+
 
  |float
 
  |float
  |this number multiplies the brightness of the constellation art images. Typical value: ''0.5''
+
  |''all''
 +
  |Changes how large stars are rendered. larger value lead to larger depiction. Typical value: ''1.0''
 
  |-
 
  |-
  |[viewing]
+
  |star_twinkle_amount
|constellation_art_fade_duration
+
 
  |float
 
  |float
  |sets the amount of time the constellation art takes to fade in or out, in seconds. Typical value: ''1.5''
+
  |''all''
 +
|Sets the amount of twinkling. Typical value: ''0.3''
 
  |-
 
  |-
  |[viewing]
+
  |flag_star_twinkle
|flag_chart
+
 
  |bool
 
  |bool
  |enable chart mode on startup
+
  |''all''
 +
|Set to ''false'' to turn star twinkling off, ''true'' to allow twinkling.
 
  |-
 
  |-
  |[viewing]
+
  |flag_point_star
|flag_night
+
 
  |bool
 
  |bool
  |enable night mode on startup
+
  |''all''
  |-
+
  |Set to ''false'' to draw stars at a size that corresponds to their brightness. When set to true all stars are drawn at single pixel size
  |[viewing]
+
  |-
  |light_pollution_luminance
+
  |mag_converter_max_fov
 
  |float
 
  |float
  |sets the level of the light pollution simulation
+
  |''all''
 +
|Sets the maximum field of view for which the magnitude conversion routine is used. Typical value: ''90.0''.
 +
|-
 +
|mag_converter_min_fov
 +
|float
 +
|''all''
 +
|Sets the minimum field of view for which the magnitude conversion routine is used. Typical value: ''0.001''.
 +
|-
 +
|labels_amount
 +
|float
 +
|''all''
 +
|Sets the amount of labels. Typical value: ''3.0''
 +
|-
 +
|init_bortle_scale
 +
|int
 +
|''all''
 +
|Sets the initial value of the bortle scale. Typical value: ''3''.
 +
|}
 +
 
 +
==Section [tui]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|flag_enable_tui_menu
 +
|bool
 +
|prior 0.9.1; 0.10.3+
 +
|Enables or disables the TUI menu
 
  |-
 
  |-
  |[astro]
+
  |flag_show_gravity_ui
|flag_stars
+
 
  |bool
 
  |bool
  |set to ''false'' to hide the stars on start-up
+
  | prior 0.9.1; 0.10.3+
 +
|Enables or disables gravity mode for UI
 
  |-
 
  |-
  |[astro]
+
  |flag_show_tui_datetime
|flag_star_name
+
 
  |bool
 
  |bool
  |set to ''false'' to hide the star labels on start-up
+
  |prior 0.9.1; 0.10.3+
 +
|Set to ''true'' if you want to see a date and time label suited for dome projections
 
  |-
 
  |-
  |[astro]
+
  |flag_show_tui_short_obj_info
|flag_planets
+
 
  |bool
 
  |bool
  |set to ''false'' to hide the planet labels on start-up
+
| prior 0.9.1; 0.10.3+
 +
  |set to ''true'' if you want to see object info suited for dome projections
 +
|}
 +
 
 +
==Section [video]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-  
 +
|fullscreen
 +
|bool
 +
|''all''
 +
|If ''true'', Stellarium will start up in full-screen mode. If ''false'', Stellarium will start in windowed mode
 +
|-
 +
|screen_w
 +
|int
 +
|''all''
 +
|Sets the display width when in windowed mode. Value in pixels, e.g. ''1024''
 +
|-
 +
|screen_h
 +
|int
 +
|''all''
 +
|Sets the display height when in windowed mode. Value in pixels, e.g. ''768''
 +
|-
 +
|screen_x
 +
|int
 +
|''all''
 +
|Value in pixels, e.g. ''0''
 +
|-
 +
|screen_y
 +
|int
 +
|''all''
 +
|Value in pixels, e.g. ''0''
 +
|-
 +
|horizontal_offset
 +
|int
 +
|''all''
 +
|Value in pixels, e.g. ''0''
 +
|-
 +
|vertical_offset
 +
|int
 +
|''all''
 +
|Value in pixels, e.g. ''0''
 +
|- class="deprecated"
 +
|distorter
 +
|string
 +
|0.8.0-0.10.2
 +
|This is used when the spheric mirror display mode is activated. Values include ''none'' and ''fisheye_to_spheric_mirror''.
 
  |-
 
  |-
  |[astro]
+
  |viewport_effect
  |flag_planets_hints
+
|string
 +
|0.10.3+
 +
|This is used when the spheric mirror display mode is activated. Values include ''none'' and ''sphericMirrorDistorter''.
 +
|-
 +
|minimum_fps
 +
|int
 +
|''all''
 +
|Sets the minimum number of frames per second to display at (hardware performance permitting)
 +
|-
 +
|maximum_fps
 +
|int
 +
|''all''
 +
|Sets the maximum number of frames per second to display at. This is useful to reduce power consumption in laptops.
 +
|}
 +
 
 +
==Section [viewing]==
 +
{| class="guidetable"
 +
|''ID''
 +
|''Type''
 +
|''Version''
 +
|''Description''
 +
|-
 +
|atmosphere_fade_duration
 +
|float
 +
|0.8.0+
 +
|Sets the time it takes for the atmosphere to fade when de-selected
 +
|-
 +
  |flag_constellation_drawing
 
  |bool
 
  |bool
  |set to ''false'' to hide the planet hints on start-up (names and circular highlights)
+
  |''all''
 +
|Set to ''true'' if you want to see the constellation line drawing on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_constellation_name
|flag_planets_orbits
+
 
  |bool
 
  |bool
  |set to ''true'' to show the planet orbits on start-up
+
  |''all''
 +
|Set to ''true'' if you want to see the constellation names on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_constellation_art
|flag_light_travel_time
+
 
  |bool
 
  |bool
  |set to ''true'' to improve accuracy in the movement of the planets by compensating for the time it takes for light to travel. This has an impact on performance.
+
  |''all''
 +
|Set to ''true'' if you want to see the constellation art on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_constellation_boundaries
|flag_object_trails
+
 
  |bool
 
  |bool
  |turns on and off drawing of object trails (which show the movement of the planets over time)
+
  |0.8.0+
 +
|Set to ''true'' if you want to see the constellation boundaries on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_constellation_isolate_selected
|flag_nebula
+
 
  |bool
 
  |bool
  |set to ''false'' to hide the nebulae on start-up
+
  |''all''
 +
|When set to ''true'', constellation lines, boundaries and art will be limited to the constellation of the selected star, if that star is ”on” one of the constellation lines.
 +
|- class="deprecated"
 +
|flag_constellation_pick
 +
|bool
 +
|0.6.2-0.7.1
 +
|Set to ''true'' if you only want to see the line drawing, art and name of the selected constellation star
 
  |-
 
  |-
  |[astro]
+
  |flag_azimutal_grid
|flag_nebula_name
+
 
  |bool
 
  |bool
  |set to ''true'' to show the nebula labels on start-up
+
  |''all''
 +
|Set to ''true'' if you want to see the azimuthal grid on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_equatorial_grid
|flag_nebula_long_name
+
 
  |bool
 
  |bool
  |set to ''true'' to show the nebula long labels on start-up
+
  |''all''
 +
|Set to ''true'' if you want to see the equatorial grid (on date) on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_equatorial_J2000_grid
|flag_nebula_display_no_texture
+
 
  |bool
 
  |bool
  |set to ''true'' to suppress displaying of nebula textures
+
  |0.10.2+
 +
|Set to ''true'' if you want to see the equatorial grid (J2000) on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_ecliptic_J2000_grid
|flag_milky_way
+
 
  |bool
 
  |bool
  |set to ''false'' to hide the Milky Way
+
  |0.11.3+
 +
|Set to ''true'' if you want to see the ecliptic grid (J2000) on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_galactic_grid
  |milky_way_intensity
+
  |bool
  |float
+
  |0.10.4+
|sets the relative brightness with which the milky way is drawn. Typical value: ''1'' to ''10''
+
  |Set to ''true'' if you want to see the galactic grid on start-up
|-
+
|[astro]
+
|max_mag_nebula_name
+
|float
+
|sets the magnitude of the nebulae whose name is shown. Typical value: ''8''
+
  |-
+
|[astro]
+
|nebula_scale
+
|float
+
|sets how much to scale nebulae. a setting of ''1'' will display nebulae at normal size
+
 
  |-
 
  |-
  |[astro]
+
  |flag_galactic_plane_line
|flag_bright_nebulae
+
 
  |bool
 
  |bool
  |set to ''true'' to increase nebulae brightness to enhance viewing (less realistic)
+
  |0.11.2+
 +
|Set to ''true'' if you want to see the galactic plane line on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_equator_line
|flag_nebula_ngc
+
 
  |bool
 
  |bool
  |enables/disables display of all NGC objects
+
  |''all''
 +
|Set to ''true'' if you want to see the equator line on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_ecliptic_line
|flag_telescopes
+
 
  |bool
 
  |bool
  |enables telescope control telescope control (if set to true stellarium will attempt to connect to a telescope server according to the values in the [telescopes] section of the config file
+
  |''all''
 +
|Set to ''true'' if you want to see the ecliptic line (J2000) on start-up
 
  |-
 
  |-
  |[astro]
+
  |flag_meridian_line
|flag_telescopes_name
+
 
  |bool
 
  |bool
  |enables/disables name labels on telescope indicators
+
  |0.8.0+
 +
|Set to ''true'' if you want to see the meridian line on start-up
 
  |-
 
  |-
  |[telescopes]
+
  |flag_cardinal_points
  |(telescope number)
+
  |bool
  |string
+
  |''all''
  |In this section the ID is the number of the telescope and the value is a colon separated list of parameters: name, protocol, hostname, port number, delay.
+
  |Set to ''false'' if you don't want to see the cardinal points
 
  |-
 
  |-
  |[telescopes]
+
  |flag_gravity_labels
  |''x''_ocular_''y''
+
|bool
  |float
+
  |''all''
  |Set the size of a field-of-view marker circle for telescope number ''x''. More than one marker can be defined for each telescope by using values 1, 2, ... for ''y''.
+
|Set to ''true'' if you want labels to undergo gravity (top side of text points toward zenithzenith). Useful with dome projection.
|-
+
  |- class="deprecated"
  |[init_location]
+
  |flag_init_moon_scaled
  |name
+
|bool
 +
|0.6.2
 +
|Change to ''false'' if you want to see the real moon size on start-up
 +
  |- class="deprecated"
 +
  |viewing_mode
 
  |string
 
  |string
  |sets your location's name. This is an arbitrary string, For example, ''Paris''
+
  |0.6.2
 +
|
 
  |-
 
  |-
  |[init_location]
+
  |flag_moon_scaled
  |latitude
+
  |bool
  |DMS
+
  |0.7.1+
  |sets the latitude coordinate of the observer. Value is in degrees, minutes, seconds. Positive degree values mean North / negative South. e.g. ''+55d14'30.00"''
+
  |Change to ''false'' if you want to see the real moon size on start-up
 
  |-
 
  |-
  |[init_location]
+
  |moon_scale
  |longitude
+
  |float
  |DMS
+
  |''all''
  |sets the longitude coordinate of the observer. Value is in degrees, minutes, seconds. Positive degree values mean East / negative West. e.g. ''-01d37'6.00"''
+
  |Sets the moon scale factor, to correlate to our perception of the moon's size. Typical value: ''4''
 
  |-
 
  |-
  |[init_location]
+
  |constellation_art_intensity
|altitude
+
 
  |float
 
  |float
  |observer's altitude above mean sea level in meters, e.g. ''53''
+
  |''all''
 +
|This number multiplies the brightness of the constellation art  images. Typical value: ''0.5''
 
  |-
 
  |-
  |[init_location]
+
  |constellation_art_fade_duration
  |landscape_name
+
  |float
  |string
+
  |''all''
  |sets the landscape you see. Other options are ''garching, guereins, trees, moon, ocean, hurricane, hogerielen''
+
  |Sets the amount of time the constellation art takes to fade in or out, in seconds. Typical value: ''1.5''
 
  |-
 
  |-
  |[init_location]
+
  |constellation_font_size
  |time_zone
+
  |int
  |string
+
  |''all''
|sets the time zonetime zone. Valid values: ''system_default'', or some region/location combination, e.g. ''Pacific/Marquesas''
+
|Set font size for constellation labels
 +
|- class="deprecated"
 +
|flag_chart
 +
|bool
 +
|0.8.0
 +
|Enable chart mode on startup
 
  |-
 
  |-
  |[init_location]
+
  |flag_night
  |time_display_format
+
  |bool
  |string
+
  |''all''
  |set the time display formattime display format mode: can be ''system_default'', ''24h'' or ''12h''.
+
  |Enable night mode on startup
 
  |-
 
  |-
  |[init_location]
+
  |light_pollution_luminance
  |date_display_format
+
  |float
  |string
+
  |0.9.0+
  |set the date display format mode: can be ''system_default'', ''mddyyyy'', ''ddmmyyyy'' or ''yyyymmdd'' (ISO8601).
+
  |Sets the level of the light pollution simulation
 
  |-
 
  |-
  |[init_location]
+
  |use_luminance_adaptation
  |home_planet
+
  |bool
  |string
+
  |0.9.0+
  |name of solar system body on which to start stellarium. This may be set at runtime from the TUI menu.
+
  |Enable dynamic eye adaptation.
 
  |-
 
  |-
  |[files]
+
  |flag_render_solar_shadows
|removable_media_path
+
|string
+
|Path to removable mediaremovable media (CD/DVD). This is usually only used in Digitalis planetariums products.
+
|-
+
|[files]
+
|scripts_can_write_files
+
 
  |bool
 
  |bool
  |Some scripting commands will cause files to be written. Unless this option is set to true, these scripting commands will fail.
+
  |0.12.0+
  |-
+
  |Enable render of the solar shadows.
|[proxy]
+
|host_name
+
|string
+
|Name of host for proxy, e.g. ''proxy.org''
+
|-
+
|[proxy]
+
|port
+
|integer
+
|Port of proxy, e.g. ''8080''
+
|-
+
|[proxy]
+
|user
+
|string
+
|Username for proxy, e.g. ''michael_knight''
+
|-
+
|[proxy]
+
|password
+
|string
+
|Password for proxy, e.g. ''xxxxx''
+
 
  |}
 
  |}
 +
 +
==Notes==
 +
<references/>
  
 
{{Template:LRCNavigation|Advanced Use|Stellarium User Guide|Precision}}
 
{{Template:LRCNavigation|Advanced Use|Stellarium User Guide|Precision}}
  
 
[[Category:Stellarium User Guide]]
 
[[Category:Stellarium User Guide]]

Latest revision as of 14:11, 15 September 2014

See Advanced Use, The Main Configuration File for information about this file, including its default installed location, name, and command line options that can effect how it is processed.

Deprecate parameters marked by gray background. Possible new parameters marked by yellow background.

Information is actual for version 0.13.0

Contents

[edit] Section [astro]

ID Type Version Description
nebula_magnitude_limit float 0.12.1+ Value of limit magnitude of the deep-sky objects
star_magnitude_limit float 0.12.1+ Value of limit magnitude of the stars
flag_nebula_magnitude_limit bool 0.12.1+ Set to true to set limits for showing deep-sky objects
flag_star_magnitude_limit bool 0.12.1+ Set to true to set limits for showing stars
flag_extinction_below_horizon bool 0.11.2+ Set to true to apply extinction effects to sky below horizon
extinction_mode_below_horizon string 0.13.0+ Set extinction mode for atmosphere below horizon. Possible values: zero, mirror and max. Default value is zero.
flag_stars bool all Set to false to hide the stars on start-up
flag_star_name bool all Set to false to hide the star labels on start-up
flag_planets bool all Set to false to hide the planet labels on start-up
flag_planets_hints bool all Set to false to hide the planet hints on start-up (names and circular highlights)
flag_planets_orbits bool all Set to true to show the planet orbits on start-up
flag_planets_markers bool 0.13.0+ Set to true to show the planet pointer markers on start-up
planet_pointers_color float R,G,B 0.13.0+ Sets the colour of the planet pointers in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
flag_light_travel_time bool 0.8.0+ Set to true to improve accuracy in the movement of the planets by compensating for the time it takes for light to travel. This has an impact on performance.
flag_object_trails bool 0.8.0+ Turns on and off drawing of object trails (which show the movement of the planets over time)
flag_nebula bool all Set to false to hide the nebulae on start-up
flag_nebula_name bool all Set to true to show the nebula labels on start-up
flag_nebula_long_name bool 0.8.0+ Set to true to show the nebula long labels on start-up
flag_nebula_display_no_texture bool 0.8.0+ Set to true to suppress displaying of nebula textures
flag_milky_way bool all Set to false to hide the Milky Way
milky_way_intensity float 0.8.0+ Sets the relative brightness with which the milky way is drawn. Typical value: 1 to 10
max_mag_nebula_name float all Sets the magnitude of the nebulae whose name is shown. Typical value: 8
nebula_scale float 0.8.0+ Sets how much to scale nebulae. a setting of 1 will display nebulae at normal size
flag_bright_nebulae bool all Set to true to increase nebulae brightness to enhance viewing (less realistic)
flag_nebula_ngc bool 0.8.0+ Enables/disables display of all NGC objects

[edit] Section [chart_color]

ID Type Version Description
azimuthal_color float R,G,B 0.8.0 Sets the colour of the azimuthal grid in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
gui_base_color float R,G,B 0.8.0 These three numbers determine the colour of the interface in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
gui_text_color float R,G,B 0.8.0 These three numbers determine the colour of the text in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
equatorial_color float R,G,B 0.8.0 Sets the colour of the equatorial gride in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
equator_color float R,G,B 0.8.0 Sets the colour of the equatorial line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
ecliptic_color float R,G,B 0.8.0 Sets the colour of the ecliptic line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
meridian_color float R,G,B 0.8.0 Sets the colour of the meridian line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
const_lines_color float R,G,B 0.8.0 Sets the colour of the constellation lines in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
const_names_color float R,G,B 0.8.0 Sets the colour of the constellation names in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
const_boundary_color float R,G,B 0.8.0 Sets the colour of the constellation boundaries in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
nebula_label_color float R,G,B 0.8.0 Sets the colour of the nebula labels in RGB values, where "1" is the maximum, e.g. 1.0,1.0,1.0 for white
nebula_circle_color float R,G,B 0.8.0 Sets the colour of the circle of the nebula labels in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
star_label_color float R,G,B 0.8.0 Sets the colour of the star labels in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
star_circle_color float R,G,B 0.8.0 Sets the colour of the circle of the star labels in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
cardinal_color float R,G,B 0.8.0 Sets the colour of the cardinal points in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
planet_names_color float R,G,B 0.8.0 Sets the colour of the planet names in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
planet_orbits_color float R,G,B 0.8.0 Sets the colour of the orbits in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
object_trails_color float R,G,B 0.8.0 Sets the colour of the planet trails in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
chart_color float R,G,B 0.8.0 Sets the colour of the chart in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
telescope_circle_color float R,G,B 0.8.0 Sets the colour of the telescope location indicator. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
telescope_label_color float R,G,B 0.8.0 Sets the colour of the telescope location label. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white

[edit] Sections [color] and [night_color][1]

ID Type Version Description
default_color float R,G,B 0.9.0+ Sets the default colour in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
azimuthal_color float R,G,B all Sets the colour of the azimuthal grid in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
gui_base_color float R,G,B 0.10.1+ These three numbers determine the colour of the interface in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
gui_text_color float R,G,B 0.10.1+ These three numbers determine the colour of the text in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
equatorial_color float R,G,B all Sets the colour of the equatorial grid (on date) in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
equatorial_J2000_color float R,G,B 0.10.2+ Sets the colour of the equatorial grid (J2000) in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
galactic_color float R,G,B 0.10.4+ Sets the colour of the galactic grid in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
galactic_plane_color float R,G,B 0.11.2+ Sets the colour of the galactic plane line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
equator_color float R,G,B all Sets the colour of the equatorial line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
ecliptic_color float R,G,B all Sets the colour of the ecliptic line (J2000) in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
ecliptic_J2000_color float R,G,B 0.11.3+ Sets the colour of the ecliptic grid (J2000) in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
meridian_color float R,G,B all Sets the colour of the meridian line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
horizon_color float R,G,B 0.11.0+ Sets the colour of the horizon line in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
const_lines_color float R,G,B all Sets the colour of the constellation lines in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
const_names_color float R,G,B all Sets the colour of the constellation names in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
const_boundary_color float R,G,B all Sets the colour of the constellation boundaries in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
nebula_label_color float R,G,B all Sets the colour of the nebula labels in RGB values, where "1" is the maximum, e.g. 1.0,1.0,1.0 for white
nebula_circle_color float R,G,B all Sets the colour of the circle of the nebula labels in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
star_label_color float R,G,B all Sets the colour of the star labels in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
star_circle_color float R,G,B 0.8.0 Sets the colour of the circle of the star labels in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
cardinal_color float R,G,B all Sets the colour of the cardinal points in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
planet_names_color float R,G,B all Sets the colour of the planet names in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
planet_orbits_color float R,G,B all Sets the colour of the orbits in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
object_trails_color float R,G,B all Sets the colour of the planet trails in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
chart_color float R,G,B 0.8.0-0.8.2 Sets the colour of the chart in RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
telescope_circle_color float R,G,B all Sets the colour of the telescope location indicator. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
telescope_label_color float R,G,B all Sets the colour of the telescope location label. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
script_console_keyword_color float R,G,B 0.10.5+ Sets the colour of the keywords in the script console. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
script_console_module_color float R,G,B 0.10.5+ Sets the colour of the modules in the script console. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
script_console_comment_color float R,G,B 0.10.5+ Sets the colour of the comments in the script console. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
script_console_function_color float R,G,B 0.10.5+ Sets the colour of the functions in the script console. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
script_console_constant_color float R,G,B 0.10.5+ Sets the colour of the constants in the script console. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white
daylight_color float R,G,B 0.13.1+ Sets the colour of the info text at daylight. RGB values, where 1 is the maximum, e.g. 1.0,1.0,1.0 for white

[edit] Section [custom_selected_info]

ID Type Version Description
flag_show_absolutemagnitude bool 0.11.3+ If true, Stellarium will be show absolute magnitude for objects.
flag_show_altaz bool 0.11.3+ If true, Stellarium will be show horizontal coordinates for objects.
flag_show_catalognumber bool 0.11.3+ If true, Stellarium will be show catalog designations for objects.
flag_show_distance bool 0.11.3+ If true, Stellarium will be show distance to object.
flag_show_extra1 bool 0.11.3+ If true, Stellarium will be show extra info for object.
flag_show_extra2 bool 0.11.3+ If true, Stellarium will be show extra info for object.
flag_show_extra3 bool 0.11.3+ If true, Stellarium will be show extra info for object.
flag_show_hourangle bool 0.11.3+ If true, Stellarium will be show hour angles for object.
flag_show_magnitude bool 0.11.3+ If true, Stellarium will be show magnitude for object.
flag_show_name bool 0.11.3+ If true, Stellarium will be show common name for object.
flag_show_radecj2000 bool 0.11.3+ If true, Stellarium will be show geocentrical equatorial coordinates (J2000) of object.
flag_show_radecofdate bool 0.11.3+ If true, Stellarium will be show geocentrical equatorial coordinates (of date) of object.
flag_show_size bool 0.11.3+ If true, Stellarium will be show size of object.

[edit] Section [custom_time_correction]

ID Type Version Description
coefficients [float,float,float] 0.12.1+ Coefficients for custom equation of DeltaT
ndot float 0.12.1+ n-dot value for custom equation of DeltaT
year int 0.12.1+ Year for custom equation of DeltaT

[edit] Section [files]

ID Type Version Description
removable_media_path string 0.9.0+ Path to removable mediaremovable media (CD/DVD). This is usually only used in Digitalis planetariums products.
scripts_can_write_files bool 0.9.0+ Some scripting commands will cause files to be written. Unless this option is set to true, these scripting commands will fail.

[edit] Section [gui]

ID Type Version Description
base_font_size int all Sets the font size. Typical value: 15
base_font_name string 0.8.0-0.11.4 Selects the name for font file, e.g. DejaVuSans.ttf
0.12.0+ Selects the name for base font, e.g. DejaVu Sans
safe_font_name string 0.12.0+ Selects the name for safe font, e.g. Verdana
base_font_file string 0.12.0+ Selects the name for font file, e.g. DejaVuSans.ttf
flag_show_fps bool all Set to false if you don't want to see at how many frames per second Stellarium is rendering
flag_show_fov bool all Set to false if you don't want to see how many degrees your field of view is
flag_show_script_bar bool 0.7.1-0.10.0 Set to true if you want to have access to the script bar
flag_mouse_cursor_timeout float 0.8.0+ set to 0 if you want to keep the mouse cursor visible at all times. non-0 values mean the cursor will be hidden after that many seconds of inactivity
flag_script_allow_ui bool 0.8.0-0.10.0 When set to false the normal movement controls will be disabled when a script is playing true enables them
flag_show_flip_buttons bool 0.8.2+ Enables/disables display of the image flipping buttons in the main toolbar (see section [sec:imageflipping])
flag_show_nebulae_background_button bool 0.10.1+ Set to true if you want to have access to the button for enabling/disabling backgrounds for deep-sky objects
flag_use_degrees bool 0.12.2+
selected_object_info string 0.10.0+ Values: all, short and none. Value custom added since version 0.12.0.
auto_hide_horizontal_toolbar bool 0.10.1+ Set to true if you want auto hide the horizontal toolbar.
auto_hide_vertical_toolbar bool 0.10.1+ Set to true if you want auto hide the vertical toolbar.
day_key_mode string 0.9.0+ Specifies the amount of time which is added and subtracted when the [ ] - and = keys are pressed - calendar days, or sidereal days. This option only makes sense for Digitalis planetariums. Values: calendar or sidereal
flag_menu bool 0.6.2-0.10.0
flag_help bool 0.6.2-0.10.0
flag_infos bool 0.6.2-0.10.0
flag_show_topbar bool 0.6.2-0.10.0
flag_show_time bool 0.6.2-0.10.0
flag_show_date bool 0.6.2-0.10.0
flag_show_appname bool 0.6.2-0.10.0
flag_show_selected_object_info bool 0.6.2-0.10.0
gui_base_color float R,G,B 0.6.2-0.10.0
gui_text_color float R,G,B 0.6.2-0.10.0
flag_use_window_transparency bool 0.13.0+ Set to false if you want see the opacity for bars
flag_show_datetime bool 0.13.1+ Set to true if you want display date and time in the bottom bar
flag_time_jd bool 0.13.1+ Set to true if you want using JD format for time in the bottom bar
flag_show_location bool 0.13.1+ Set to true if you want display location in the bottom bar
flag_fov_dms bool 0.13.1+ Set to true if you want using DMS format for FOV in the bottom bar

[edit] Section [init_location]

ID Type Version Description
name string 0.6.2-0.10.0 Sets your location's name. This is an arbitrary string, For example, Paris
latitude DMS 0.6.2-0.9.1 Sets the latitude coordinate of the observer. Value is in degrees, minutes, seconds. Positive degree values mean North / negative South. e.g. +55d14'30.00"
longitude DMS 0.6.2-0.9.1 Sets the longitude coordinate of the observer. Value is in degrees, minutes, seconds. Positive degree values mean East / negative West. e.g. -01d37'6.00"
altitude float 0.6.2-0.9.1 Observer's altitude above mean sea level in meters, e.g. 53
landscape_name string all sets the landscape you see. Other options are garching, guereins, trees, moon, ocean, hurricane, hogerielen
time_zone string 0.6.2-0.9.1 Sets the time zonetime zone. Valid values: system_default, or some region/location combination, e.g. Pacific/Marquesas
time_display_format string 0.6.2-0.9.1 Set the time display formattime display format mode: can be system_default, 24h or 12h.
date_display_format string 0.6.2-0.9.1 Set the date display format mode: can be system_default, mddyyyy, ddmmyyyy or yyyymmdd (ISO8601).
home_planet string 0.6.2-0.9.1 Name of solar system body on which to start stellarium. This may be set at runtime from the TUI menu.
location string 0.10.1+ Name of location on which to start stellarium.
last_location string 0.13.1+ Coordinates of last used location in stellarium.

[edit] Section [landscape]

ID Type Version Description
flag_landscape bool all Set to false if you don't want to see the landscape at all
flag_fog bool all Set to false if you don't want to see fog on start-up
flag_atmosphere bool all Set to false if you don't want to see atmosphere on start-up
flag_landscape_sets_location bool all Set to true if you want Stellarium to modify the observer location when a new landscape is selected (changes planet and longitude/latitude/altitude if that data is available in the landscape.ini file)
initial_brightness float 0.12.1+ Set initial brightness for landscapes. Typical value: 0.01
atmospheric_extinction_coefficient float 0.11.0+ Set atmospheric extinction coefficient
temperature_C float 0.11.0+ Set atmospheric temperature (Celsius)
pressure_mbar float 0.11.0+ Set atmospheric pressure (mbar)

[edit] Section [localization]

ID Type Version Description
sky_culture string all Sets the sky culture to use. E.g. western, polynesian, egyptian, chinese, lakota, navajo, inuit, korean, norse, tupi, maori, aztec, sami.
sky_locale string all Sets language used for names of objects in the sky (e.g. planets). The value is a short locale code, e.g. en, de, en_GB
app_locale string all Sets language used for Stellarium's user interface. The value is a short locale code, e.g. en, de, en_GB.
time_zone string 0.10.6+ Sets the time zone. Valid values: system_default, or some region/location combination, e.g. Pacific/Marquesas
time_display_format string 0.10.6+ Set the time display format mode: can be system_default, 24h or 12h.
date_display_format string 0.10.6+ Set the date display format mode: can be system_default, mmddyyyy, ddmmyyyy or yyyymmdd (ISO8601).

[edit] Section [main]

ID Type Version Description
invert_screenshots_colors bool 0.10.1+ If true, Stellarium will saving the screenshorts with inverted colors.
restore_defaults bool 0.10.1+ If true, Stellarium will be restore default settings at startup.
screenshot_dir string 0.10.1+ Path for saving screenshots
version string all Version of Stellarium. This parameter using for updating config.ini file
use_separate_output_file bool 0.13.1+ Set to true if you want to create a new file for output for each start of Stellarium

[edit] Section [navigation]

ID Type Version Description
preset_sky_time float all Preset sky time used by the dome version. Unit is Julian Day. Typical value: 2451514.250011573
startup_time_mode string all Set the start-up time mode, can be actual (start with current real world time), or Preset (start at time defined by preset_sky_time)
flag_enable_zoom_keys bool all Set to false if you want to disable the zoom
flag_manual_zoom bool all Set to false for normal zoom behaviour as described in this guide. When set to true, the auto zoom feature only moves in a small amount and must be pressed many times
flag_enable_move_keys bool all Set to false if you want to disable the arrow keys
flag_enable_mouse_navigation bool all Set to false if you want to disable the mouse navigation.
init_fov float all Initial field of view, in degrees, typical value: 60
init_view_pos floats all Initial viewing direction. This is a vector with x,y,z-coordinates. x being N-S (S +ve), y being E-W (E +ve), z being up-down (up +ve). Thus to look South at the horizon use 1,0,0. To look Northwest and up at 45°, use -1,-1,1 and so on.
auto_move_duration float all Duration for the program to move to point at an object when the space bar is pressed. Typical value: 1.4
mouse_zoom float all Sets the mouse zoom amount (mouse-wheel)
move_speed float all Sets the speed of movement
zoom_speed float all Sets the zoom speed
viewing_mode string all If set to horizon, the viewing mode simulate an alt/azi mount, if set to equator, the viewing mode simulates an equatorial mount
flag_manual_zoom bool all Set to true if you want to auto-zoom in incrementally.
auto_zoom_out_resets_direction bool all Set to true if you want to auto-zoom restoring direction.
time_correction_algorithm string 0.12.1+ Algorithm of DeltaT correction.

[edit] Section [plugins_load_at_startup]

ID Type Version Description
AngleMeasure bool 0.10.3+ If true, Stellarium will be load Angle Measure plugin at startup.
CompassMarks bool 0.10.3+ If true, Stellarium will be load Compass Marks plugin at startup.
Exoplanets bool 0.11.4+ If true, Stellarium will be load Exoplanets plugin at startup.
Observability bool 0.11.4+ If true, Stellarium will be load Observability Analysis plugin at startup.
Oculars bool 0.10.3+ If true, Stellarium will be load Oculars plugin at startup.
Pulsars bool 0.11.2+ If true, Stellarium will be load Pulsars plugin at startup.
Quasars bool 0.11.2+ If true, Stellarium will be load Quasars plugin at startup.
Satellites bool 0.10.3+ If true, Stellarium will be load Satellites plugin at startup.
SolarSystemEditor bool 0.10.6+ If true, Stellarium will be load Solar System Editor plugin at startup.
Supernovae bool 0.11.0+ If true, Stellarium will be load Historical Supernovae plugin at startup.
TelescopeControl bool 0.10.3+ If true, Stellarium will be load Telescope Control plugin at startup.
TextUserInterface bool 0.10.3+ If true, Stellarium will be load Text User Interface plugin at startup.
TimeZoneConfiguration bool 0.10.6+ If true, Stellarium will be load Time Zone plugin at startup.
Novae bool 0.12.3+ If true, Stellarium will be load Bright Novae plugin at startup.

[edit] Section [projection]

ID Type Version Description
type string 0.8.0+ Sets projection mode. Values: perspective, equal_area, stereographic, fisheye, cylinder, mercator, or orthographic.
0.10.3+ Sets projection mode. Values: ProjectionPerspective, ProjectionEqualArea, ProjectionStereographic, ProjectionFisheye, ProjectionHammer, ProjectionCylinder, ProjectionMercator or ProjectionOrthographic.
viewport string all How the view-port looks. Values: none, disk.
viewportMask string all How the view-port looks. Values: none.
flag_use_gl_point_sprite bool all
flip_horz bool all
flip_vert bool all

[edit] Section [proxy]

ID Type Version Description
host_name string 0.10.3+ Name of host for proxy. E.g. proxy.org
port int 0.10.3+ Port of proxy. E.g. 8080
user string 0.10.3+ Username for proxy. E.g. michael_knight
password string 0.10.3+ Password for proxy. E.g. xxxxx

[edit] Section [scripts]

ID Type Version Description
flag_script_allow_ui bool 0.9.1+
scripting_allow_write_files bool 0.9.1+

[edit] Section [search]

ID Type Version Description
flag_search_online bool 0.11.2+ If true, Stellarium will be use SIMBAD for search.
simbad_server_url string 0.11.2+ URL for SIMBAD mirror
flag_start_words bool 0.12.3+ If false, Stellarium will be search phrase only from start of words
coordinate_system string 0.13.1+ Specifies the coordinate system. Possible values: equatorialJ2000, equatorial, horizontal, galactic. Default value: equatorialJ2000.

[edit] Section [spheric_mirror]

ID Type Version Description
distorter_max_fov float all Set the maximum field of view for the spheric mirror distorter in degrees. Typical value, 180
flag_use_ext_framebuffer_object bool all Some video hardware incorrectly claims to support some GL extension, GL_FRAMEBUFFER_EXTEXT. If, when using the spheric mirror distorter the frame rate drops to a very low value (e.g. 0.1 FPS), set this parameter to false to tell Stellarium ignore the claim of the video driver that it can use this extension
flip_horz bool all Flip the projection horizontally
flip_vert bool all Flip the projection vertically
projector_gamma float all This parameter controls the properties of the spheric mirror projection mode.
projector_position_x float all
projector_position_y float all
projector_position_z float all
mirror_position_x float all
mirror_position_y float all
mirror_position_z float all
mirror_radius float all
dome_radius float all
zenith_y float all
scaling_factor float all

[edit] Section [stars]

ID Type Version Description
relative_scale float all Changes the relative size of bright and faint stars. Higher values mean that bright stars are comparitively larger when rendered. Typical value: 1.0
absolute_scale float all Changes how large stars are rendered. larger value lead to larger depiction. Typical value: 1.0
star_twinkle_amount float all Sets the amount of twinkling. Typical value: 0.3
flag_star_twinkle bool all Set to false to turn star twinkling off, true to allow twinkling.
flag_point_star bool all Set to false to draw stars at a size that corresponds to their brightness. When set to true all stars are drawn at single pixel size
mag_converter_max_fov float all Sets the maximum field of view for which the magnitude conversion routine is used. Typical value: 90.0.
mag_converter_min_fov float all Sets the minimum field of view for which the magnitude conversion routine is used. Typical value: 0.001.
labels_amount float all Sets the amount of labels. Typical value: 3.0
init_bortle_scale int all Sets the initial value of the bortle scale. Typical value: 3.

[edit] Section [tui]

ID Type Version Description
flag_enable_tui_menu bool prior 0.9.1; 0.10.3+ Enables or disables the TUI menu
flag_show_gravity_ui bool prior 0.9.1; 0.10.3+ Enables or disables gravity mode for UI
flag_show_tui_datetime bool prior 0.9.1; 0.10.3+ Set to true if you want to see a date and time label suited for dome projections
flag_show_tui_short_obj_info bool prior 0.9.1; 0.10.3+ set to true if you want to see object info suited for dome projections

[edit] Section [video]

ID Type Version Description
fullscreen bool all If true, Stellarium will start up in full-screen mode. If false, Stellarium will start in windowed mode
screen_w int all Sets the display width when in windowed mode. Value in pixels, e.g. 1024
screen_h int all Sets the display height when in windowed mode. Value in pixels, e.g. 768
screen_x int all Value in pixels, e.g. 0
screen_y int all Value in pixels, e.g. 0
horizontal_offset int all Value in pixels, e.g. 0
vertical_offset int all Value in pixels, e.g. 0
distorter string 0.8.0-0.10.2 This is used when the spheric mirror display mode is activated. Values include none and fisheye_to_spheric_mirror.
viewport_effect string 0.10.3+ This is used when the spheric mirror display mode is activated. Values include none and sphericMirrorDistorter.
minimum_fps int all Sets the minimum number of frames per second to display at (hardware performance permitting)
maximum_fps int all Sets the maximum number of frames per second to display at. This is useful to reduce power consumption in laptops.

[edit] Section [viewing]

ID Type Version Description
atmosphere_fade_duration float 0.8.0+ Sets the time it takes for the atmosphere to fade when de-selected
flag_constellation_drawing bool all Set to true if you want to see the constellation line drawing on start-up
flag_constellation_name bool all Set to true if you want to see the constellation names on start-up
flag_constellation_art bool all Set to true if you want to see the constellation art on start-up
flag_constellation_boundaries bool 0.8.0+ Set to true if you want to see the constellation boundaries on start-up
flag_constellation_isolate_selected bool all When set to true, constellation lines, boundaries and art will be limited to the constellation of the selected star, if that star is ”on” one of the constellation lines.
flag_constellation_pick bool 0.6.2-0.7.1 Set to true if you only want to see the line drawing, art and name of the selected constellation star
flag_azimutal_grid bool all Set to true if you want to see the azimuthal grid on start-up
flag_equatorial_grid bool all Set to true if you want to see the equatorial grid (on date) on start-up
flag_equatorial_J2000_grid bool 0.10.2+ Set to true if you want to see the equatorial grid (J2000) on start-up
flag_ecliptic_J2000_grid bool 0.11.3+ Set to true if you want to see the ecliptic grid (J2000) on start-up
flag_galactic_grid bool 0.10.4+ Set to true if you want to see the galactic grid on start-up
flag_galactic_plane_line bool 0.11.2+ Set to true if you want to see the galactic plane line on start-up
flag_equator_line bool all Set to true if you want to see the equator line on start-up
flag_ecliptic_line bool all Set to true if you want to see the ecliptic line (J2000) on start-up
flag_meridian_line bool 0.8.0+ Set to true if you want to see the meridian line on start-up
flag_cardinal_points bool all Set to false if you don't want to see the cardinal points
flag_gravity_labels bool all Set to true if you want labels to undergo gravity (top side of text points toward zenithzenith). Useful with dome projection.
flag_init_moon_scaled bool 0.6.2 Change to false if you want to see the real moon size on start-up
viewing_mode string 0.6.2
flag_moon_scaled bool 0.7.1+ Change to false if you want to see the real moon size on start-up
moon_scale float all Sets the moon scale factor, to correlate to our perception of the moon's size. Typical value: 4
constellation_art_intensity float all This number multiplies the brightness of the constellation art images. Typical value: 0.5
constellation_art_fade_duration float all Sets the amount of time the constellation art takes to fade in or out, in seconds. Typical value: 1.5
constellation_font_size int all Set font size for constellation labels
flag_chart bool 0.8.0 Enable chart mode on startup
flag_night bool all Enable night mode on startup
light_pollution_luminance float 0.9.0+ Sets the level of the light pollution simulation
use_luminance_adaptation bool 0.9.0+ Enable dynamic eye adaptation.
flag_render_solar_shadows bool 0.12.0+ Enable render of the solar shadows.

[edit] Notes

  1. Section [night_color] was removed since version 0.13.0.
Personal tools
Namespaces
Variants
Actions
in this wiki
other languages
Toolbox