| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| xfce:xfce4-appfinder:preferences [2012/01/11 20:15] – [Usage] nick | xfce:xfce4-appfinder:preferences [2024/12/11 11:18] (current) – kevinbowen |
|---|
| ====== 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> |
| | |
| | ---- |
| |
| ==== Behaviour ==== | ==== Behaviour ==== |
| ? Remember last selected category | ? 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. | ! 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 | ? Always centre 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. | ! 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 ==== | ==== Appearance ==== |
| |
| ? View items as icons | ? View items as icons |
| ! Select this option to show the applications and command in a //icon view// instead of a //list view//. | ! Select this option to show the applications and commands as icons rather than in a list view. |
| ? Text beside icons | ? 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. | ! 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 | ? Item icon size |
| ! The size of the icons in the item view. | ! The size of the icons in the item view. |
| | ? Hide category pane |
| | ! Hides the category side pane when in expanded mode. |
| ? Category icon size | ? Category icon size |
| ! The size of the category icons in the side-pane. | ! The size of the category icons in the side pane. |
| | |
| | ---- |
| |
| ==== History ==== | ==== History ==== |
| |
| ? Clear custom command 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. | ! 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 ===== | [[|Back to Top]] |
| | ---- |
| |
| <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. | ===== 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. |
| |
| It can for example be use the make shortcuts to commands, but also to send arguments to a website, for quick searching. | <figure "xfce4-appfinder Custom Actions Tab"> |
| | {{:xfce:xfce4-appfinder:xfce-appfinder-custacts.png|xfce4-appfinder Custom Actions Tab}} |
| | </figure> |
| |
| By default 4 custom actions are predefined, but you can change this to anything you like. | |
| |
| ==== Usage ==== | [[|Back to Top]] |
| | ---- |
| |
| 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. | ==== 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 | ? Type |
| ! There are two types of pattern matches. | ! 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}. | * **Prefix** - if this type is selected, there is a match if the entered string starts with the pattern specified. |
| ? Regular Expression | * **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. |
| ! 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 | ? Pattern |
| ! Depending on the selected {gui>type} it will describe the matching prefix or regular expression. | ! Depending on the type selected, it describes the prefix or regular expression. |
| ? Command | ? Command |
| ! The command that is executed when the command is matched. To include (parts) of the match the following varaibles are available: | ! 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 | ? Prefix |
| ? %s | ! **%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''. |
| ! 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 matched pattern. For example, if the prefix-pattern is ''abc'' and the entered command is ''abcdef'', ''%s'' will be replaced with ''abcdef''. |
| ? %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 | ? 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. | ! 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'', ''\1'' will be replaced with ''cde''. | ! 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]] |