Addendum - Guiding SW

 Stellarium Scope

updated: 2021-05-18


Stellarium Sope can be used to sync and slew your telescope while using Stellarium planetarium SW on your computer. 

Stellarium Scope Installation and Configuration with iEQ45 

Tutorial: (YouTube): 
From Bob Salazar         

Required Software

The following software must be downloaded and installed on your computer.

Stellarium Scope 

StellariumScope is a FREE add-on that enables you to control your telescope with Stellarium. Provides the interface between Stellarium and the ASCOM telescope drivers.


Stellarium Scope Features

  • Provides the ability to both "Sync" and "Slew" the telescope. It's also possible to issue a stop/cancel command from Stellarium.
  • You can easily host Stellarium on one computer linked to another control computer that hosts the telescope driver.
  • new releases of StellariumScope can be found in the download menu option. 
  • there are earlier releases still available on downloads page.

 The image left shows the interface and some of the options.  Use this application (as with all software that controls your mount) with supervision of your mount's movements.

Stellarium Scope Installation and SetUp

Minimal Installation Instructions

Comment: It has been suggested that you do a manual installation to interface StellariumScope to Stellarium. I strongly recommend that you do not do this. Use the built in [Update Stellarium Configuration] button to complete all the settings automatically instead. Of course, there may be reasons to "tweak" settings manually... but do try the automatic route first... it really does work and typically sets ALL the required options that make StellariumScope work properly.

If you use the manual method from within Stellarium, you will find difficulty in getting the proper connections to work.  Part of the issue is that Stellarium resets the port numbers to match the telescope number (the key number you use on the keyboard).  Current versions of StellariumScope check for the mismatch and recommends that you adjust them to be consistent.  This should help with situations where you are tempted to access the manual setup using Stellarium. 

You will also find that when you access the setup using Stellarium, Stellarium will set the "Telescope controlled by" option to 'Nothing'.  You will have to reset it to "External software or remote computer".

Full details are available in the documentation but this is the best way to get StellariumScope working reliably.

  1. If you have just installed Stellarium, you should run it at least once and exit.
  2. If you have been running Stellarium and StellariumScope, you should backup your config.ini and telescopes.json files typically stored in appdata\Stellarium.  Remember that appdata is usually a hidden folder and you will have to enable the option to show hidden folders and files.
  3. If you have just upgraded to a new version of Stellarium, I would recommend deleting or renaming the old Stellarium config.ini file and then run Stellarium once and exit.  This will create a fresh config.ini file.
  4. Ensure that ASCOM location settings are the same as Stellarium's otherwise StellariumScope will not be seen on Stellarium.
  5. Install StellariumScope.
  6. Run StellariumScope (you will probably receive a short diagnostic message).
  7. You can click the "Diagnostics" menu item for more details but you can typically ignore first time error diagnostics.
  8. Confirm the default "Stellarium Configuration" options... they can be easily changed later.
  9. Click the [Update Stellarium Configuration]. Watch for any suggested changes.
  10. Connect mount.
  11. Start Stellarium.

Backing up or deleting previous files
Please be sure to backup or rename your current config.ini and telescopes.json files.
If this is an update of Stellarium, just rename the config.ini file. 

  • config.ini can usually be found in %appdata%\Stellarium
  • telescopes.json can usually be found in %appdata%\Stellarium\modules\TelescopeControl (it may not exist)
  • remember the appdata folder may be hidden
  • Delete your current StellariumScope.ini file before running the new version (not usually necessary, but a good idea if you're having difficulties).
  • StellariumScope.ini can usually be found in %appdata%\Stellarium

Created with the Personal Edition of HelpNDoc: Streamline your documentation process with HelpNDoc's HTML5 template