Filename Filters

From FileZilla Wiki
Jump to navigationJump to search

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

Configuring Filters

To configure filters, click on the toolbar icon, or use the drop-down menu to go to "View > Filename filters...". This will bring up a dialog box showing the local filters on the left side, and the remote filters on the right side. Multiple filters may be active at a time — those filters that are active will have a check next to them.

Creating & Modifying Filters

To modify filters, select the "Edit Filters" button at the top right of the filter dialog. This will open the "Edit filters" dialog.

On the left side, you'll see a list of existing filters (which may or may not be active). 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. At that point, the filter will appear in the left-hand pane, and will be selected. At this point, you're ready to edit the filter settings.

Filter Criteria

Match Any, All, or None

Name Criteria

Filename critera 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 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

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

In addition, 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.

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 selected" 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.