1STELLARIUM(1)                                                    STELLARIUM(1)
2
3
4

NAME

6       stellarium - A real-time realistic planetarium
7

SYNOPSIS

9       stellarium [OPTIONS]
10

DESCRIPTION

12       Stellarium is a free GPL software which renders realistic skies in real
13       time with OpenGL. It is available for Linux/Unix, Windows and MacOSX.
14       With Stellarium, you really see what you can see with your eyes,
15       binoculars or a small telescope.
16

OPTIONS

18       -v, --version
19           Print program name and version and exit.
20
21       -h, --help
22           Print a brief synopsis of program options and exit.
23
24       -c, --config-file file
25           Use file for the config filename instead of the default config.ini.
26
27       -u, --user-dir dir
28           Use dir instead of the default user data directory
29           ($HOME/.stellarium/ on *nix operating systems).
30
31       -f, --full-screen yes|no
32           With argument yes or no over-rides the full screen setting in the
33           config file.  The setting is saved in the config-file and as such
34           will be the default for subsequent invocations of Stellarium.
35
36       --screenshot-dir dir
37           Set the directory into which screenshots will be saved to dir,
38           instead of the default (which is $HOME on *nix operating systems).
39
40       --home-planet planet-name
41           Specify observer planet. planet-name is an English name, and should
42           refer to an object defined in the ssystem.ini file.
43
44       --altitude alt
45           Specify the initial observer altitude, where alt is the altitude in
46           meters.
47
48       --longitude lon
49           Specify the initial observer longitude, where lon is the longitude.
50           The format is illustrated by this example: +4d16'12" which refers
51           to 4 degrees, 16 minutes and 12 arc seconds East.  Westerly
52           longitudes should be prefixed with "-".
53
54       --latitude lat
55           Specify the initial observer latitude, where lat is the latitude.
56           The format is illustrated by this example: +53d58'16.65" which
57           refers to 53 degrees, 58 minutes and 16.65 arc seconds North.
58           Southerly latitudes should be prefixed with "-".
59
60       --list-landscapes
61           Print a list of landscape names and exit.
62
63       --landscape name
64           Start Stellarium using landscape name.  Refer to --list-landscapes
65           for possible names.
66
67       --sky-date date
68           Specify sky date in format yyyymmdd.
69
70       --sky-time time
71           Specify sky time in format hh:mm:ss.
72
73       --fov fov
74           Specify the field of view (fov degrees).
75
76       --projection-type p
77           Specify projection type, p.  Permitted values of p are: equalarea,
78           stereographic, fisheye, cylinder, mercator, perspective, and
79           orthographic.
80

RETURN VALUE

82       0   Completed successfully.
83
84       not 0
85           Some sort of error.
86

FILES

88       Note: file locations on non-*nix operating systems (include OSX) may
89       vary.  Please refer to the Stellarium User Guide for more details, as
90       well as information on how to customise the Stellarium data files.
91
92       /   This is the Installation Data Directory set at compile-time.
93
94       $HOME/.stellarium/
95           This is the User Data Directory, which may be over-ridden using
96           command line option -u.  It contains the user's settings, extra
97           landscapes, scripts, and can also be used to over-ride data files
98           which are provided with the default install.
99
100       $HOME/.stellarium/config.ini
101           The default main configuration file is config.ini. Refer to -c
102           above to use a different filename and to -u to use a different User
103           Data Directory.
104
105       $HOME/
106           The default screenshot directory. Refer to --screenshot-dir to use
107           a different path.
108

SEE ALSO

110       celestia(1).
111

NOTES

113       Sources of more information:
114
115       Websites
116           Main website: <http://stellarium.org/>
117
118           Wiki: <http://stellarium.org/wiki/>
119
120           Forums: <http://sourceforge.net/forum/forum.php?forum_id=278769>
121
122           Downloads:
123           <https://sourceforge.net/project/showfiles.php?group_id=48857>
124
125           Support Requests:
126
127           Bug Tracker:
128
129       The Stellarium User Guide
130           Visit the downloads page to get a PDF copy of the Stellarium User
131           Guide.
132

BUGS

134       Please report bugs using the bug tracker link in the NOTES section of
135       this page.
136

AUTHOR

138       Fabien ChA~Xreau, Rob Spearman, Johan Meuris, Matthew Gates, Johannes
139       Gajdosik, Nigel Kerr, Andras Mohari.
140
141       x14817
142
143
144
1450.10.6                            2011-01-22                     STELLARIUM(1)
Impressum