Configure StellariumScope

Published: Friday, 20 November 2015


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.

If you have just installed Stellarium, you should run it at least once and exit.

  1. 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.
  2. 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.
  3. Ensure that ASCOM location settings are the same as Stellarium's otherwise StellariumScope will not be seen on Stellarium.
  4. Install StellariumScope.
  5. Run StellariumScope (you will probably receive a short diagnostic message).
  6. You can click the "Diagnostics" menu item for more details but you can typically ignore first time error diagnostics.
  7. Confirm the default "Stellarium Configuration" options... they can be easily changed later.
  8. Click the [Update Stellarium Configuration]. Watch for any suggested changes.
  9. Connect mount.
  10. 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

all other versions below are not time limited but are no longer maintained.