# puddletag

## - A tag editor for GNU/Linux (Documentation).

# Filter Expressions

Filter expressions can be used to display only files in the file-view that match a certain criteria. They can be entered into the Filter Panel (Windows->Filter or F3).

The filter expression will be evaluated for each file loaded. If it evaluates to True for a file, then that file will be shown. Otherwise, puddletag will hide it. All comparisons are case-insensitive.

## Strings

- Strings are either a single word containing no white-space eg. Thisisvalid is a valid string but No spaces are allowed is not a valid string.

- Anything enclosed in double-quotes will be regarded as a string. Eg “You can do this” or even “artist”.

- Strings not enclosed in double quotes will be assumed to be a field. The field’s value as stored in the file will be used provided:
    - The field is listed in Tag Reference. If the field isn’t present in the file it’ll evaluate to an empty string. Eg artist or title, but not madeupfield.
    - The field is present in the file. If not the string will be interpreted as normal text.

- Any text in the form %string% (if it’s not enclosed in quotes) will be assumed to be a field.

## Expressions

`string`

  Evaluates to True if a contains string in any of it’s fields.

`MISSING field`

  Evaluates to True if field is not present in a file. Eg. MISSING artist or MISSING style

`PRESENT field`

  Evaluates to True if field is present in a file. Eg. PRESENT artist or PRESENT style

`expr1 GREATER expr2`

  Evaluates to True if expr1 is greater than expr2. Conversion to floats will be attempted first. For strings comparision using ASCII positions are done. Eg. track GREATER replay_gain, artist GREATER “some words”.

`expr1 LESS expr2`

  Evaluates to True if expr1 is less than expr2. Conversion to floats will be attempted first. For strings comparision using ASCII positions are done. Eg. track LESS replay_gain, artist LESS “some words”.

`expr1 EQUAL expr2`

  Evaluates to True if expr1 equals expr2. Conversion to floats will be attempted first. For strings comparision using ASCII positions are done. Eg. track EQUAL replay_gain, artist EQUAL “some words”.

`field HAS expr`

  Evaluates to True if expr is contained in field for each file. Eg. artist HAS Jon, %title% HAS “Remixed By”.

`field IS expr`

  Evaluates to True if field=expr for each file. Eg. artist IS “Bongo Maffin”, title IS Monster.

`expr1 AND expr2`

  Evaluates to True if both expr1 and expr2 evaluate to True for each file. Eg. artist IS “Bongo Maffin” AND title IS Monster.

`expr1 OR expr2`

  Evaluates to True if either expr1 and expr2 evaluate to True for the file. Eg. artist IS “Bongo Maffin” OR title IS Monster.

`NOT expr`

  Evaluates to True if expr is False. Eg. NOT artist IS “Bongo Maffin” OR title IS Monster.