STELLARIUM(1)

📦
version 26.3 · 16 versions
, in epel 10

🌌 STELLARIUM(1) — the real-time realistic planetarium page, bestie 🌌

💖 NAME 💖

stellarium — A real-time realistic planetarium. Like, that's the whole vibe: real skies, real time, she's a planetarium. 🪐

✨ SYNOPSIS ✨

stellarium [OPTIONS]

🦋 DESCRIPTION 🦋

Okay so Stellarium is a free GPL software, and she renders realistic skies in real time with OpenGL. No cap. She's available for Linux/Unix, Windows and MacOSX. With Stellarium, you really see what you can see with your eyes, binoculars or a small telescope. It's giving "look up, bestie" but make it software. 🌈

💅 OPTIONS 💅

Here's the whole roster, bestie — no options left behind. 💖

  • -v, --version — print the program name and version, then exit. 🎀
  • -h, --help — print a brief synopsis of the program options and exit. 🫶
  • -c, --config-file file — use file as the config filename instead of the default config.ini. 🗂️
  • -u, --user-dir dir — use dir instead of the default user data directory ($HOME/.stellarium/ on *nix operating systems). 💾
  • --verbose — even more diagnostic output in the logfile (esp. multimedia handling). 🔥
  • --scale-gui scale factor — scale the GUI according to scale factor. 🎚️
  • -d, --dump-opengl-details — dump information about OpenGL support to the logfile. Use this if you have graphics problems and want to send a bug report. 🫶
  • -f, --full-screen — takes yes|no; with argument yes or no, it over-rides the full screen setting in the config file. The setting is saved in the config-file and as such will be the default for subsequent invocations of Stellarium. 🖥️
  • --screenshot-dir dir — set the directory into which screenshots will be saved to dir, instead of the default (which is $HOME on *nix operating systems). 📸
  • --startup-script script — specify the name of the startup script. 📜
  • --home-planet planet-name — specify the observer planet. planet-name is an English name, and should refer to an object defined in the ssystem.ini file. 🌍
  • --altitude alt — specify the initial observer altitude, where alt is the altitude in meters. ⛰️
  • --longitude lon — specify the initial observer longitude, where lon is the longitude. The format is illustrated by this example: +4d16'12", which refers to 4 degrees, 16 minutes and 12 arc seconds East. Westerly longitudes should be prefixed with -. 🧭
  • --latitude lat — specify the initial observer latitude, where lat is the latitude. The format is illustrated by this example: +53d58'16.65", which refers to 53 degrees, 58 minutes and 16.65 arc seconds North. Southerly latitudes should be prefixed with -. 🌐
  • --list-landscapes — print a list of landscape names and exit. 🏞️
  • --landscape name — start Stellarium using landscape name. Refer to --list-landscapes for possible names. 🖼️
  • --sky-date date — specify sky date in format yyyymmdd. 📅
  • --sky-time time — specify sky time in format hh:mm:ss. ⏰
  • --fov fov — specify the field of view (fov degrees). 🔭
  • --projection-type p — specify projection type, p. Permitted values of p are: equalarea, stereographic, fisheye, cylinder, mercator, perspective, and orthographic. 🌈
  • --restore-defaults — delete existing config.ini and use defaults. 💀

🎀 RETURN VALUE 🎀

  • 0 — completed successfully. ✅
  • not 0 — some sort of error. 😭

🍓 FILES 🍓

Note: file locations on non-*nix operating systems (include OSX) may vary. Please refer to the Stellarium User Guide for more details, as well as information on how to customise the Stellarium data files. 🧚

  • /usr/share/stellarium/ — this is the Installation Data Directory set at compile-time. 🛠️
  • $HOME/.stellarium/ — this is the User Data Directory, which may be over-ridden using command line option -u. It contains the user's settings, extra landscapes, scripts, and can also be used to over-ride data files which are provided with the default install. 💾
  • $HOME/.stellarium/config.ini — the default main configuration file is config.ini. Refer to -c above to use a different filename and to -u to use a different User Data Directory. 🗂️
  • $HOME/ — the default screenshot directory. Refer to --screenshot-dir to use a different path. 📸

🌸 SEE ALSO 🌸

Also check out celestia(1). Sister planetarium energy. 💫

🌈 NOTES 🌈

Sources of more information: 🌐

Websites

The Stellarium User Guide

Visit the downloads page to get a PDF copy of the Stellarium User Guide. 📖

👑 BUGS 👑

Please report bugs using the bug tracker link in the NOTES section of this page. 🐞

💜 AUTHOR 💜

This iconic squad made it happen: Fabien Chereau, Rob Spearman, Johan Meuris, Matthew Gates, Johannes Gajdosik, Nigel Kerr, Andras Mohari, Bogdan Marinov, Timothy Reaves, Mike Storm, Diego Marcos, Guillaume Chereau, Alexander Wolf, Georg Zotti. 👑

Also, there's a little x14817 hanging out at the bottom, bestie. 🫶

💖 That's the whole stellarium(1) page, bestie — version 26.3.0, dated 2026-09-28. Now go look at the sky, periodt. 💖

📦 where this page comes from