Favorites

The Favorites internal command can be used to:

 

Command Arguments:

Argument

Type

Possible values

Description

(no argument)

-

-

Displays a dynamically generated list of your favorite folders - you can navigate to a folder simply by selecting it from this list. Acts as a dynamic button.

Some of the arguments of this command can modify the appearance and behaviour of the dynamic list. Note the PATH argument lets you optionally specify a sub-branch of the Favorites list.

Example: Favorites

ADD

/O

(no value)

Add the current source folder to your Favorites list. The entire path of the folder will be displayed in the Favorites list by default.

Example: Favorites ADD

 

 

nameonly

Add the current source folder to your Favorites list, with the name of the favorite entry set to the name of the folder (so that only the name shows in the Favorites list, not the entire path).

Example: Favorites ADD=nameonly

 

 

alias

Add a folder alias instead of a favorite.

Example: Favorites ADD=alias PATH "C:\Users\Jon\Documents"

ADDDIALOG

/S

(no value)

Display a dialog that lets you edit the name and path when adding a new favorite folder.

Example: Favorites ADDDIALOG

EDIT

/S

(no value)

Display the Favorites and Recent / Favorites List page in Preferences.

Example: Favorites EDIT

KEYARGS

/K/M

<qualifier:arguments> ...

When displaying a list of favorites, this argument lets you assign different behaviour to the items in the list if a qualifier key is held down. This is a multiple value argument - for each qualifier key combination listed, you can define a separate set of arguments that will be used when the item in the list is selected.

For example, you could configure your favorites menu to open favorite folders in a new tab by default, but in a new Lister if the Control key were held down.

The qualifier part of the value consists of one or more keywords that represent the qualifier keys - ctrl, shift and alt. These can be combined, for example ctrlshift means that both the Control and Shift keys must be held down. You can also use the keyword none to indicate arguments that are applied when no qualifiers are held.

Example: Favorites KEYARGS "ctrl:NEW" "none:NEWTAB=findexisting"

NAME

/K

<name>

Specifies the name of the newly created favorite or alias. If a name is not provided, the name of the folder will be used by default.

Example: Favorites ADD=alias NAME=docs PATH "C:\Users\Jon\Documents"

NEW

/S

(no value)

Favorites selected from the list generated by this command will open in a new Lister instead of the current one.

Example: Favorites NEW

NEWTAB

/O

(no value)

Favorites selected from the list generated by this command will open in a new tab.

Example: Favorites NEWTAB

 

 

deflister

If no lister exists, the Default Lister will open with an additional tab for the folder. If a lister exists, the folder will open normally in a new tab within the existing lister.

Example: Favorites NEWTAB=deflister

 

 

findexisting

Look for the folder in an existing tab before opening a new one.

Example: Favorites NEWTAB=findexisting

 

 

nofocus

New tabs opened by favorites selected from the list will not be brought to the front.

Example: Favorites NEWTAB=nofocus OPENINDUAL

 

 

tofront

If the folder was found in an existing tab, bring that tab to the front (only used with findexisting).

Example: Favorites NEWTAB=findexisting,tofront

NOLABEL

/S

(no value)

The favorites list displayed by this command will not show any labels for the favorite folders.

Example: Favorites NOLABEL

NOOPENINTABS

/S

(no value)

Do not add the Open in tabs command that is normally displayed at the bottom of the generated favorites list.

Example: Favorites NOOPENINTABS

OPENINDEST

/S

(no value)

Favorites selected from the list will open in the destination file display or Lister.

Example: Favorites OPENINDEST

OPENINDUAL

/S

(no value)

Favorites selected from the list will open in the other file display of a dual-display Lister. The Lister will be set to dual-display mode if it isn't in that mode already.

Example: Favorites OPENINDUAL

OPENINLEFT

/S

(no value)

Favorites will open in the left-hand (or top) display of a dual-display Lister.

Example: Favorites KEYARGS none:OPENINLEFT ctrl:OPENINRIGHT

OPENINRIGHT

/S

(no value)

Favorites will open in the right-hand (or bottom) display of a dual-display Lister.

Example: Favorites NEWTAB OPENINRIGHT

PATH

 

<folder path>

When used with the ADD argument, specifies the path to add as a favorite or alias. Without this, the current source folder will be used.

When used without the ADD argument, this modifies the dynamically generated list of favorite folders to only show the contents of a specified sub-branch of the favorites list. The branch path must be preceded with an asterisk.

This is the default argument for the Favorites command; you do not need to specify the PATH keyword itself.

Example: Favorites /desktop ADD
Example: Favorites *Projects

SHOWICONS

/S

(no value)

The favorites list displayed by this command will display icons for the items within it. Note that the button that contains the Favorites command must also have its Show image option turned on. 

Example: Favorites SHOWICONS

SMART

/O

(no value)

Generates a dynamic list of SmartFavorites instead of the regular Favorite list. The number of folders displayed in the list is specified on the Favorites and Recent / SmartFavorites Preferences page.

Example: Favorites SMART

 

 

<number of items>

Display the specified number of SmartFavorites (overrides the number set in Preferences).

Example: Favorites SMART 20 SHOWICONS NEWTAB

USEQUALKEYS

/S

(no value)

Activates pre-configured behaviour for the main qualifier keys - Control will open the favorite folder in the dual-display, Shift in a new Lister and Alt in a new tab.

This is equivalent to KEYARGS ctrl:OPENINDUAL shift:NEW alt:NEWTAB.

Example: Favorites USEQUALKEYS