Configuration file
From Stellarium Wiki
Information is actual for version 0.10.6
| Section | ID | Type | Description |
|---|---|---|---|
| [video] | fullscreen | boolean | if true, Stellarium will start up in full-screen mode. If false, Stellarium will start in windowed mode |
| [video] | screen_w | integer | sets the display width when in windowed mode (value in pixels, e.g. 1024) |
| [video] | screen_h | integer | sets the display height when in windowed mode (value in pixels, e.g. 768) |
| [video] | distorter | string | This is used when the spheric mirror display mode is activated. Values include none and fisheye_to_spheric_mirror |
| [video] | minimum_fps | integer | sets the minimum number of frames per second to display at (hardware performance permitting) |
| [video] | 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 | sets projection mode. Values: perspective, equal_area, stereographic, fisheye, cylinder, mercator, or orthographic. |
| [projection] | viewport | string | how the view-port looks. Values: maximized, disk |
| [spheric_mirror] | distorter_max_fov | float | Set the maximum field of view for the spheric mirror distorter in degrees. Typical value, 180 |
| [spheric_mirror] | flag_use_ext_framebuffer_object | boolean | 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 |
| [spheric_mirror] | flip_horz | boolean | Flip the projection horizontally |
| [spheric_mirror] | flip_vert | boolean | Flip the projection vertically |
| [spheric_mirror] | projector_gamma | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | projector_position_x | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | projector_position_y | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | projector_position_z | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | mirror_position_x | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | mirror_position_y | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | mirror_position_z | float | This parameter controls the properties of the spheric mirror projection mode |
| [spheric_mirror] | 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 data/skycultures.fab. 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 | set to false to turn star twinkling off, true to allow twinkling. |
| [stars] | flag_point_star | 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 |
| [stars] | mag_converter_max_fov | float | sets the maximum field of view for which the magnitude conversion routine is used |
| [stars] | mag_converter_min_fov | float | sets the maximum field of view for which the magnitude conversion routine is used |
| [gui] | base_font_size | int | sets the font size. Typical value: 15 |
| [gui] | base_font_name | string | Selects the font, 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 | 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 |
| [gui] | flag_script_allow_ui | bool | when set to false the normal movement controls will be disabled when a script is playing true enables them |
| [gui] | flag_show_flip_buttons | bool | enables/disables display of the image flipping buttons in the main toolbar (see section [sec:imageflipping]) |
| [gui] | day_key_mode | string | 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 |
| [color]
[night_color] [chart_color] |
azimuthal_color | 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 |
| [color]
[night_color] [chart_color] |
gui_base_color | 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 |
| [color]
[night_color] [chart_color] |
gui_text_color | 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 |
| [color]
[night_color] [chart_color] |
equatorial_color | 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 |
| [color]
[night_color] [chart_color] |
equator_color | 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 |
| [color]
[night_color] [chart_color] |
ecliptic_color | 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 |
| [color]
[night_color] [chart_color] |
meridian_color | 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 |
| [color]
[night_color] [chart_color] |
const_lines_color | 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 |
| [color]
[night_color] [chart_color] |
const_names_color | 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 |
| [color]
[night_color] [chart_color] |
const_boundary_color | 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 |
| [color]
[night_color] [chart_color] |
nebula_label_color | 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 |
| [color]
[night_color] [chart_color] |
nebula_circle_color | 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 |
| [color]
[night_color] [chart_color] |
star_label_color | 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 |
| [color]
[night_color] [chart_color] |
star_circle_color | 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 |
| [color]
[night_color] [chart_color] |
cardinal_color | 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 |
| [color]
[night_color] [chart_color] |
planet_names_color | 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 |
| [color]
[night_color] [chart_color] |
planet_orbits_color | 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 |
| [color]
[night_color] [chart_color] |
object_trails_color | 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 |
| [color]
[night_color] [chart_color] |
chart_color | 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 |
| [color]
[night_color] [chart_color] |
telescope_circle_color | 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 |
| [color]
[night_color] [chart_color] |
telescope_label_color | 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 |
| [tui] | flag_enable_tui_menu | bool | enables or disables the TUI menu |
| [tui] | flag_show_gravity_ui | bool | [color][night_color][chart_color] |
| [tui] | flag_show_tui_datetime | bool | set to true if you want to see a date and time label suited for dome projections |
| [tui] | flag_show_tui_short_obj_info | bool | set to true if you want to see object info suited for dome projections |
| [navigation] | preset_sky_time | float | preset sky time used by the dome version. Unit is Julian Day. Typical value: 2451514.250011573 |
| [navigation] | startup_time_mode | 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) |
| [navigation] | flag_enable_zoom_keys | bool | set to false if you want to disable the zoom |
| [navigation] | flag_manual_zoom | 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 |
| [navigation] | flag_enable_move_keys | bool | set to false if you want to disable the arrow keys |
| [navigation] | flag_enable_move_mouse | bool | doesn't seem to do very much |
| [navigation] | init_fov | float | initial field of view, in degrees, typical value: 60 |
| [navigation] | init_view_pos | 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°, use -1,-1,1 and so on. |
| [navigation] | auto_move_duration | float | duration for the program to move to point at an object when the space bar is pressed. Typical value: 1.4 |
| [navigation] | mouse_zoom | float | Sets the mouse zoom amount (mouse-wheel) |
| [navigation] | move_speed | float | Sets the speed of movement |
| [navigation] | zoom_speed | float | Sets the zoom speed |
| [navigation] | viewing_mode | string | 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 | bool | set to true if you want to auto-zoom in incrementally. |
| [landscape] | flag_langscape | bool | set to false if you don't want to see the landscape at all |
| [landscape] | flag_fog | bool | set to false if you don't want to see fog on start-up |
| [landscape] | flag_atmosphere | bool | set to false if you don't want to see atmosphere on start-up |
| [landscape] | flag_landscape_sets_location | 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) |
| [viewing] | atmosphere_fade_duration | float | sets the time it takes for the atmosphere to fade when de-selected |
| [viewing] | flag_constellation_drawing | bool | set to true if you want to see the constellation line drawing on start-up |
| [viewing] | flag_constellation_name | bool | set to true if you want to see the constellation names on start-up |
| [viewing] | flag_constellation_art | bool | set to true if you want to see the constellation art on start-up |
| [viewing] | flag_constellation_boundaries | bool | set to true if you want to see the constellation boundaries on start-up |
| [viewing] | flag_constellation_isolate_selected | bool | 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] | flag_constellation_pick | bool | set to true if you only want to see the line drawing, art and name of the selected constellation star |
| [viewing] | flag_azimutal_grid | bool | set to true if you want to see the azimuthal grid on start-up |
| [viewing] | flag_equatorial_grid | bool | set to true if you want to see the equatorial grid on start-up |
| [viewing] | flag_equator_line | bool | set to true if you want to see the equator line on start-up |
| [viewing] | flag_ecliptic_line | bool | set to true if you want to see the ecliptic line on start-up |
| [viewing] | flag_meridian_line | bool | set to true if you want to see the meridian line on start-up |
| [viewing] | flag_cardinal_points | bool | set to false if you don't want to see the cardinal points |
| [viewing] | flag_gravity_labels | bool | set to true if you want labels to undergo gravity (top side of text points toward zenithzenith). Useful with dome projection. |
| [viewing] | flag_moon_scaled | bool | change to false if you want to see the real moon size on start-up |
| [viewing] | moon_scale | float | sets the moon scale factor, to correlate to our perception of the moon's size. Typical value: 4 |
| [viewing] | constellation_art_intensity | float | this number multiplies the brightness of the constellation art images. Typical value: 0.5 |
| [viewing] | constellation_art_fade_duration | float | sets the amount of time the constellation art takes to fade in or out, in seconds. Typical value: 1.5 |
| [viewing] | flag_chart | bool | enable chart mode on startup |
| [viewing] | flag_night | bool | enable night mode on startup |
| [viewing] | light_pollution_luminance | float | sets the level of the light pollution simulation |
| [astro] | flag_stars | bool | set to false to hide the stars on start-up |
| [astro] | flag_star_name | bool | set to false to hide the star labels on start-up |
| [astro] | flag_planets | bool | set to false to hide the planet labels on start-up |
| [astro] | flag_planets_hints | bool | set to false to hide the planet hints on start-up (names and circular highlights) |
| [astro] | flag_planets_orbits | bool | set to true to show the planet orbits on start-up |
| [astro] | flag_light_travel_time | 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. |
| [astro] | flag_object_trails | bool | turns on and off drawing of object trails (which show the movement of the planets over time) |
| [astro] | flag_nebula | bool | set to false to hide the nebulae on start-up |
| [astro] | flag_nebula_name | bool | set to true to show the nebula labels on start-up |
| [astro] | flag_nebula_long_name | bool | set to true to show the nebula long labels on start-up |
| [astro] | flag_nebula_display_no_texture | bool | set to true to suppress displaying of nebula textures |
| [astro] | flag_milky_way | bool | set to false to hide the Milky Way |
| [astro] | milky_way_intensity | float | sets the relative brightness with which the milky way is drawn. Typical value: 1 to 10 |
| [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_bright_nebulae | bool | set to true to increase nebulae brightness to enhance viewing (less realistic) |
| [astro] | flag_nebula_ngc | bool | enables/disables display of all NGC objects |
| [astro] | flag_telescopes | 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 |
| [astro] | flag_telescopes_name | bool | enables/disables name labels on telescope indicators |
| [telescopes] | (telescope number) | string | 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. |
| [telescopes] | x_ocular_y | float | 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. |
| [init_location] | name | string | sets your location's name. This is an arbitrary string, For example, Paris |
| [init_location] | latitude | DMS | 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" |
| [init_location] | longitude | DMS | 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" |
| [init_location] | altitude | float | observer's altitude above mean sea level in meters, e.g. 53 |
| [init_location] | landscape_name | string | sets the landscape you see. Other options are garching, guereins, trees, moon, ocean, hurricane, hogerielen |
| [init_location] | time_zone | string | sets the time zonetime zone. Valid values: system_default, or some region/location combination, e.g. Pacific/Marquesas |
| [init_location] | time_display_format | string | set the time display formattime display format mode: can be system_default, 24h or 12h. |
| [init_location] | date_display_format | string | set the date display format mode: can be system_default, mddyyyy, ddmmyyyy or yyyymmdd (ISO8601). |
| [init_location] | home_planet | string | name of solar system body on which to start stellarium. This may be set at runtime from the TUI menu. |
| [files] | 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 | Some scripting commands will cause files to be written. Unless this option is set to true, these scripting commands will fail. |