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

1240 - CHANGING WHERE THESKYX'S SETTINGS ARE SAVED

This post has 0 Replies | 0 Followers

Top 10 Contributor
Posts 3,343
Software Bisque Employee
Brian Rickard Posted: 02-03-2017 5:11 PM | Locked

Software Bisque Knowledge Base Article - 1240

CHANGING WHERE THESKYX'S SETTINGS ARE SAVED

ISSUE

NOTE: 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.

You may choose to use a non-default location or name for TheSkyX's ASF folder. This folder contains preferences, toolbar and window configurations, .SKYX documents, observing notes, custom horizons, imaging system profiles, field-of-view indicators, TPoint data and models, and more.

Here are some examples of why you might do this:

  • You want to keep TheSkyX's settings on a network drive
  • You want to keep TheSkyX's settings on a removable drive that is moved between two computers (e.g. home and observatory)
  • You want to share TheSkyX's settings between two or more user accounts on the same computer
  • Personal preference

If you're moving/transferring/duplicating your settings to a different user account, computer, operating system or edition of TheSkyX, you can use the default ASF folder location and name for that edition and operating system. In this case, rather than the following procedure, see Transferring TheSkyX's Settings.

RESOLUTION

The following procedure can be used to inform TheSkyX of a non-default ASF folder location/name. Please see the caution in the tip section at the bottom of this article regarding running multiple instances of TheSkyX.

Part A

  1. Close TheSkyX, if presently running.
  2. Optionally move or copy your existing ASF folder to the new location you wish to use. (If TheSkyX doesn't find the folder at the location defined after completing this procedure, it will create one with default settings.)

Part B

Mac/Linux/Raspbian:

  1. Open TextEdit (Mac), Text Editor (Linux/Raspbian), or a similar text editor.
  2. From the File menu, choose New command, and to the new document add the following two lines:

    [General]
    UserDataRoot=/<TheSkyX Application Support Files Folder Path>

    Where <TheSkyX Application Support Files Folder Path> is the desired path, including folder name (don't include the "<" or ">"). For example, UserDataRoot=/Users/username/Library/Application Support/Software Bisque/TheSkyX Professional Edition
    IMPORTANT: Use a single forward slash "/" for each folder separator.
  3. Mac only: From the Format menu, choose the Make Plain Text command.
  4. From the File menu, choose the Save command, name the file startup.ini (for TextEdit, disable the if no extension is provided, use "txt" option), then click Save.  Note the folder where this file is saved!
  5. Close the text editor and open Finder (Mac), Files (Linux), File Manager (Raspbian), or equivalent.
  6. Locate the startup.ini file from step 4 and copy it to the clipboard (right click on the file name and choose the Copy command).
  7. Open the Applications folder, right-click on TheSkyX <Edition Name Here> application bundle, then choose the Show Package Contents command.
  8. Open the Contents folder and paste the startup.ini file into it (right-click within the folder and choose the Paste command).

Windows:

  1. Open Notepad or a similar text editor.
  2. To a new document, add the following two lines:

    [General]
    UserDataRoot="C:\\<TheSkyX Application Support Files Folder Path>"

    Where C: is the desired drive letter and <TheSkyX Application Support Files Folder Path> is the desired path, including folder name (don't include the "<" or ">"). For example, UserDataRoot="C:\\Users\\username\\Documents\\Software Bisque\\TheSkyX Professional Edition"
    IMPORTANT: Be sure to use two back slashes "\\" for each folder separator.
  3. From the File menu, choose the Save command, name the file startup.ini and click Save.  Note the folder where this file is saved!
  4. Close the text editor and open Explorer (Windows 10) or File Explorer (Windows 8 and earlier).
  5. Locate the startup.ini file from step 3 and copy it to the clipboard (right click on the file name and choose the Copy command).
  6. Navigate to TheSkyX's installation folder. The default location is:
    32-bit Windows: C:\Program Files\Software Bisque\TheSkyX <Edition Name Here>
    64-bit Windows: C:\Program Files (x86)\Software Bisque\TheSkyX <Edition Name Here>
  7. Paste the startup.ini file into this folder (right-click within the folder and choose the Paste command). 

Part C

If the above was done properly, TheSkyX should henceforth save its settings to, and retrieve them from, the newly-defined ASF folder. Here's how to verify this:
  1. Launch TheSkyX. If you're prompted for your name and serial number, a new ASF folder is being created for you; refer to Part A step 2 above if you instead wish TheSkyX to use your former settings.
  2. From the File menu choose the Open command.
  3. Note which folder is displayed in the Open window; this should match what you defined above. If it doesn't, you may have formatted the startup.ini file incorrectly, or not correctly placed it in TheSkyX's installation folder. 

Tips:

  • Several of TheSkyX's settings files include file path definitions; a referenced file cannot be opened by TheSkyX if its defined path is incorrect (e.g. has changed as a result of relocating the ASF folder). See Transferring TheSkyX's Settings for a procedure to correct these path definitions.
  • If TheSkyX does not find the startup.ini file, or that file does not properly define the location of an ASF folder, it will resort to its default location for the ASF folder. 
  • CAUTION (For Windows, Linux and Raspbian versions only): This procedure to explicitly define the working ASF folder will override TheSkyX's normal behaviour when a second (or more) instance is run. Instead of each instance using a separate ASF folder (e.g. with " 2" appended to its name), all instances will use the same ASF folder. We do not recommend using an explicitly-defined ASF folder if you anticipate running multiple instances of TheSkyX.

APPLIES TO

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

KEYWORDS

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

Last Reviewed: 2018-10-19

Brian S. Rickard
Software Bisque, Inc.

Page 1 of 1 (1 items) | RSS

   

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