Software Bisque

Take a virtual tour of the Software Bisque campus Watch Steve Bisque discuss the Paramount mount with S&T's Dennis Di Cicco Read the Paramount MYT Review Read about the Paramount Software Suite


rated by 0 users
This post has 0 Replies | 0 Followers

Top 10 Contributor
Posts 3,900
Software Bisque Employee
Brian Rickard Posted: 06-18-2018 5:22 AM | Locked

Software Bisque Knowledge Base Article - 1248



After configuring various settings (site location, chart settings, interfaced equipment, pointing model, etc.), TheSkyX has unexpectedly returned to default settings.


This discussion refers extensively to TheSkyX's Application Support Files (ASF) folder. Note that this is a description of the folder, not its name!...follow the link for details.

While apparently losing one's settings can be alarming, in actuality they are most likely not lost. Here is a summary of some reasons this may happen:

  1. Using a different OS user account.
  2. Running more than one instance of TheSkyX.
  3. The ASF folder is on an unavailable drive.
  4. The ASF folder was moved.
  5. The ASF folder was renamed.
  6. The ASF folder was deleted.
  7. The ASF folder has become corrupt.

And below are possible resolutions.

Using A Different OS User Account

If a different operating system (OS) user account is used than that under which the desired settings were created, by default TheSkyX will use separate settings for each. If that is not desired, here are some possible resolutions:

Running More Than One Instance of TheSkyX

TheSkyX (except for the Mac version) is designed to allow running more than one instance simultaneously. The most intentional way to start an additional instance of TheSkyX is to launch it while at least one other instance is already running. On Windows only, this can also happen if TheSkyX is Run As Administrator, and then an automation application or script that is not run as administrator (or vice versa) attempts to access it.

In all of these cases, the user is asked whether or not to start another instance (or copy) of TheSkyX, as illustrated here:

(The above message may not be noticed, however, as it can appear underneath the window of an automation application.)

This normally* results in using a separate ASF folder for each instance—additional ASF folders have their instance number appended to the folder name, such as "TheSkyX Professional Edition 2". If an instance's ASF folder does not already exist, one is created, and—unless starting the additional instance is aborted—populated with default settings. The former settings (used by the primary instance of TheSkyX) are not gone; they remain in the primary ASF folder.

*If TheSkyX has been specially configured to use an explicitly-defined ASF folder, that folder will be used for all instances. We do not recommend using an explicitly-defined ASF folder if you anticipate running more than one instance of TheSkyX.

The ASF Folder Is On an Unavailable Drive

If the ASF folder is on a network or removable drive, be sure that the drive is available (mapped or connected) when launching and using TheSkyX. On Windows, be sure the drive letter hasn't changed; if it has, restore it to its former letter, or inform TheSkyX of the new drive letter per the Transferring TheSkyX's Settings article.

The ASF Folder Was Moved

If the ASF folder was moved, here are some methods to continue using it with TheSkyX:

The ASF Folder Was Renamed

Renaming a working ASF folder (one that is intended to be used by its new name) is strongly discouraged* as some settings will be sought in a folder by the previous name, which probably no longer exists (though TheSkyX may create one, mostly empty). Newly-defined settings may then be spread between the two ASF folders.

If one insists on renaming a working ASF folder, they should also update the Path= and File= definitions in the various .INI files, per the Transferring TheSkyX's Settings article. For example, unless and until the APP_qsImgSysProfilePath= definition in the AppSettings.ini file is updated, TheSkyX will not be able to access the former Imaging System Profiles.

*It is okay to rename the ASF folder as a means of restoring TheSkyX's Default Settings; should you later wish to return to the former settings, give the renamed folder its original name before using it with TheSkyX.

The ASF Folder Was Deleted

If the ASF folder with desired settings is deleted, restore it from the recycle bin (Windows), trash (Mac) or a backup copy. If none of these is available, the settings are probably lost and will need to be reconfigured/recreated.

The ASF Folder Has Become Corrupt

If the ASF folder or some of its settings files becomes corrupt, here are some possible resolutions:

  • If the drive has errors, it may be possible to repair the files with a disk repair utility.
  • Corrupt files (or those with unwanted settings) may be restored from a backup copy, if available.
  • It may be necessary to start with fresh, default settings and customize again as desired. See the Restoring TheSkyX's Default Settings article. 


Software Bisque strongly recommends backing up your computer's data, including TheSkyX's settings.  The article below describes how.



  • TheSkyX First Light Edition
  • TheSkyX Student Edition
  • TheSkyX Serious Astronomer Edition
  • TheSkyX Professional Edition
  • Windows OS, macOS, Linux OS, Raspbian OS


SBKB; settings; My Documents; Windows; OS X; Linux; Raspbian; TheSkyX Serious Astronomer Edition; TheSkyX Professional Edition

Last Reviewed: 2019-02-22

Brian S. Rickard
Software Bisque, Inc.

Page 1 of 1 (1 items) | RSS


© 2019 Software Bisque, Inc. 862 Brickyard Circle, Golden, CO 80403-8058 USA - phone: +1 303 278 4478 fax: +1 303 278 0045