# Prefs

The **Prefs** internal command can be used to:

* Display the [Preferences](../../../preferences) dialog which lets you change most configuration options
* Display the [Customize](../../../customize) dialog to edit toolbars, menus and hotkeys
* Display the [File Types](../../../file_types) dialog to configure context menus, double-click actions and other file-type specific settings
* Display and edit the [FTP Address Book](../../../ftp/ftp_address_book)
* [Backup and restore](../../../preferences/backing_up_and_restoring_preferences) your configuration
* Load and save [Lister layouts](../../../basic_concepts/the_lister/layouts)
* Update the [Default Lister](../../../basic_concepts/the_lister/the_default_lister) settings
* Load and save [Lister styles](../../../basic_concepts/the_lister/styles)
* Load and save [Lister themes](../../../basic_concepts/the_lister/themes)
* Manage [VFS plugins](../../../preferences/preferences_categories/zip_and_other_archives/archive_and_vfs_plugins)
* Install, manage and edit [Script Add-ins](../../../scripting/script_add-ins).

**Command Arguments:**

<table><thead><tr><th>Argument</th><th>Type</th><th>Possible values</th><th>Description</th></tr></thead><tbody><tr><td><em>(no argument)</em></td><td>-</td><td>-</td><td><p>Displays the <a href="../../../preferences"><strong>Preferences</strong></a> dialog.</p><p><em>Example:</em> <code>Prefs</code></p></td></tr><tr><td>ADDFTPSITE</td><td>/S</td><td><em>(no value)</em></td><td><p>Adds the currently connected FTP site as a new entry in the <a href="../../../ftp/ftp_address_book">FTP Address Book</a>. If you are not currently viewing an FTP directory this command has no effect.</p><p><em>Example:</em> <code>Prefs ADDFTPSITE</code></p></td></tr><tr><td>BACKUP</td><td>/O</td><td><em>(no value)</em></td><td><p>Automates the configuration backup process. By default all your configuration settings, toolbars, menus and hotkeys are included in the backup, but extra data like images and sounds are not. The optional values for this argument can be used to control which extra data is included in the backup. Use the <strong>TO</strong> argument to specify the name of the backup file, and the <strong>PASSWORD</strong>, <strong>DESC</strong> and <strong>QUIET</strong> arguments provide additional control.</p><p><em>Example:</em> <code>Prefs BACKUP TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>images</strong></td><td><p>When automating a configuration backup, includes image files in your backup (corresponds to the <strong>Backup images</strong> option in the <a href="../../../preferences/backing_up_and_restoring_preferences"><em>Backup and Restore Configuration</em></a> wizard).</p><p><em>Example:</em> <code>Prefs BACKUP=images TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>sounds</strong></td><td><p>Includes sound files in the backup (corresponds to the <strong>Backup sounds</strong> option).</p><p><em>Example:</em> <code>Prefs BACKUP=sounds TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>data</strong></td><td><p>Include miscellaneous data in the backup (corresponds to the <strong>Backup miscellaneous data</strong> option).</p><p><em>Example:</em> <code>Prefs BACKUP=data TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>localstate</strong></td><td><p>Include local state data (corresponds to the <strong>Backup local state data</strong> option).</p><p><em>Example:</em> <code>Prefs BACKUP=data,localstate TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>all</strong></td><td><p>Backup everything (equivalent to <strong>BACKUP=images,sounds,data,localstate</strong>).</p><p><em>Example:</em> <code>Prefs BACKUP=all TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>notabs</strong></td><td><p>Exclude currently open windows and tabs from the backup. (Only relevant if local state is being backed up.)</p><p><em>Example:</em> <code>Prefs BACKUP=all,notabs TO="/desktop/PrefsBackup"</code></p></td></tr><tr><td>BACKUPRESTORE</td><td>/S</td><td><em>(no value)</em></td><td><p>Initiates the <a href="../../../preferences/backing_up_and_restoring_preferences"><em>Backup and Restore Configuration</em></a> wizard, which lets you backup and restore your configuration, as well as export Opus to a USB drive. You can use the <strong>TO</strong> argument to override the default backup name, and the <strong>PASSWORD</strong> or <strong>DESC</strong> arguments to pre-supply a default password or descriptions when creating a backup.</p><p><em>Example:</em> <code>Prefs BACKUPRESTORE</code><br><em>Example:</em> <code>Prefs BACKUPRESTORE TO="/desktop\Backup for %username% on {date|yyyy-MM-dd}" PASSWORD="cat" DESC="Quick Backup."</code></p><p>If you wish to automate the backup or restore process, without showing the interactive wizard, use the separate <strong>BACKUP</strong> or <strong>RESTORE</strong> arguments.</p></td></tr><tr><td>COLLAPSEALL</td><td>/S</td><td><em>(no value)</em></td><td><p>Collapses all categories in the <a href="../../../preferences"><strong>Preferences</strong></a> dialog. Combine with the <code>PAGE</code> argument to show a new page and collapse all other categories.</p><p><em>Example:</em> <code>Prefs PAGE=folderformats COLLAPSEALL</code></p></td></tr><tr><td>CUSTOMIZE</td><td>/O</td><td><em>(no value)</em></td><td><p>Displays the <a href="../../../customize"><strong>Customize</strong></a> dialog. The dialog will open on the page that was last used.</p><p><em>Example:</em> <code>Prefs CUSTOMIZE</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;page></em></td><td><p>Displays the specified tab on the <strong>Customize</strong> dialog. Allowable values for this argument are <strong>commands</strong>, <strong>toolbars</strong>, <strong>keys</strong> and <strong>menus</strong>.</p><p><em>Example:</em> <code>Prefs CUSTOMIZE=toolbars</code></p></td></tr><tr><td>DESC</td><td>/K</td><td><em>&#x3C;description></em></td><td><p>Assign a description to a configuration backup (used with the <strong>BACKUP</strong> or <strong>BACKUPRESTORE</strong> argument). Remember that if the description string contains spaces you need to enclose it with quotes.</p><p><em>Example:</em> <code>Prefs BACKUP TO="/desktop/PrefsBackup" DESC="My Opus Config"</code></p></td></tr><tr><td>FILETYPES</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays the <a href="../../../file_types"><strong>File Types</strong></a> dialog.</p><p><em>Example:</em> <code>Prefs FILETYPES</code></p></td></tr><tr><td>FROM</td><td>/K</td><td><em>&#x3C;backup file></em></td><td><p>Specifies the configuration backup file to restore (used with the <strong>RESTORE</strong> argument to automate the configuration restore process).</p><p><em>Example:</em> <code>Prefs RESTORE FROM="/desktop/PrefsBackup"</code></p></td></tr><tr><td>FTPSITES</td><td>/O</td><td><em>(no value)</em></td><td><p>Displays the <a href="../../../ftp/ftp_address_book"><strong>FTP Address Book</strong></a>.</p><p><em>Example:</em> <code>Prefs FTPSITES</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;site name></em></td><td><p>Displays the <a href="../../../ftp/ftp_address_book"><strong>FTP Address Book</strong></a> and automatically selects the named site. If the site is in a sub-folder in the address book you need to provide the full path of the site.</p><p><em>Example:</em> <code>Prefs FTPSITES="WorkServers\Production"</code></p></td></tr><tr><td>HEADING</td><td>/O</td><td><em>(no value)</em></td><td><p>When used with commands which generate a list of items (see <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/dynamic_buttons">dynamic buttons</a>), the <strong>HEADING</strong> argument adds a small heading at the start of the list. The heading will be hidden when the list is empty. Headings only happen for commands which potentially generate multiple items at the same level as the button itself.</p><p>When <strong>HEADING</strong> is used by itself, without specifying a text value, the main button's label text is used for the heading.</p><p><em>Example:</em> <code>Prefs LAYOUTLIST HEADING</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;heading text></em></td><td><p>You can specify the heading text if you want it to be different to the button's label.</p><p><em>Example:</em> <code>Prefs STYLELIST HEADING="Styles"</code></p></td></tr><tr><td>KEYS</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays the <strong>Keys</strong> page of the <strong>Customize</strong> dialog (equivalent to <code>Prefs CUSTOMIZE=keys</code>).</p><p><em>Example:</em> <code>Prefs KEYS</code></p></td></tr><tr><td>LAYOUT</td><td>/K</td><td><em>&#x3C;layout name></em></td><td><p>Loads the named <a href="../../../basic_concepts/the_lister/layouts">Lister layout</a>.</p><p><em>Example:</em> <code>Prefs LAYOUT="Music Albums"</code></p></td></tr><tr><td>LAYOUTCLOSELISTERS</td><td>/K</td><td><strong>yes</strong></td><td><p>When loading a layout with the <strong>LAYOUT</strong> argument, this overrides the <strong>Close all existing Listers when loading this layout</strong> flag set for the layout, and forces all existing Listers to close. When saving a layout with the <strong>LAYOUTSAVE</strong> argument, it sets the state of that flag within the layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="FTP Sync" LAYOUTCLOSELISTERS=yes</code></p></td></tr><tr><td></td><td></td><td><strong>no</strong></td><td><p>Does not close all existing Listers when loading a layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="Photo Album" LAYOUTCLOSELISTERS=no</code></p></td></tr><tr><td></td><td></td><td><strong>current</strong></td><td><p>Only closes Listers on the current virtual desktop.</p><p><em>Example:</em> <code>Prefs LAYOUT="Work" LAYOUTCLOSELISTERS=yes,current</code></p></td></tr><tr><td></td><td></td><td><strong>all</strong></td><td><p>Closes Listers on all desktops.</p><p><em>Example:</em> <code>Prefs LAYOUT="Photo Organising" LAYOUTCLOSELISTERS=yes,all</code></p></td></tr><tr><td>LAYOUTEDIT</td><td>/S</td><td><em>(no value)</em></td><td><p>Opens the Preferences dialog and displays the <a href="../../../preferences/preferences_categories/layouts_and_styles/layouts"><strong>Layouts and Styles / Layouts</strong></a> page (equivalent to <code>Prefs PAGE=layouts</code>).</p><p><em>Example:</em> <code>Prefs LAYOUTEDIT</code></p></td></tr><tr><td>LAYOUTIGNOREFORMATS</td><td>/K</td><td><strong>yes</strong></td><td><p>When loading a layout with the <strong>LAYOUT</strong> argument, this overrides the <strong>Ignore folder formats saved within this layout</strong> flag set for the layout, and forces the layout's <a href="../../../basic_concepts/folder_options/folder_formats">folder formats</a> to be ignored. When saving a layout with the <strong>LAYOUTSAVE</strong> argument, it sets the state of that flag within the layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="Photo Viewing" LAYOUTIGNOREFORMATS=yes</code></p></td></tr><tr><td></td><td></td><td><strong>no</strong></td><td><p>Does not ignore the layout's folder formats.</p><p><em>Example:</em> <code>Prefs LAYOUT="Photos" LAYOUTIGNOREFORMATS=no</code></p></td></tr><tr><td>LAYOUTIGNORETOOLBARS</td><td>/K</td><td><strong>yes</strong></td><td><p>When loading a layout with the <strong>LAYOUT</strong> argument, this overrides the <strong>Ignore toolbars saved within this layout</strong> flag set for the layout, and forces the layout's toolbars to be ignored, and the default toolbar set to be used instead. When saving a layout with the <strong>LAYOUTSAVE</strong> argument, it sets the state of that flag within the layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="Photos" LAYOUTIGNORETOOLBARS=yes</code></p></td></tr><tr><td></td><td></td><td><strong>no</strong></td><td><p>Does not ignore the layout's toolbars.</p><p><em>Example:</em> <code>Prefs LAYOUT="Photos" LAYOUTIGNORETOOLBARS=no</code></p></td></tr><tr><td>LAYOUTLIST</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays a list of your saved <a href="../../../basic_concepts/the_lister/layouts">Lister layouts</a> (acts as a <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/dynamic_buttons">dynamic button</a>). Selecting an item from the generated list loads the specified layout. The <strong>LAYOUTCLOSELISTERS</strong>, <strong>LAYOUTIGNOREFORMATS</strong> and <strong>LAYOUTMOUSERELATIVE</strong> flags can be used in conjunction with this argument to control the behaviour of the generated buttons.</p><p><em>Example:</em> <code>Prefs LAYOUTLIST LAYOUTCLOSELISTERS=yes</code></p></td></tr><tr><td>LAYOUTMOUSERELATIVE</td><td>/K</td><td><strong>yes</strong></td><td><p>When loading a layout with the <strong>LAYOUT</strong> argument, this overrides the <strong>Open layout relative to the monitor the mouse is currently on</strong> flag set for the layout, and forces the layout's position to be relative to the mouse. When saving a layout with the <strong>LAYOUTSAVE</strong> argument, it sets the state of that flag within the layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="Find" LAYOUTMOUSERELATIVE=yes</code></p></td></tr><tr><td></td><td></td><td><strong>no</strong></td><td><p>Does not open the layout relative to the mouse pointer.</p><p><em>Example:</em> <code>Prefs LAYOUT="BackupFiles" LAYOUTMOUSERELATIVE=no</code></p></td></tr><tr><td>LAYOUTNAME</td><td>/K</td><td><em>&#x3C;layout name></em></td><td><p>Specifies a name when saving a <a href="../../../basic_concepts/the_lister/layouts">layout</a> using the <strong>LAYOUTSAVE</strong> argument. If not provided Opus will prompt for a name for the new layout.</p><p><em>Example:</em> <code>Prefs LAYOUTNAME="My Layout" LAYOUTSAVE</code></p></td></tr><tr><td>LAYOUTNOVIRTDESKTOP</td><td>/K</td><td><strong>yes</strong></td><td><p>When loading a layout, prevents Listers being restored to their original virtual desktops (overrides the setting in the Layout).</p><p><em>Example:</em> <code>Prefs LAYOUT="Find" LAYOUTNOVIRTDESKTOP=yes</code></p></td></tr><tr><td></td><td></td><td><strong>no</strong></td><td><p>Allows Listers to be restored to their original virtual desktops.</p><p><em>Example:</em> <code>Prefs LAYOUT="Find" LAYOUTNOVIRTDESKTOP=no</code></p></td></tr><tr><td>LAYOUTSAVE</td><td>/O</td><td><em>(no value)</em></td><td><p>Saves the currently open Listers as a <a href="../../../basic_concepts/the_lister/layouts">layout</a>. You can use the <strong>LAYOUTNAME</strong> argument to specify the layout name. You can also use the <strong>LAYOUTCLOSELISTERS</strong>, <strong>LAYOUTIGNOREFORMATS</strong> and <strong>LAYOUTMOUSERELATIVE</strong> arguments to control the state of those flags for the saved layout.</p><p><em>Example:</em> <code>Prefs LAYOUTSAVE</code></p></td></tr><tr><td></td><td></td><td><strong>single</strong></td><td><p>Saves only the active Lister as a layout. Any other currently open Listers are not included.</p><p><em>Example:</em> <code>Prefs LAYOUTSAVE=single LAYOUTNAME="CurrentLister"</code></p></td></tr><tr><td></td><td></td><td><strong>noupdatesettings</strong></td><td><p>If you do not use the <strong>LAYOUTNAME</strong> argument to provide a name for the layout, Opus will display a dialog prompting for the name - this dialog also contains various options for the layout (ignore formats, mouse relative, etc). Changes you make to those options will be saved as the default settings for the <strong>LAYOUTSAVE</strong> function unless you specify the <strong>noupdatesettings</strong> value.</p><p><em>Example:</em> <code>Prefs LAYOUTSAVE=noupdatesettings LAYOUTMOUSERELATIVE=yes LAYOUTNAME="My Layout"</code></p></td></tr><tr><td></td><td></td><td><strong>updatecurrent</strong></td><td><p>If the current lister is already part of a layout, that layout will be updated and you will not be prompted for a layout name or any further options.</p><p><em>Example:</em> <code>Prefs LAYOUTSAVE=updatecurrent</code></p></td></tr><tr><td>LAYOUTTHISLISTER</td><td>/O</td><td><em>(no value)</em></td><td><p>In conjunction with the <strong>LAYOUT</strong> argument, this applies the settings from the specified layout to the current Lister instead of opening a new Lister.</p><p>If no value is given to the <strong>LAYOUTTHISLISTER</strong> argument, the layout's panels (e.g. viewer pane, dual file display, utility panel) are applied to the current lister but the window size and position, and current paths, are left unchanged.</p><p><em>Example:</em> <code>Prefs LAYOUT="PhotoViewing" LAYOUTTHISLISTER</code></p></td></tr><tr><td></td><td></td><td><strong>nopanels</strong></td><td><p>Do not apply the layout's panels (e.g. viewer pane, dual file display, utility panel) to the currernt window. (If none of the other values are specified, then nothing will be done at all.)</p><p><em>Example:</em> <code>Prefs LAYOUT="SmallLister" LAYOUTTHISLISTER=nopanels,size</code></p></td></tr><tr><td></td><td></td><td><strong>size</strong></td><td><p>Use the window size from the specified layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="SmallLister" LAYOUTTHISLISTER=size</code></p></td></tr><tr><td></td><td></td><td><strong>pos</strong></td><td><p>Use the window position from the specified layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="NiceSizedLister" LAYOUTTHISLISTER=pos,size</code></p></td></tr><tr><td></td><td></td><td><strong>paths</strong></td><td><p>Use the paths/tabs (and folder formats) from the specified layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="CurrentWork" LAYOUTTHISLISTER=pos,size,paths</code></p><p>You can also use <strong>LAYOUTIGNOREFORMATS</strong> in conjunction with <strong>LAYOUTTHISLISTER=paths</strong> to override whether or not the layout's folder formats are applied (which is normally determined by a flag you can set when saving and editing each layout).</p><p><em>Example:</em> <code>Prefs LAYOUT="My Layout" LAYOUTTHISLISTER=paths LAYOUTIGNOREFORMATS=yes</code></p></td></tr><tr><td>LIMITPATH</td><td>/K/M</td><td><em>&#x3C;paths></em></td><td><p>When opening a new Layout with the <strong>LAYOUT</strong> argument, this lets you restrict the newly opened Listers to one or more paths (and their descendants). Attempts to navigate outside of the allowed paths will display an error.</p><p><em>Example:</em> <code>Prefs LAYOUT="Focus On Work" LIMITPATH "C:\Work"</code></p></td></tr><tr><td></td><td></td><td><strong>reset</strong></td><td><p>If a Layout was saved with restricted paths, this lets you override the restrictions when opening the Layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="LockedLister" LIMITPATH=reset</code></p></td></tr><tr><td>MENUMARKERS</td><td>/S</td><td><em>(no value)</em></td><td><p>When used with <strong>LAYOUTLIST</strong>, if the generated list of layouts includes any submenus, the top-level buttons will display a glyph indicating a dropdown menu.</p><p><em>Example:</em> <code>Prefs LAYOUTLIST MENUMARKERS</code></p></td></tr><tr><td>NOSCRIPT</td><td>/S</td><td><em>(no value)</em></td><td><p>Allows a <a href="../../../scripting">script</a> to run the <code>Prefs LAYOUT</code> command without triggering other scripts (or itself). Adding the <strong>NOSCRIPT</strong> argument disables the <a href="../../scripting_reference/scripting_events/onbeforefolderchange"><strong>OnBeforeFolderChange</strong></a>, <a href="../../scripting_reference/scripting_events/onafterfolderchange"><strong>OnAfterFolderChange</strong></a>, <a href="../../scripting_reference/scripting_events/onopentab"><strong>OnOpenTab</strong></a> and <a href="../../scripting_reference/scripting_events/onopenlister"><strong>OnOpenLister</strong></a> events that would otherwise be triggered by opening a Lister layout.</p><p><em>Example:</em> <code>Prefs LAYOUT="My Layout" NOSCRIPT</code></p></td></tr><tr><td>PAGE</td><td>/K</td><td><em>&#x3C;prefs page></em></td><td><p>Opens the Preferences dialog to the specified page. If this argument is not supplied the Preferences dialog will open to the last-used page.</p><p>Opus can work out the command for you if you open the Preferences dialog, go to the page you want, then select <strong>File / Copy Page Shortcut To Clipboard</strong> at the top of the window.</p><p>Some pages allow data to be passed to them to indicate the item to edit. For example, <strong>scripts</strong> allows a script to be selected by name and its configuration dialog to be shown automatically. To do this, append a colon and the appropriate data to the page name.</p><p><em>Example:</em> <code>Prefs PAGE=transitionanimations</code><br><em>Example:</em> <code>Prefs PAGE=scripts:dopstack.js</code></p></td></tr><tr><td>PASSWORD</td><td>/K</td><td><em>&#x3C;password></em></td><td><p>Encrypt a configuration backup (used with the <strong>BACKUP</strong> or <strong>BACKUPRESTORE</strong> argument). You will need to enter the password when you restore the backup.</p><p><em>Example:</em> <code>Prefs BACKUP TO="/desktop/PrefsBackup" PASSWORD="abc123"</code></p></td></tr><tr><td>QUIET</td><td>/S</td><td><em>(no value)</em></td><td><p>Prevents the <strong>Backup and Restore Configuration</strong> wizard from appearing when the backup or restore are automated (when used with the <strong>BACKUP</strong> and <strong>RESTORE</strong> arguments). If specified when restoring a configuration, Opus will be restarted automatically - you can use the <strong>Close AUTOLISTER</strong> command to control whether a new Lister is opened when Opus restarts this way.</p><p><em>Example:</em> <code>Prefs RESTORE FROM="/desktop/PrefsBackup" QUIET</code></p></td></tr><tr><td>RESTORE</td><td>/O</td><td><em>(no value)</em></td><td><p>Automates the configuration restore process. By default all the configuration settings, toolbars, menus and hotkeys from the backup will be restored, but extra data like images and sounds are not. The optional values for this argument can be used to control which extra data is included in the restore. Use the <strong>FROM</strong> argument to specify the name of the backup file. If the backup file was encrypted you can provide the password with the <strong>PASSWORD</strong> argument. The <strong>QUIET</strong> argument prevents any user interface from being displayed, and Opus will automatically restart when the restore is complete.</p><p><em>Example:</em> <code>Prefs RESTORE FROM="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>images</strong></td><td><p>Restores images from the configuration backup (corresponds to the <strong>Restore images</strong> option in the <a href="../../../preferences/backing_up_and_restoring_preferences"><em>Backup and Restore Configuration</em></a> wizard).</p><p><em>Example:</em> <code>Prefs RESTORE=images FROM="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>sounds</strong></td><td><p>Restores sounds from the configuration backup (corresponds to the <strong>Restore sounds</strong> option in the wizard).</p><p><em>Example:</em> <code>Prefs RESTORE=images,sounds FROM="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>data</strong></td><td><p>Restores miscellaneous data (corresponds to the <strong>Restore miscellaneous data</strong> option in the wizard).</p><p><em>Example:</em> <code>Prefs RESTORE=data FROM="/desktop/PrefsBackup" QUIET</code></p></td></tr><tr><td></td><td></td><td><strong>localstate</strong></td><td><p>Restores local state data (corresponds to the <strong>Restore local state data (window positions, etc)</strong> option in the wizard).</p><p><em>Example:</em> <code>Prefs RESTORE=data,localstate FROM="/desktop/PrefsBackup" QUIET</code></p></td></tr><tr><td></td><td></td><td><strong>replace</strong></td><td><p>Replaces your existing configuration completely (corresponds to the similarly named option in the wizard). If you select this, your existing configuration is deleted before the restore is done. Without this option, the restored configuration files are written over the top of your existing configuration - but the effect of this is to merge things like toolbars and images with different names.</p><p><em>Example:</em> <code>Prefs RESTORE=replace,images,sounds FROM="/desktop/PrefsBackup"</code></p></td></tr><tr><td></td><td></td><td><strong>all</strong></td><td><p>Restores all items in the configuration backup (the equivalent of <strong>RESTORE=images,sounds,data,localstate</strong>).</p><p><em>Example:</em> <code>Prefs RESTORE=replace,all FROM="/desktop/PrefsBackup"</code></p></td></tr><tr><td>SCRIPTDISABLE</td><td>/O</td><td><em>(no value)</em></td><td><p>If no script name is given, the command toggles the global option to disable all script add-ins. This will disable any event scripts, command scripts and column scripts you have installed. This is typically used to test if problems are due to scripts or something else.</p><p>The global option does not affect the enabled/disabled state of any individual script. In other words, if a script is disabled and you then disable scripting globally, then enable scripting globally again, the script will still be disabled. The other difference between the global setting and individually disabling all scripts is that the global setting will also affect scripts which are installed after the change.</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;script name></em></td><td><p>Enable or disable the specified script or scripts. The script name should match the filename(s) of the script add-in(s) you wish to affect.</p><p>If the global option to disable all script add-ins is in effect, no individual script can be enabled.</p><p>The script name can use simple * wildcards to match multiple filenames. While this can be used to enable or disable multiple scripts at once, it is intended to avoid worrying about whether a script is installed with ".js" and ".vbs" or ".js.txt" and ".vbs.txt" style extensions.</p><p>(As a special case, if the script name wildcard is literally "*" or "*.*", the command acts the same as if no script name was specified, and toggles the global option to disable all script add-ins.)</p><p>If the script name is the only parameter, the script will be toggled (enabled if currently disabled; disabled if currently enabled). If multiple scripts match the pattern, they will all be set to the same state as the first match, and not toggled individually.</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE="My Script.js\*"</code></p><p>If a script is inside a Script Package (.osp file), the package must be included in the name:</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE="My Package.osp\My Script.vbs"</code></p><p>Wildcards can make dealing with script packages easier, and can also handle script packages which contain multiple scripts, or where you distribute a script to people as a .osp but work on it privately as a text file:</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE="My Package.osp\*"</code><br><em>Example:</em> <code>Prefs SCRIPTDISABLE="*My Script.vbs\*"</code></p></td></tr><tr><td></td><td></td><td><strong>enable</strong></td><td><p>Enable the specified script(s), or all scripts if no script name is specified.</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE="My Script.js\*,enable"</code><br><em>Example:</em> <code>Prefs SCRIPTDISABLE=enable</code></p></td></tr><tr><td></td><td></td><td><strong>disable</strong></td><td><p>Disable the specified script(s), or all scripts if no script name is specified.</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE="My Script.js\*,disable"</code><br><em>Example:</em> <code>Prefs SCRIPTDISABLE=disable</code></p></td></tr><tr><td></td><td></td><td><strong>toggle</strong></td><td><p>Toggle the specified script(s), or all scripts if no script name is specified.</p><p>(This is the default, if neither "enable" nor "disable" is specified, but you can include it if you wish to be more explicit.)</p><p><em>Example:</em> <code>Prefs SCRIPTDISABLE="My Script.js\*,toggle"</code><br><em>Example:</em> <code>Prefs SCRIPTDISABLE=toggle</code></p><p>Note that when a <strong>SCRIPTDISABLE</strong> button is a toggle, the button will appear active (e.g. checked or highlighted) when scripts are <em>disabled</em>. As with most commands, you can add <strong>@toggle:invert</strong> on a new line at the top of the command sequence to reverse this.</p><p>//<a href="example://">Example://</a></p><pre><code>@toggle:invert
Prefs SCRIPTDISABLE="Viewer Select.js,toggle"
</code></pre></td></tr><tr><td>SCRIPTEDIT</td><td>/K</td><td><em>&#x3C;script name></em></td><td><p>Launches the <a href="../../../scripting/script_editor">Script Editor</a> for the specified script. If you're working on a specific script this lets you edit it quickly without having to go via the <a href="../../../scripting/script_management">Script Management</a> interface.</p><p>The script name can use simple * wildcards to avoid worrying about whether a script is installed with ".js" and ".vbs" or ".js.txt" and ".vbs.txt" style extensions.</p><p><em>Example:</em> <code>Prefs SCRIPTEDIT="My Script.js\*"</code></p><p>If a script is inside a Script Package (.osp file), the package must be included in the name:</p><p><em>Example:</em> <code>Prefs SCRIPTEDIT="My Package.osp\My Script.vbs"</code></p></td></tr><tr><td>SCRIPTINSTALL</td><td>/O</td><td><em>(no value)</em></td><td><p>Launches the <a href="../../../scripting/script_management/installer">installer</a> to install the currently selected script file.</p><p><em>Example:</em> <code>Prefs SCRIPTINSTALL</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;file path></em></td><td><p>Launches the Script Installer to install the specified script file.</p><p><em>Example:</em> <code>Prefs SCRIPTINSTALL /downloads/CoolScript.osp</code></p></td></tr><tr><td>SCRIPTS</td><td>/O</td><td><em>(no value)</em></td><td><p>Displays the <a href="../../../scripting/script_management">Script Management</a> dialog - the centralised hub for creating, editing, managing and sharing script add-ins.</p><p><em>Example:</em> <code>Prefs SCRIPTS</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;script name></em></td><td><p>Displays the Script Management dialog, selects the specified script in the list, and (if the script has configuration items) displays its configuration dialog. The script name should match the filename of the script add-in you wish to edit the configuration of.</p><p>The script name can use simple * wildcards to avoid worrying about whether a script is installed with ".js" and ".vbs" or ".js.txt" and ".vbs.txt" style extensions.</p><p><em>Example:</em> <code>Prefs SCRIPTS="My Script.js\*"</code></p><p>If a script is inside a Script Package (.osp file), the package must be included in the name:</p><p><em>Example:</em> <code>Prefs SCRIPTS="My Package.osp\My Script.vbs"</code></p><p>Wildcards can make dealing with script packages easier, and can also handle script packages which contain multiple scripts, or where you distribute a script to people as a .osp but work on it privately as a text file:</p><p><em>Example:</em> <code>Prefs SCRIPTS="My Package.osp\*"</code><br><em>Example:</em> <code>Prefs SCRIPTS="*My Script.vbs\*"</code></p></td></tr><tr><td></td><td></td><td><strong>!scriptlist</strong></td><td><p>Generates a list of all script add-ins (acts as a <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/dynamic_buttons">dynamic button</a>).</p><p>Selecting an item from the generated list will display the Script Management dialog with that item selected (and displays its configuration dialog, if it has one).</p><p><em>Example:</em> <code>Prefs SCRIPTS=!scriptlist</code></p></td></tr><tr><td>SETLISTERDEFAULTS</td><td>/O</td><td><em>(no value)</em></td><td><p>Lets you select a Lister to save as the <a href="../../../basic_concepts/the_lister/the_default_lister">Default Lister</a>, or to set other default parameters.</p><p><em>Example:</em> <code>Prefs SETLISTERDEFAULTS</code></p></td></tr><tr><td></td><td></td><td><strong>force</strong></td><td><p>Suppress the confirmation and success prompts when setting the Default Lister manually.</p><p><em>Example:</em> <code>Prefs SETLISTERDEFAULTS=force</code></p></td></tr><tr><td></td><td></td><td><strong>quiet</strong></td><td><p>Suppress the success prompt when setting the Default Lister.</p><p><em>Example:</em> <code>Prefs SETLISTERDEFAULTS=quiet</code></p></td></tr><tr><td></td><td></td><td><strong>nodeflister</strong></td><td><p>Turns off saving of the <em>Default Lister</em> while still saving other default parameters.</p><p><em>Example:</em> <code>Prefs SETLISTERDEFAULTS=quiet,nodeflister</code></p></td></tr><tr><td></td><td></td><td><strong>toolbars</strong></td><td><p>Saves the default <a href="../../../basic_concepts/the_lister/toolbars/toolbar_sets">toolbar set</a> from the selected Lister.</p><p><em>Example:</em> <code>Prefs SETLISTERDEFAULTS=toolbars,nodeflister</code></p></td></tr><tr><td></td><td></td><td><strong>formats</strong></td><td><p>Saves the default <a href="../../../basic_concepts/folder_options/folder_formats">folder format</a> from the selected Lister.</p><p><em>Example:</em> <code>Prefs SETLISTERDEFAULTS=force,quiet,formats,toolbars,nodeflister</code></p></td></tr><tr><td>SHOWICONS</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays icons for dynamic lists generated by the <strong>LAYOUTLIST</strong>, <strong>STYLELIST</strong> and <strong>VFSPLUGINLIST</strong> arguments.</p><p><em>Example:</em> <code>Prefs LAYOUTLIST SHOWICONS</code></p></td></tr><tr><td>STYLE</td><td>/K</td><td><em>&#x3C;style name></em></td><td><p>Applies the specified <a href="../../../basic_concepts/the_lister/styles">style</a> to the current Lister.</p><p><em>Example:</em> <code>Prefs STYLE="Dual Horizontal"</code></p></td></tr><tr><td></td><td></td><td><strong>^prev</strong></td><td><p>This refers to the initial appearance of the Lister when it was opened, and lets you return to that state as if it were a normal style.</p><p><em>Example:</em> <code>Prefs STYLE=^prev</code></p></td></tr><tr><td>STYLEEDIT</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays the <a href="../../../preferences/preferences_categories/layouts_and_styles/styles"><strong>Layouts and Styles / Styles</strong></a> page in Preferences (equivalent to <code>Prefs PAGE=styles</code>).</p><p><em>Example:</em> <code>Prefs STYLEEDIT</code></p></td></tr><tr><td>STYLELIST</td><td>/O</td><td><em>(no value)</em></td><td><p>Displays a list of your saved <a href="../../../basic_concepts/the_lister/styles">Lister styles</a> (acts as a <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/dynamic_buttons">dynamic button</a>). Selecting an item from the generated list applies the specified style to the current Lister.</p><p><em>Example:</em> <code>Prefs STYLELIST</code></p></td></tr><tr><td></td><td></td><td><strong>showprevious</strong></td><td><p>Includes the special "Previous" style in the generated list. This refers to the initial appearance of the Lister when it was opened, and lets you return to that state as if it were a normal style.</p><p><em>Example:</em> <code>Prefs STYLELIST=showprevious</code></p></td></tr><tr><td>STYLESAVE</td><td>/O</td><td><em>(no value)</em></td><td><p>Saves the current appearance of the active Lister as a style.</p><p><em>Example:</em> <code>Prefs STYLESAVE</code></p></td></tr><tr><td></td><td></td><td><em>&#x3C;style name></em></td><td><p>Specifies the name for the style to create. Opus will prompt for a name if one is not provided.</p><p><em>Example:</em> <code>Prefs STYLESAVE="My Style"</code></p></td></tr><tr><td>THEMEIMPORT</td><td>/K</td><td><em>&#x3C;filename></em></td><td><p>Imports the specified theme by copying it to the configuration folder. The full pathname must be specified.</p><p><em>Example:</em> <code>Prefs THEMEIMPORT "c:\mythemes\dark.dlt"</code></p></td></tr><tr><td>THEMELOAD</td><td>/O</td><td><p><em>(no value)</em></p><p>or</p><p><strong>all</strong></p></td><td><p>All aspects of the theme specified by <strong>THEMENAME</strong> will be loaded.</p><p>The two examples below do the same thing.</p><p><em>Example:</em> <code>Prefs THEMENAME=!defaultdark THEMELOAD</code><br><em>Example:</em> <code>Prefs THEMENAME=!defaultdark THEMELOAD=all</code></p><p>Loading a theme will replace aspects of your configuration. Loading a theme via this command will <strong>not</strong> save a backup of your old settings; use the Preferences user interface instead if you need that.</p><p>If you only want to load certain aspects of the theme, use one or more of the other values, below. Separate multiple values with a single comma and no spaces.</p><p><em>Example:</em> <code>Prefs THEMENAME="Rainbow" THEMELOAD=colors,blending</code></p></td></tr><tr><td></td><td></td><td><strong>blending</strong></td><td><p>Loads the theme's <em>Color Blending</em> data.</p><p><em>Example:</em> <code>Prefs THEMENAME=!defaultlight THEMELOAD=blending</code></p></td></tr><tr><td></td><td></td><td><strong>colors</strong></td><td><p>Loads the theme's <em>Directory Opus Colors</em> data.</p><p><em>Example:</em> <code>Prefs THEMENAME="Cool" THEMELOAD=colors</code></p></td></tr><tr><td></td><td></td><td><strong>fonts</strong></td><td><p>Loads the theme's <em>Fonts</em> data.</p><p><em>Example:</em> <code>Prefs THEMENAME="Big Text" THEMELOAD=fonts</code></p></td></tr><tr><td></td><td></td><td><strong>images</strong></td><td><p>Loads the theme's <em>Images</em> data.</p><p><em>Example:</em> <code>Prefs THEMENAME="Cats" THEMELOAD=images,colors</code></p></td></tr><tr><td></td><td></td><td><strong>wincolors</strong></td><td><p>Loads the theme's <em>Windows Colors</em> data.</p><p><em>Example:</em> <code>Prefs THEMENAME="My Theme" THEMELOAD=wincolors</code></p></td></tr><tr><td>THEMENAME</td><td>/K</td><td><em>&#x3C;theme file></em></td><td><p>Specifies the filename of the theme to load, when combined with the <strong>THEMELOAD</strong> argument.</p><p>Must be the name of the <strong>.dlt</strong> theme file on disk. A theme's filename may differ from the name displayed in Preferences, but the UI can generate the whole command for you: Double-click a theme in Preferences, then open the <em>Apply</em> button's menu for an option that puts the command into the clipboard.</p><p>The <strong>.dlt</strong> extension is optional and will be added automatically if omitted.</p><p>You may specify the full path to a theme file anywhere on your system. If a full path is not given, the specified name (or relative path) is assumed to be relative to the Themes config folder.</p><p><em>Example:</em> <code>Prefs THEMENAME="My Theme" THEMELOAD</code></p></td></tr><tr><td></td><td></td><td><strong>!defaultdark</strong></td><td><p>Loads the internal <em>Default Dark</em> theme, effectively resetting some or all of your cosmetic settings.</p><p><em>Example:</em> <code>Prefs THEMENAME="!defaultdark" THEMELOAD</code></p></td></tr><tr><td></td><td></td><td><strong>!defaultlight</strong></td><td><p>Loads the internal <em>Default Light</em> theme, effectively resetting some or all of your cosmetic settings.</p><p><em>Example:</em> <code>Prefs THEMENAME="!defaultlight" THEMELOAD</code></p></td></tr><tr><td>TO</td><td>/K</td><td><em>&#x3C;backup file></em></td><td><p>Specifies the filename for the configuration backup (used with the <strong>BACKUP</strong> or <strong>BACKUPRESTORE</strong> argument).</p><p><em>Example:</em> <code>Prefs BACKUP TO="/mydocuments/OpusPrefsBackup {date|yyyy-MM-dd}"</code></p></td></tr><tr><td>TOOLBARS</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays the <strong>Toolbars</strong> tab in the <strong>Customize</strong> dialog (equivalent to <code>Prefs CUSTOMIZE=toolbars</code>).</p><p><em>Example:</em> <code>Prefs TOOLBARS</code></p></td></tr><tr><td>VFSPLUGINABOUT</td><td>/K</td><td><em>&#x3C;plugin name></em></td><td><p>Displays the <strong>About</strong> dialog for the specified <a href="../../../preferences/preferences_categories/zip_and_other_archives/archive_and_vfs_plugins">VFS plugin</a>.</p><p><em>Example:</em> <code>Prefs VFSPLUGINABOUT opus7zip.dll</code></p></td></tr><tr><td>VFSPLUGINCONFIG</td><td>/K</td><td><em>&#x3C;plugin name></em></td><td><p>Displays the <strong>Configuration</strong> dialog for the specified VFS plugin.</p><p><em>Example:</em> <code>Prefs VFSPLUGINCONFIG opus7zip.dll</code></p><p>A single VFS plugin DLL may present itself as multiple types. For example, the Archives plugin (opus7zip.dll) which comes with Opus has separate types for 7z, RAR, ISO, and so on. To display the config window for a particular type, add a ':' character and then the name of the type, as found in the Preferences VFS Plugins page.</p><p><em>Example:</em> <code>Prefs VFSPLUGINCONFIG opus7zip.dll:7z</code></p></td></tr><tr><td>VFSPLUGINDISABLE</td><td>/K</td><td><em>&#x3C;plugin name></em></td><td><p>Enable or disable the specified VFS plugin. If the plugin is currently enabled it will be disabled, and vice versa.</p><p><em>Example:</em> <code>Prefs VFSPLUGINDISABLE opus7zip.dll</code></p><p>A single VFS plugin DLL may present itself as multiple types. For example, the Archives plugin (opus7zip.dll) which comes with Opus has separate types for 7z, RAR, ISO, and so on. If you specify just the name of the DLL, the entire plugin will be toggled. You can also toggle individual types (assuming the plugin as a whole is still enabled) by adding a ':' character after the DLL name and then the name of the type, as found in the Preferences VFS Plugins page.</p><p><em>Example:</em> <code>Prefs VFSPLUGINDISABLE opus7zip.dll:rar</code></p></td></tr><tr><td></td><td></td><td><strong>enable</strong></td><td><p>Enable the specified VFS plugin.</p><p><em>Example:</em> <code>Prefs VFSPLUGINDISABLE opus7zip.dll,enable</code></p></td></tr><tr><td></td><td></td><td><strong>disable</strong></td><td><p>Disable the specified VFS plugin.</p><p><em>Example:</em> <code>Prefs VFSPLUGINDISABLE opus7zip.dll,disable</code></p></td></tr><tr><td></td><td></td><td><strong>toggle</strong></td><td><p>Toggling is the default, if neither "enable" nor "disable" is specified, but you can specify "toggle" if you wish to be more explicit.</p><p>Note that when a <strong>VFSPLUGINDISABLE</strong> button is a toggle, the button will appear active (e.g. checked or highlighted) when plugins are <em>disabled</em>. As with most commands, you can add <strong>@toggle:invert</strong> on a new line at the top of the command sequence to reverse this.</p><p>//<a href="example://">Example://</a></p><pre><code>@toggle:invert
Prefs VFSPLUGINDISABLE="opus7zip.dll,toggle"
</code></pre></td></tr><tr><td>VFSPLUGINLIST</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays a list of the installed VFS plugins (acts as a <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/dynamic_buttons">dynamic button</a>). Each plugin in the list has a sub-menu containing <em>about</em>, <em>configure</em>, and <em>enable/disable</em> commands.</p><p><em>Example:</em> <code>Prefs VFSPLUGINLIST</code></p></td></tr><tr><td>VFSPLUGINMANAGER</td><td>/S</td><td><em>(no value)</em></td><td><p>Displays the <a href="../../../preferences/preferences_categories/zip_and_other_archives/archive_and_vfs_plugins"><strong>Zip &#x26; Other Archives / Archive and VFS Plugins</strong></a> page in Preferences (equivalent to <code>Prefs PAGE=vfsplugins</code>).</p><p><em>Example:</em> <code>Prefs VFSPLUGINMANAGER</code></p></td></tr></tbody></table>

**Viewer Plugins:** See the separate [**Show command**](show) for managing Viewer Plugins.
