Contents

Menu commands

• Showing the search dialog
• Searching for same artist (or other field)
• Showing the help file

Search dialog

• Builtin keyboard shortcuts
• Builtin filter modes
  • pass
  • info missing
  • boolean
  • match exact
  • match prefix
  • match all and match one

Preferences

FAQ

• "I don't get any results when searching the database!"
• "The help command does not work!"

Menu commands

Showing the search dialog

Choose Components/Database search from the main menu to show the search dialog.

Searching for same artist (or other field)

To search the database for songs with the same artist as a given song, select that song (either in playlist, albumlist, or any other place that allows the use of standard foobar2000 context menu commands) and choose Database search/Search for same artist from the context menu. This command only shows up, if you have a format preset called "artist" (chararcter case is ignored, so it may be called "Artist" as well).

There are similar commands for searching for same album, title, date, and venue. There is also the Database search/Search for same... command which lets you choose an arbitrary format preset.

Showing the help file

To show the help file, run the Components/Help/Database search command from the main menu. This command is disabled by default.

Search dialog

Builtin keyboard shortcuts

Keyboard shortcuts that are available in the search, format, pattern, and filter mode fields only:

• Enter: Refreshes the search results and adds the current pattern to the list of recently used patterns.

Keyboard shortcuts that are available in the resultlist only:

• Enter: Runs the configured default action on the selected results.
• Control+A: Select all results.
• a character: Jumps to the next result that starts with this character.

Keyboard shortcuts that are available in the whole dialog:

• Alt+S: Jumps to the search field.
• Alt+F: Jumps to the format field.
• Alt+P: Jumps to the pattern field.
• Alt+M: Jumps to the filter mode field.
• Alt+R: Jumps to the result list.
• Shift+Enter: Appends all the results to the current playlist.
• Control+Enter: Runs the Send to playlist... command on all the results.

The pass filter mode

This filter always returns true, so all items pass the test.

The info missing filter mode

This filter tests whether information about an item is available in the database. If no information is available, the item passes the test.

The boolean filter mode

This filter uses the format given in the pattern field and applies it to any item that is tested. If the resulting strings is non-empty, the item passes the test.

Example:

• Format used: [%title%]
• Result: Only songs that have a non-empty title tag. If you want all songs that have a title tag - even an empty one - use $if(%title%,1) as format. Likewise, $if(%title%,,1) will yield all songs that don't have a title tag at all.

The match exact filter mode

This filter applies the format given in the format field to any item that is tested. If the content of the pattern field is identical to the resulting string (ignoring character case), the item passes the test. If the pattern field is empty, no item passes the test.

Example:

• Format used: [%artist%]
• Pattern: dave matthews
• Result: Only songs from Dave Matthews, but not from Dave Matthews Band or Dave.

The match prefix filter mode

This filter applies the format given in the format field to any item that is tested. If the content of the pattern field is a prefix of the resulting string (ignoring character case), the item passes the test. If the pattern field is empty, no item passes the test.

Example:

• Format used: [%artist%]
• Pattern: dave matthews
• Result: Only songs from Dave Matthews and from Dave Matthews Band, but not from Tim Reynolds & Dave Matthews. And no songs from Dave either.
  (Yes, I know, it's normally Dave Matthews & Tim Reynolds, but this is an example. OK?)

The match all and match one filter modes

more to come...

Preferences

more to come...

FAQ

"I don't get any results when searching the database!"

Go to Preferences/Database and make sure that Database enabled is checked.

"The help command does not work!"

The HTML file has to be in the same directory as the plugin.

more to come...