====== Preferences ====== This page details all the settings available for the Application Finder. To edit settings, open up the application in it's expanded mode and select {gui>Preferences}. ===== General =====
{{:xfce:xfce4-appfinder:4.14:xfce-appfinder-genprefs.png?400|}}
==== Behaviour ==== ? Remember last selected category ! Select this option to make the Application Finder select the last selected category in the expanded view. If this option is disabled, the category {gui>All Applications} is selected. ? Always centre the window ! By default, [[:xfce:xfwm4:4.14:|Xfwm4]] might position the window in a place that isn't in the centre of the screen (see the section [[:xfce:xfwm4:4.14:wmtweaks|Placement]] under Window Manager Tweaks to change this behaviour). Select this option to always centre the Application Finder screen on startup, regardless of Window Manager settings. ? Keep running instance in the background ! Keeps Application Finder running in the background to speed up opening times. You might want to disable this to reduce memory usage. ? Single window ! This option in only active if {gui>Keep running instance in the background} is enabled. Only keep one instance of the application open at a time. ==== Appearance ==== ? View items as icons ! Select this option to show the applications and commands as icons rather than in a list view. ? Text beside icons ! This option in only active if {gui>View items as icons} is enabled. Select this option to position the application name or command beside the icon rather than below. ? Item icon size ! The size of the icons in the item view. ? Hide category pane ! Hides the category side pane when in expanded mode. ? Category icon size ! The size of the category icons in the side pane. ==== History ==== ? Clear Custom Command History ! Use this option to remove the history of custom commands you've entered in the collapsed mode that did not match any of the installed application commands. ===== Custom Actions ===== You can set custom actions to quickly perform tasks when a certain character or combination of characters is entered in the collapsed view. For example, you can go to a certain article on Wikipedia by typing ''!w'' and then the article name.
{{:xfce:xfce4-appfinder:4.14:xfce-appfinder-custacts.png?nolink&|}}
==== Usage ==== You can add a new (empty) action by clicking on the {gui>Add} (+) button and remove the selected action by pressing the {gui>Delete} (x) button. You can edit an existing action by selecting it from the list and using the {gui>Type}, {gui>Pattern} and {gui>Command} fields. ? Type ! There are two types of pattern matches: * **Prefix** - if this type is selected, there is a match if the entered string starts with the pattern specified. * **Regular Expression** - For complex matches you can write a [[https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions|Perl-compatible regular expression]] that's matched against the entered string. ? Pattern ! Depending on the type selected, it describes the prefix or regular expression. ? Command ! The command that is executed when the pattern is matched. To include parts of the search in the command the following variables are available: ? Prefix ! **%s** - Include the string after the matched pattern. For example, if the prefix-pattern is ''abc'' and the entered command is ''abcdef'', ''%s'' will be replaced with ''def''. ! **%S** - Include the complete string after the matched pattern. For example, if the prefix-pattern is ''abc'' and the entered command is ''abcdef'', ''%s'' will be replaced with ''abcdef''. ? Regular Expression ! During the process of matching, the results of the sub-pattern between parentheses ''( )'' are recorded for later use. ''\'' plus a number to refers to the corresponding sub-string. For instance, ''\1'' refers to the 1st pair of parentheses' match result, while ''\2'' refers to 2nd pair of parentheses' match result. A special case is ''\0'', which will be replaced with the entire match. ! If the pattern is ''^ab(.*)fg$'' and the entered command ''abcdefg'' for example, ''\1'' will be replaced with ''cde''. ? Save match in command history ! Select this option if you want matches to be saved in the {gui>Commands History} category.