Editing Filename Filters

Filename filters provide a way to filter out files and directories with respect to both visibility and transfers.

= Showing Filters =

To show and configure filters: 
* click on the proper toolbar icon (the 4th from the right), or 
* select "View > Filename filters...". 

This will bring up the Filters dialog box, that shows : 
* on the left side : the local filters 
* on the right side : the remote filters. 

Multiple filters may be active at a time &mdash; those filters that are active will have a check next to them.

= Modifying Filters =

To modify filters, select the "Edit filter rules..." button at the bottom left of the filter dialog. This opens the "Edit filters" dialog, that shows:
* On the left side : a list of existing filters (which may or may not be active). 
* On the right side : the select criteria for the filter selected on the left panel. 

To rename, copy or delete a filter, select the existing filter and hit the appropriate button below.

= Creating a New Filter =

To create a new filter: 
* Press the New button, 
* Enter the filter name. The filter will appear in the left-hand pane, and will be selected. 
* Edit the filter settings, as described bellow.

== The 'Filter Conditions' box ==

Choose if the filter match : 
* Any, 
* All, or 
* None
of the criteria defined bellow. 

== Filter Criteria ==

Your option on the left box define the options available on the middle box, described right ahead, and what you will type on the right box. 

=== Name Criteria ===

Filename and Path allow the same options on the middle box. They can be one of the following:
* contains : matches if the file/directory name contains the specified literal string.
* is equal to : matches if the file/directory name exactly matches the specified literal string.
* begins with : matches if the file/directory name begins with the specified literal string.
* ends with : matches if the file/directory name ends with the specified literal string.
* matches regex : matches the specified [[Regular_Expressions|regular expression]].


=== Size Criteria ===

Filesize criteria can be one of the following:
; greater than :
; equals : 
; less than :

=== Attribute Criteria (Windows only) ===

File attribute criteria test for boolean flags (true or false) corresponding to file or directory attributes. The following attribute criteria are supported:

; archived :
; compressed :
; encrypted :
; hidden :
; read-only :
; system :

=== Attribute Criteria (non-Windows only) ===

File permissons criteria test for boolean flags (true or false) corresponding to file or directory permissions. The following permission criteria are supported:

; owner readable :
; owner writeable :
; owner executable :
; group readable :
; group writeable :
; group executable :
; world readable :
; world writeable :
; world executable :

== Contextual Conditions ==

At the bottom of the "Edit filters" dialog box, you can also find : 
* a checkbox to make filter conditions (I guess specifically Filter ''Name'' conditions) case sensitive. Newly created filters have this box unchecked, so names are matched regardless of actual letter case.
* two checkboxes where you can select whether the conditions apply to files, or to directories. Both boxes may be checked at the same time. Newly created filters have both files and directories are checked.

== Adding and Removing Criteria ==

To remove a criterion from a filter, click in the blank area to the left of the criteria fields. This should highlight the entire row. Select the "Remove <u>s</u>elected" button to delete the selected criterion.

= Filter Sets =
A selection state of filters can be saved as a ''Filter Set'', from the "Directory listing filters" dialog box.