# Recent

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

* Display a dynamic list of your [Recent folders](../../../basic_concepts/the_lister/navigation/recent_and_history_lists)
* Filter the recent to display only folders beneath a certain path
* Clear the Recent list

**Command Arguments:**

| Argument        | Type | Possible values              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------- | ---- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| _(no argument)_ | -    | -                            | <p>Displays a dynamically generated list of your <a href="../../../basic_concepts/the_lister/navigation/recent_and_history_lists">recently visited folders</a> - you can navigate to a folder simply by selecting it from this list. Acts as a <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/dynamic_buttons">dynamic button</a>.</p><p>Some of the arguments of this command can modify the appearance and behaviour of the dynamic list.</p><p><em>Example:</em> <code>Recent</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| CLEAR           | /S   | _(no value)_                 | <p>Clears the recent folders list.</p><p><em>Example:</em> <code>Recent CLEAR</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| COPY            | /O   | \<Copy command arguments>    | <p>Selecting a folder from the recent list will trigger the <strong>Copy</strong> command with the specified arguments. For example, you could have one drop-down recent list for <strong>Copy</strong> and another for <strong>Move</strong>, using different arguments. Note that if more than one <strong>Copy</strong> command argument is specified they must be enclosed in quotes.</p><p><em>Example:</em> <code>Recent COPY</code><br><em>Example:</em> <code>Recent COPY MOVE</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| HEADING         | /O   | _(no value)_                 | <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>Recent HEADING</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                 |      | _\<heading text>_            | <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>Recent HEADING="Recent Paths"</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| KEYARGS         | /K/M | _\<qualifier:arguments> ..._ | <p>When displaying the recent list, 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.</p><p>For example, you could configure your Recent menu to open folders in a new tab by default, but in a new Lister if the Ctrl key were held down.</p><p>The qualifier part of the value consists of one or more keywords that represent the qualifier keys - <strong>ctrl</strong>, <strong>shift</strong> and <strong>alt</strong>. These can be combined, for example <strong>ctrlshift</strong> means that both the Ctrl and Shift keys must be held down. You can also use the keyword <strong>none</strong> to indicate arguments that are applied when no qualifiers are held.</p><p>You can also assign the <strong>Copy</strong> command to a particular key combination; selecting an item from the recent list with the appropriate key held down would then copy (or move) selected files to the recent location.</p><p><em>Example:</em> <code>Recent KEYARGS "ctrl:NEW" "shift:Copy MOVE" "none:NEWTAB=findexisting"</code></p> |
| MULTIFUNC       | /O   | _(no value)_                 | <p>The generated list of recent folders will be <a href="../../../customize/creating_your_own_buttons/editing_the_toolbar/multiple_function_buttons">multiple function buttons</a> (three-button buttons) - clicking them with the left mouse button will act as if <strong>OPENINLEFT</strong> were set, the right button will act as if <strong>OPENINRIGHT</strong> were set, and the middle mouse button will act as if <strong>NEW</strong> were set.</p><p><em>Example:</em> <code>Recent MULTIFUNC</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                 |      | **tabs**                     | <p>Similar to the above except the left and right mouse button functions will open a new tab on the appropriate side of the Lister. You can control how new tabs are opened with the <strong>NEWTAB</strong> argument.</p><p><em>Example:</em> <code>Recent MULTIFUNC=tabs</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| NAMESONLY       | /S   | _(no value)_                 | <p>Each item in the list will only display its respective folder's name, not the full path. Full paths are displayed in tooltips instead.</p><p><em>Example:</em> <code>Recent NAMESONLY</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| NEW             | /S   | _(no value)_                 | <p>Recent folders selected from the list generated by this command will open in a new Lister instead of the current one.</p><p><em>Example:</em> <code>Recent NEW</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| NEWTAB          | /O   | _(no value)_                 | <p>Recent folders selected from the list generated by this command will open in a <a href="../../../basic_concepts/the_lister/tabs">new tab</a>.</p><p><em>Example:</em> <code>Recent NEWTAB</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                 |      | **deflister**                | <p>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.</p><p><em>Example:</em> <code>Recent NEWTAB=deflister</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                 |      | **findexisting**             | <p>Look for the folder in an existing tab before opening a new one. If found, the existing tab will be brought to the front; otherwise a new tab will be opened. The active tab is checked first, and nothing will happen if the active tab already displays the selected path.</p><p><em>Example:</em> <code>Recent NEWTAB=findexisting</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|                 |      | **findinactive**             | <p>Like <strong>findexisting</strong>, except that if the active tab already has the selected path then a new tab will be opened. Intended for buttons which switch to existing tabs to reduce clutter while retaining the ability to open a second tab for the same folder when needed.</p><p><em>Example:</em> <code>Recent NEWTAB=findinactive</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|                 |      | **nofocus**                  | <p>New tabs opened by recent folders selected from the list will not be brought to the front.</p><p><em>Example:</em> <code>Recent NEWTAB=nofocus OPENINDUAL</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                 |      | **tofront**                  | <p>If the folder was found in an existing tab, bring that tab to the front (only used with <strong>findexisting</strong>).</p><p><em>Example:</em> <code>Recent NEWTAB=findexisting,tofront</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| NOLABEL         | /S   | _(no value)_                 | <p>The recent list displayed by this command will not show any labels for the folders.</p><p><em>Example:</em> <code>Recent NOLABEL</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| OPENINDEST      | /S   | _(no value)_                 | <p>Recent folders selected from the list will open in the destination file display or Lister.</p><p><em>Example:</em> <code>Recent OPENINDEST</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| OPENINDUAL      | /S   | _(no value)_                 | <p>Recent folders 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.</p><p><em>Example:</em> <code>Recent OPENINDUAL</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| OPENINLEFT      | /S   | _(no value)_                 | <p>Recent folders will open in the left-hand (or top) display of a dual-display Lister.</p><p><em>Example:</em> <code>Recent KEYARGS none:OPENINLEFT ctrl:OPENINRIGHT</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| OPENINRIGHT     | /S   | _(no value)_                 | <p>Recent folders will open in the right-hand (or bottom) display of a dual-display Lister.</p><p><em>Example:</em> <code>Recent NEWTAB OPENINRIGHT</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| PATH            |      | _\<path>_                    | <p>Filters the displayed recent list to only show folders matching or below the specified path. This is the default argument for the <strong>Recent</strong> command and so you do not need to specify the <strong>PATH</strong> keyword. Make sure you enclose the path in quotes if it contains spaces.</p><p>``Recent C:\`</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| SHOWICONS       | /S   | _(no value)_                 | <p>The recent list displayed by this command will display icons for the items within it. Note that the button that contains the <strong>Recent</strong> command must also have its <strong>Show image</strong> option turned on.</p><p><em>Example:</em> <code>Recent SHOWICONS</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| USEQUALKEYS     | /S   | _(no value)_                 | <p>Activates pre-configured behaviour for the main qualifier keys - <strong>Control</strong> will open the recent folder in the dual-display, <strong>Shift</strong> in a new Lister and <strong>Alt</strong> in a new tab.</p><p>This is equivalent to <code>Recent KEYARGS ctrl:OPENINDUAL shift:NEW alt:NEWTAB</code>.</p><p><em>Example:</em> <code>Recent USEQUALKEYS</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
