--- title: "Post - Set preferences" canonical: "https://help.vicon.com/space/ShogunPost121/1253736639/Post%20-%20Set%20preferences" format: markdown --- To access and change preferences such as folder locations, hot keys and default import and export options, as well as how you interact with the Shogun Post interface, you use the Preferences dialog. > ![Preferences dialog in Vicon Shogun Post.](media://bffa7021-f265-45c0-b144-7c06923694b8) These topics introduce some of the ways you can customize Post. > Macro (toc) > Macro (scroll-pagebreak) > Macro (anchor) ## Change Shogun Post folders You set the location of Shogun Post folders and files on the **Directories** tab in the **Preferences** dialog. **To open the Preferences dialog:** 1. On the **General** menu select **Preferences**. 2. In the **Preferences** dialog select the **Directories** tab. The **Directories** tab contains fields that enable you to specify the location of: - Scripts folders. For more information, see [Set script folder locations](#ScriptLocations). - Marking Menu file, Hot key file, Button shelf file, Selection set file, Log file, Temp directory, Startup script, Shutdown script, Python interpreter. For more information, see [Set file names and folder locations](#FileNamesFolders) . > ✅ ** Tip** > ✅ The Marking Menu, Hot Key, Button Shelf, and Selection Set files are saved as Shogun scripts (.*hsl* files). > ✅ These default Shogun .*hsl* files are stored in the Shogun Post folder (by default, C:\Users\Public\Documents\Vicon\ShogunPost#.#). You might find it useful to create different .*hsl* files to store particular categories of these files and/or to create your own folder for storing any of these files that you create or customize. You can specify the location of this folder in the appropriate fields on the Directories tab. > Macro (scroll-pagebreak) ## > Macro (anchor) Set script folder locations The Shogun Post *Scripts* folder contains the default scripts supplied with Shogun Post, organized by category into sub-folders. By default, the *Scripts* folder is installed under the main Shogun Post program folder (*C:\Program Files\Vicon\ShogunPost#.#\Scripts*). Scripts in this folder can be selected from the **Pipelines** panel and the **Script Viewer** dialog (available from the **Script Editor** toolbar and the Shogun Post status bar). You can specify more than one *Scripts* folder on the **Directories** tab, but Shogun executes the first version of a given script file that it finds. That means that if you have two script files named *greatScript.hsl*, Shogun will execute the first one it finds as it searches the specified script folders in the order in which they appear in this field. You can use this search order to control when customized scripts are used over standard Shogun scripts. Review the default scripts in the *Scripts* folder and all its sub-folders because they may save you time. Each script supplied with Shogun is documented, so you can quickly determine its function and modify its commands to meet your own needs. Most Shogun Post users find that these scripts can streamline many standard operations as written, and they also can be customized to meet other needs as required. For more information on using scripts, see *[HSL scripting with Vicon Shogun Post](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737092)*. > ⚠️ **Important** > ⚠️ Ensure you save a custom version of a Shogun script under a new file name. This ensures that if your script doesn't work, you still have the original. > Macro (scroll-pagebreak) **To specify additional script file locations:** 1. On the **General** menu select **Preferences.** 2. In the **Preferences** dialog, select the **Directories** tab and view the **Script** directories section. 3. For each folder that you want to add, in the **Script directories** mini toolbar, Select the **Add **button. 4. In the **Select folder** dialog, enter or browse to the desired location. You can also perform the following operations: - Remove a selected script directory from the **Script directories** list. - If you have specified multiple directories, use the **Move selected script up** and **Move selected script down** buttons to arrange the directories in the desired order. - To view folder contents, select a folder in the list and select the **Open Folder** button on the toolbar. - To update the contents of the selected folder, select the **Reparse** button. > Macro (anchor) ## Set file names and folder locations As well as specifying the location of scripts (see [Set script folder locations](#ScriptLocations)), you can specify a different location for the following files (and temp folder) on the **Directories** tab in the **Preferences** dialog (**General** menu > **Preferences**). > Macro (scroll-tablelayout) | Field | Description | Default location | Default file | | --- | --- | --- | --- | | Marking Menu file | Default marking menus. | *C:\Users\Public\Documents\Vicon\ShogunPost#.#\* | *MarkingMenus.hsl* | | Hot key file | Hot key mappings. | *C:\Users\Public\Documents\Vicon\ShogunPost#.#\* | *HotKey.hsl* | | Button shelf file | Script used by Shogun Post to build the Button Shelf interface. The button shelf tabs are displayed as custom tabs on the ribbon. | *C:\Users\Public\Documents\Vicon\ShogunPost#.#\* | *ScriptShelves.hsl* | | Selection set file | Script used by Shogun Post to store selection set settings. | *C:\Users\Public\Documents\Vicon\ShogunPost#.#\* | *SelectionSets.hsl* | | Log file | Multi-session text log file that contains the data displayed in the Log window. | *C:\Users\Public\Documents\Vicon\ShogunPost#.#\Logs* | *CommandLog.log* | | Temp directory | Contains files that may be used by ViconSupport | *C:\Users\\AppData\Local\Temp* | NA | | Startup script | Script that runs when you start Shogun Post. | User-specified | User-specified | | Shutdown script | Script that runs when you exit Shogun Post. | User-specified | User-specified | | Python interpreter | 64-bit version of Python used by Shogun Post. For more information, see *[HSL scripting with Vicon Shogun Post](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737092)*. | *C:\Program Files\Vicon\ShogunPost#.#\Python\* | *python.exe* | You may find it useful to create your own folder and/or filename for storing any files you create or customize. **To specify a custom location:** 1. Open the **Preferences** dialog (see [Specify Vicon Shogun Post folders](#PostFolders)). 2. Select the **Directories** tab, and view the relevant field. 3. To the right of the field, select the **Open** button. 4. In the dialog, enter or navigate to and select the appropriate file or folder that Shogun Post is to use and select **Open**. You can select this **Open** button to open any previously saved .*hsl* files at any time during a Shogun Post session. ## Set pre-selection options While pre-selection (the highlighting of the marker or object that the mouse pointer is currently hovering over) is useful in some circumstances, in others it may be distracting. In the **Preferences** dialog (**General** > **Preferences**), an option on the **Interface** tab enables you to choose whether to **Show pre selection** in the 3D Scene view. > ![Preferences dialog in Vicon Shogun Post, with Interface tab selected and Show pre selection highlighted.](media://3349d69b-26ba-4866-82d4-8cb9865321b6) A related option, **Show selection pick menu**, enables you to choose whether to display a menu when you hover the mouse pointer over several markers or objects that are on top of each other. When selected, you can quickly choose from a list of markers or objects, without having to use the Selection filters. > ![Optional menu displayed when mouse pointer is hovered over multiple objects in Vicon Shogun Post.](media://9391f6e6-0dfe-4a07-91d8-cb9fa7135014) When cleared, no menu is displayed and you can select only the object that is directly under the mouse pointer. See also [Vicon Shogun 1.3 Post Tutorial - Selection Toggles](https://youtu.be/i04aVAvYZ8w) on YouTube. > Macro (scroll-pagebreak) ## Set a custom folder for saving subjects To change the default folder to which to save subjects, in the **Preferences** dialog, on the **Directories** tab, select the **Subjects** tab, where you can browse or specify the required folder. You can also specify that the current Eclipse session is used by selecting **Use active session for subject I/O**. > ![Preferences dialog in Vicon Shogun Post, with Subjects selected on Directories tab and 'Use active session for subject IO' highlighted.](media://e647847d-d0b6-4a00-9e51-3da96f2c8bc7) > Macro (scroll-pagebreak) ## Scale missing markers To scale the displayed size of missing markers, in the **Preferences** dialog, select the **Interface** tab and at the bottom, change the value of the **Missing Marker Size Multiplier** (the default is 2.50). > ![Preferences dialog in Vicon Shogun Post, with Interface tab selected and 'Missing Marker Size Multiplier' highlighted.](media://ded0ffe3-d708-4086-83e7-697eb42fab6e) > Macro (scroll-pagebreak) ## Hold Ctrl to use the manipulator To avoid accidentally manipulating objects when using the Alt key to select, you can turn on the requirement for the Ctrl key to be held down to manipulate objects in the 3D Scene view by selecting this option on the **Interface** tab of the **Preferences** dialog. By default, the option is set to off. > ![Preferences dialog in Vicon Shogun Post, with Interface tab selected and Ctrl key option highlighted.](media://296644e0-ec7b-44a8-815d-198ff1397bdf)