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

1241 - TRANSFERRING THESKYX'S SETTINGS

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

Top 10 Contributor
Posts 3,870
Software Bisque Employee
Brian Rickard Posted: 04-14-2017 5:09 PM | Locked

Software Bisque Knowledge Base Article - 1241

TRANSFERRING THESKYX'S SETTINGS

(Originally titled "PORTING THESKYX'S SETTINGS")

ISSUE

TheSkyX's personalized settings can be moved or duplicated to a different user account or edition of TheSkyX on the same computer, or to a different computer or operating system. However, simply placing a copy of the settings at the new location won't necessarily result in TheSkyX being able to utilize all of those settings. If the new location is on the same computer as the original, it is possible that the settings will be fully utilized, yet split between the two locations.

RESOLUTION

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.

If you haven't already, please see the articles on Backing Up TheSkyX's Settings and Restoring TheSkyX's Settings (the latter procedure alone is sufficient when transferring to a different computer with an identical ASF folder path).

There are several files in the ASF folder that store path definitions to files or folders. Copying or moving these configuration files to a different location will typically result in invalidating the path definitions they contain. Even nothing more than a change in the OS's user name can relocate the ASF folder. (When restoring from a backup, the path definitions are valid if the files are restored to their original location.) While TheSkyX can function with certain invalid path definitions, it will attempt to substitute default settings for some that it can't locate.

Below are listed the affected files with a brief description of their purpose and instructions for editing path definitions they contain.

AppSettings.ini

Includes, among others, software serial number(s) and the path definition for the last-used TPoint settings file.

  1. If running, close TheSkyX.
  2. Navigate to your ASF folder, then locate and rename the "AppSettings.ini" file to something like "AppSettings backup.ini".
  3. Open this file in a text editor, such as Notepad on Windows, or TextEditor on Mac. With TextEditor, be sure to use the Plain Text option.
  4. If you've changed editions of TheSkyX, or otherwise need to change your serial number(s), look for lines that include the text "SerialNumber" and replace the value after the equals sign with your new serial number(s) for the corresponding software/add-on.
  5. Look for lines that include the phrase "Path" and, where necessary, revise the value after the equals sign to the correct location.
  6. Save the modified contents as a new file named "AppSettings.ini" (without quotes, and in the same folder).
  7. If you changed your serial number in step 4, launch TheSkyX to verify your serial number information using the About TheSkyX command from the Help menu (Windows) or TheSkyX menu (macOS).

ImagingSystem.ini (under the Imaging System Profile sub-folder)

Includes, among others, the path definitions for the Camera Add On's AutoSave folder(s), if applicable. Note that this is the default imaging system profile file name. Additional profiles may have been created, and may be edited in the manner described here. You needn't edit profiles that you no longer use.

  1. If running, close TheSkyX.
  2. Navigate to the Imaging System Profile sub-folder of your ASF folder, then locate and rename the "ImagingSystem.ini" file to something like "ImagingSystem backup.ini".
  3. Open this file in a text editor, such as Notepad on Windows, or TextEditor on Mac. With TextEditor, be sure to use the Plain Text option.
  4. Look for lines that include the phrase "Path" and, where necessary, revise the value after the equals sign to the correct location.
  5. Save the modified contents as a new file named "ImagingSystem.ini" (without quotes, and in the same folder).

LastDocument.ini

Keeps track of the last-opened .SKYX Sky Document that stores primarily Sky Chart parameters (site location, date and time, chart orientation, displayed elements, etc.).

  1. Launch TheSkyX.
  2. Use the File > Open command to choose a desired .SKYX Sky Document.
  3. The "LastDocument.ini" file should automatically be updated when TheSkyX is closed.

Tips:

  • If you'd customized TheSkyX's Application Support Files (ASF) folder location, you'll need to do the same for the new installation, or it will instead use the default location, being unaware of your alternate location. See Changing Where TheSkyX's Settings Are Saved.
  • If moving between computers of very different display pixel densities, the appearance of TheSkyX's toolbars and windows might look different. On Windows this can be addressed using the text magnification setting (under Windows' Settings > System > Display), and/or by adjusting TheSkyX's Toolbar Button Options on the Toolbar tab of the Preferences window. Also, regardless of the operating system, you may restore the default window and toolbar settings by closing TheSkyX and then renaming or deleting the WindowPositions.ini file from the root of the ASF folder. When next launched, a new WindowPositions.ini file will automatically be created using the default configuration.
  • If you've changed computers and need to interface TheSkyX with peripherals (e.g. mount, camera, focuser, dome), you may also need to copy or install associated third-party drivers and/or plug-ins and re-configure associated port assignments. If ASCOM is used (Windows only), you'll also need to install the ASCOM platform.

APPLIES TO

  • TheSkyX First Light Edition
  • TheSkyX Student Edition
  • TheSkyX Serious Astronomer Edition
  • TheSkyX Professional Edition

KEYWORDS

SBKB; settings; backup; transfer; change; My Documents; Windows, OS X, TheSkyX Serious Astronomer Edition, TheSkyX Professional Edition

Last Reviewed: 2019-03-14

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
Google+