introduction
As of version 0.10.1, Stellarium uses the QtScript engine. The previously used StratoScript is no longer available. Even at version 0.16, Stellarium's scripting capabilities and the API change as development continues. Qt5.8 has declared the QtScript module deprecated, so the API may change again a bit. It will remain available in later Qt5 versions, though.
installing scripts
To install a script copy the script file (.ssc extension), and any texture files it uses to the scripts sub-directory of your User Data Directory. Instructions with many of these community-donated scripts may date back to older versions of Stellarium, and the instructions provided with the script may be out of date.
api documentation
After building Stellarium itself from the Git code, do 'make apidoc' (you need Doxygen installed). This will create a directory: .../stellarium/builds/doc/html which contains the API documentation in HTML format or you follow this link Doxygen-API
scripts
Show Messier, Urban, Caldwell, Double and Carbon Stars above the horizon (5 deg) with Magnitude option. Help.
An analemma over 2009-10. For this script need statusLabel.inc file.
Mars in retrograde, 2009-10. Track the retrograde moition of Mars through the constellations of Gemini, Cancer and Leo (Vesta in retrograde as well).
For this script need statusLabel.inc file.
A tour of Saturn and its larger moons. Requires mods to the ssytem.ini to create observing locations.
For this script need statusLabel.inc file.
A demonstration of the analemma - the path of the Sun across the sky during the year on Earth.
A demonstration of the analemma - the path of the Sun across the sky during the year. This script is not included in the standard package of planetarium since version 0.16.0.
Simulation of arctic summer and arctic winter (Runtime: 4 minutes).
The Jack Bennett Catalog of Southern Deep-Sky Objects (152 objects in all). The Bennett catalog was contributed by Auke Slotegraaf.
This list of 111 objects by A.J. Crayon and Steve Coe is used by members of the Saguaro Astronomy Club of Phoenix, AZ, for the Best of the NGC achievement award.
This script based on data from book "Binocular Highlights" by Gary Seronik.
Ben Crowell has created Binosky, an observing list of Deep Sky Objects for Binoculars. In the script we give a list of these 31 objects, ordered by Right Ascension (2000.0).
Best settings for viewing the constellations
A tour of the constellations of the selected sky culture.
This script help you make an excursion around 20 fun double stars. The list has been collected by Jerry Lodriguss and published in Sky & Telescope 09/2014. Data taken from his website, http://www.astropix.com/doubles/.
Best views of Earth from other Solar System bodies in the 21st Century.
Earth Events from Mercury.
Earth Events from a floating city on Venus.
Earth Events from Mars.
Earth and other planet’s Greatest Elongations and Oppositions from Mars 2000-3000.
Earth Greatest Elongations and Transits from Callisto 2000-3000. Why Callisto? Well of the 4 Galilean Moons, Callisto is the only one outside of Jupiter’s radiation belt. Therefore, if humans ever colonize Jupiter’s moons, Callisto will be the one.
Earth the other visible Planet’s Greatest Elongations and Oppositions from Ceres 2000-2200.
Fly from Earth to Mars in 20 seconds, keeping the camera on the Sun
Cycle around the Galilean moons: Io, Europa, Ganymede, Callisto. The cameras cycle from inner to outer moons, pointing inward to the nearest moon. Io is the innermost of the four Galilean moons and points to Amalthea. It could just as well be pointed at Jupiter itself, but it’s a bit more dynamic when pointing at Amalthea.
There is a 5-second wait before starting the cycle. Newer versions of Stellarium (I’ve tested this script on 0.18.0) seem to error out if the camera movements start right when the script does, so the delay gives the program a few seconds to "settle" before moving to the first camera. The last version that seemed to be reliable in this sense was 0.16.
This script demonstrates mutual events of Jupiter’s Galilean moons from 2025 to 2027.
A tour around objects from the Herschel 400 Catalogue.
First Testscript for showing some images. Many things to improve. Maybe we do a HR-Diagramm into Stellarium? Extract all 3 files into the script folder.
Look around each installed landscape.
This script help you make an excursion around largest known stars. Data taken from Wikipedia.
A demonstration of the lunar analemma - the path of the Moon across the sky during the lunar month on Earth. Due to the Earth rotation and the Moon orbital motion; time interval isn’t equal 24 hours. It can be calculated by using the formula for synodic period: 1/S = 1/E - 1/M, where the corresponding periods are the sidereal day on Earth (1/E) and the sidereal lunar month (1/M).
Script to demonstrate a partial lunar eclipse.
Script to demonstrate a total lunar eclipse.
A demonstration of the analemma - the path of the Sun across the sky during the year on Mars.
This zip contains two messier tours. One shows all the Messier objects, and the second shows just those objects that are currently visible. Extract the "messier-tour" directory, and move it into your Stellarium scripts directory.
A tour of Messier Objects.
View of Earth’s moon from the perspective of Mars
Moon hopping, up to Saturn. See the planets up close from their innermost moons, working outwards. Includes Earth and the four Galilean moons of Jupiter.
Demonstration of the mid-time of rare events - triple shadow phenomena of the satellites of Jupiter from 1900 to 2100. All events are given in Dynamical Time.
The planet Jupiter sometimes appears to be without moons, when the four Galilean satellites are simultaneously invisible because they are passing across the planet’s disk (transit), are behind the planet (occultation), or are in its shadow (eclipse). This script demonstrates these rare phenomena from 1900 to 2100 in Dynamical Time.
This script demonstrates interesting phenomena - occultations bright stars by planets, 2000 to 2040.
This script demonstrates interesting and very rare phenomena - mutual occultations of planets, 0 to 2500.
Neptune from its moon Naiad
Script will go to the best time to view selected planet and give more ephemeris like RA and Dec from Sun, phase, rise, set, transit times, ring angle for Saturn, magnitudes and earth shine and more!!
Script will display the selected planet’s (currently only Venus, Mars, Jupiter and Saturn ) events like Opposition, Closest Approach, Start and Stop Retrograde, Quadratures, CoQuadratures, Superior Conjunction, Aphelion, Perihelions, Seasons, Top & bottom of Zodiac, Ring tilts and more. Includes ephemeris like Phase, rise, set, transit times, magnitudes and earth shine and more!!
Just before Mars eclipses the sun, Phobos pops out from behind and eclipses it first. Takes place between Scorpio and Sagittarius on April 26, 2017.
Just before Mars eclipses the sun, Phobos pops out from behind and eclipses it first. Takes place between Taurus and Gemini on July 23, 2031.
Phobos eclipsing the Sun as seen from Olympus Mons on Jan 10, 2068.
Phobos occultations of Earth are common, as are occultations of Jupiter. But occultations of both on the same day are very rare. Here’s one that takes place 1/23/2048. In real speed.
Phobos races ahead of Mars and transits the sun, passes through it and then retrogrades back towards the sun and just partially transits it again (only seen in the southern hemisphere of Deimos), then Mars totally eclipses the sun while Phobos transits in darkness between Mars and Deimos. When Phobos emerges from Mars it is still eclipsed and dimmed in Mars’ shadow, only to light up later.
Planetary Alignment as seen from Sydney Australia, 18th October, 2018.
Main tour of the solar system up to Saturn. Perfect for studying the orbits of the planets and moons in real-time.
Simulation der Jahreszeiten im noerdlichen Polarkreis (Laufzeit etwa 4 Minuten).
The script will display Rise, transit, set, up length times and Right Ascension from the sun for 49 different bodies (Stars, planets, asteroids). This script will also display Civil Twilight, Nautical Twilight and Astronomical twilight times.
A tour via western constellations with their name in the ancient sardinian culture.
A tour on ancient sardinian constellations.
A demonstration of the analemma - the path of the Sun across the sky during the year on Saturn.
A slow, infinite tour of the sky, looking at random objects.
Look at each installed sky culture.
Script to demonstrate a total solar eclipse which has happened in 2009 (location=Rangpur, Bangladesh).
Solar eclipse August 11th, 1999 in Niefern, Germany.
Solar eclipse August 11th, 1999 in Niefern, Germany.
Shows the solar eclipse in 2017 as seen from Nashville, Tennessee. Fixes was added by Alexander Wolf.
Shows the solar eclipse in 2017 as seen from Nashville, Tennessee.
Screensaver of various happenings in the Solar System. 300 events in all!
This script is meant for a tour the 27 stars that are of the solar spectral type G2V greater than magnitude Vmag=6.5. The program was generated using data from [http://heasarc.gsfc.nasa.gov/db-perl/W3Browse/w3table.pl?tablehead=name%3Dhipparcos&Action=More+Options Hipparcos Catalog]. All G2V stars brighter than Vmag = 6.5 HIP=Hipparos Identifier. HIP 71683 Alpha Centauri A is the only star with known extrasolar planet in this list. CSPAR-The University of Alabama in Huntsville.
6 Scripts in all showing conjunctions between the planets and bright stars. The conjunction of stars include Aldebaran, Antares, The Beehive, The Pleiades, Regulus and Spica.
Shows information about selected objects, used as looped introduction at public observing events. Right now just for October 2010.
Look at the Sun from big planets of Solar System and Pluto.
Run the script and whenever you switch to a new day (day, week, month & year) and it will automatically go right to the dawn/dusk/sunset/sunrise.
Flash of the supernova observed by Tycho Brahe in 1572. The Supernovae plugin has to be enabled.
Transit of Venus as seen from Sydney Australia, 6th June 2012.
Due to the quirks in Mercury’s orbit and rotation at certain spots the sun will rise & set 3 different times in one Mercury day.
A demonstration of the analemma - the path of the Sun across the sky during the year on Uranus.
A tour of the western constellations.
This script displays the constellations of the Zodiac. That means the constellations which lie along the line which the Sun traces across the celestial sphere over the course of a year.
This script displays the constellations of the Zodiac. The Zodiac constellations lie along the line which the solar system objects follow on the celestial sphere.