# FileZilla 3 Icon set specification

## Introduction

This document describes the requirements for icon sets in FileZilla 3.

Please remember that if you want to create an icon set for FileZilla, that you should be available to update the icon set in the future when additional icon are added to the requirements. Otherwise the default icons will be used for the missing icons and eventually your theme will be removed once it becomes too outdated.

## Requirements

Since FileZilla is Free Software, the same has to apply to all artwork used in FileZilla. This means that all artwork has to be published under the GPL or a GPL compatible license. Note that the Creative Commons Attribution license is not compatible with the GPL.

Each icon set should follow a theme, the icons should match nicely. Also, the function of the icon has to be easily recognizable.

You should combine use of both color and shape. The icons are usually displayed on a light background, though as we have no control over the background, all icons must also be recognizable on dark backgrounds or oddly coloured backgrounds. Avoid monochromatic icons.

### Icon sizes

All icons must exist in scalable form to accomodate modern high-DPI displays.

The minimum size at which an icon can be displayed is 16x16 pixels. It is important, that the icons are good-looking at small sizes. Especially the smallest icon size should not look blurred beyond recognition. To improve visibily at these low sizes you can include icons in pre-rasterized form.

The most commonly used small icon sizes are:

- 16x16
- 20x20
- 24x24
- 32x32
- 32x32
- 48x48

### Color depth

Regarding the used color-depth there is no limitation.

### File formats

All icons have to be submitted in the Scalable Vector Graphics (SVG) format and placed into a subdirectory named "scalable".

As file format for optional fixed-size icons supplementing the scalable versions, the Portable Network Graphics (PNG) format has to be used. For each provided size there has to be a subdirectory with the size as name ("16x16" for example) containing all icons in the corresponding size.

## Required icons

The following icons together with the required file name are required in all icon sets for FileZilla:

General toolbar:

- sitemanager - Sitemanager
- localtreeview, remotetreeview, logview, queueview - Togglebuttons for the local directory tree, for the remote directory tree, the message log, and the transfer queue.
- refresh - a button to refresh directory listings
- processqueue - a button that starts/stops processing of the Transfer Queue
- cancel - cancels the current operation
- disconnect - Closes connection to the server
- reconnect - Reconnects to the most recently used server
- help - a help button

Browsing toolbar:

- synchronize - Synchronized directory browsing: If user changes the local directory, the remote directory changes as well, and vice-versa
- synctransfer - Synchronize contents of two directories: Transfer files from the source directory missing in the target directory, delete files from the target directory not existing in the source directory
- compare - Compare local and remote directories: File entries in the file lists will receive a coloured background if they exist either only on the local or remote side, or when the file attributes differ.
- showhidden - show hidden files
- filter - filter directory listings to remove unwanted files. Note about metaphors: Funnels are not filters, don't use a funnel metaphor.
- find - search for files

Transfer settings toolbar:

- speedlimits - Button to enable speed limits

Context menus

- upload - Upload selected local files
- uploadadd - Add selected local files to queue for later upload
- download - Download selected remote files
- downloadadd - Add selected remote files to queue for later download

Other generic icons:

- ascii, auto, binary - Transfermode icons for Ascii, binary and Auto mode.
- bookmarks - Bookmarks/Favourites
- bookmark - Individual Bookmark/Favourite
- folderup - "Go up one directory"
- folderback - "Go back to previous directory"
- file - icon for generic files
- folder - icon for open directory
- folderclosed - icon for a closed directory, e.g. a collapsed directory tree icon
- lock - used in status bar to indicate encrypted connections
- server - server icon for the site entries in the Site Manager
- symlink - overlay icon used in file lists to indicate that the displayed item represents a symbolic link. Note: It should only fills the lower-left quadrant of the icon