====== Preferences ======

===== General =====

<figure "General Preferences">
{{:xfce:xfce4-appfinder:xfce4-appfinder-preferences-general.png?nolink&|}}
</figure>

==== 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 center the window
! By default [[../xfwm4:|Xfwm4]] will position the window, possibly not in the center of the screen (see the section [[..:xfwm4:wmtweaks|Smart Placement]] to control this behaviour). Select this option to always center the Application Finder screen on startup.

==== Appearance ====

? View items as icons
! Select this option to show the applications and command in a //icon view// instead of 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, instead of below.
? Item icon size
! The size of the icons in the item view.
? 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.

===== Actions =====

<figure "Custom Actions">
{{:xfce:xfce4-appfinder:xfce4-appfinder-preferences-actions.png?nolink&|}}
</figure>

==== Introduction ====

Custom actions can be used to match commands entered in the collapsed view and use them to quickly perform tasks.

It can for example be use the make shortcuts to commands, but also to send arguments to a website, for quick searching.

By default 4 custom actions are predefined, but you can change this to anything you like. See also the [[examples]] in the dedicated wiki page.

==== 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.

Strings in the Application Finder by the {gui>type} and {gui>pattern} or the action. If there is a match, the {gui>command} is executed as a replacement for the entered string.

? Type
! There are two types of pattern matches.
  ? Prefix
  ! If this type is selected, there is a match if the entered string starts with {gui>pattern}.
  ? Regular Expression
  ! For complex matches you can write a [[https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions|Perl-compatible regular expression]] that is matched against the entered string.
? Pattern
! Depending on the selected {gui>type} it will describe the matching prefix or regular expression.
? Command
! The command that is executed when the pattern is matched. To include (parts) of the match the following variables are available:
  ? Prefix
    ? %s
    ! Include the string after the matched pattern. So if the prefix-pattern is ''abc'' and the entered command ''abcdef'', ''%s'' will be replaced with ''def''.
    ? %S
    ! Include the complete string after the matches pattern. So if the prefix-pattern is ''abc'' and the entered command ''abcdef'', ''%s'' will be replaced with ''abcdef''.
  ? Regular Expression
  ! During the process of matching, the match results of subpattern between parentheses ''( )'' are recorded for later use. ''\'' plus a number to refer to the corresponding substring. ''\1'' refers to 1st pair of parentheses' match result, ''\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'', ''\1'' will be replaced with ''cde''.