Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
xfce:xfce4-appfinder:preferences [2012/01/08 00:08] – created nickxfce:xfce4-appfinder:preferences [2024/12/11 11:18] (current) – kevinbowen
Line 1: Line 1:
-====== Preferences ======+~~NOTOC~~ 
 +{{ xfce:xfce4-appfinder.png?nolink|}} 
 +====== xfce4-appfinder - Preferences ====== 
 +This page details all of the settings available for the Application Finder. To edit the settings, open up the application in its expanded mode and select {gui>Preferences}.
  
-<note warning>This page is work in progress!</note>+  * **[[#General|General]]** 
 +    * **[[#Behaviour|Behaviour]]** 
 +    * **[[#Appearance|Appearance]]** 
 +    * **[[#History|History]]** 
 +  * **[[#Custom Actions|Custom Actions]]** 
 +    * **[[#Usage|Usage]]** 
 + 
 +----
  
 ===== General ===== ===== General =====
  
-<figure "General Preferences"> +<figure "xfce4-appfinder General Preferences Tab"> 
-{{:xfce:xfce4-appfinder:xfce4-appfinder-preferences-general.png?nolink&|}}+{{:xfce:xfce4-appfinder:xfce-appfinder-genprefs.png?400|xfce4-appfinder General Preferences Tab}}
 </figure> </figure>
  
-===== Actions =====+----
  
-<figure "Custom Actions"> +==== Behaviour ==== 
-{{:xfce:xfce4-appfinder:xfce4-appfinder-preferences-actions.png?nolink&|}}+ 
 +? 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:|Xfwm4]] might position the window in a place that isn't in the centre of the screen (see the section [[:xfce:xfwm4: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. 
 +? Sort recently user items first 
 +! Sort items by frequency, i.e. taking into account the frequency and how recent an item has been launched. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +==== 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. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 + 
 + 
 +===== 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. 
 + 
 +<figure "xfce4-appfinder Custom Actions Tab"> 
 +{{:xfce:xfce4-appfinder:xfce-appfinder-custacts.png|xfce4-appfinder Custom Actions Tab}}
 </figure> </figure>
 +
 +
 +[[|Back to Top]]
 +----
 +
 +
 +==== 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.
 +
 +  
 +
 +[[|Back To Top]]
 +----
 +[[:xfce:xfce4-appfinder:start:|Return to xfce4-appfinder Main Documentation Page]]