The front-end menu interface is intended to introduce new users and provide easy access to commonly used special functions.  Jukebox also fully supports natural search queries.  As your library grows, and as your users become more familiar with its content, search queries will become the most commonly used mechanism for accessing Jukebox.

A search query will return an itemized view of the query results.  For more information on Jukebox's menu interface, please refer to Using the Menu Interface.

Basic Search

A search query takes the following form:

!jb your search terms

The search query should simply be appended to Jukebox's !jb or !jukebox commands without any quotes or other special characters.

All applicable metadata types (genres, artists, albums and track titles) will be included in the scope of the search.

Advanced Search

In addition to the above, Jukebox also allows the user to define the scope of the search query to a specific metadata type, or even include multiple search queries specific to two or more metadata types.  An advanced query thus takes the following form:

!jb [general search] -command your search query [-command your search query] ...

Note: Optional components of an advanced search query are enclosed in square brackets.

In this form, queries for a specific metadata type are preceeded by a command which identifies the targeted type.  The command itself is identified using the hyphen character ( - ).  Quotations or other special characters are not required.

Advanced Search Commands

Query Formatting

Jukebox does not support Boolean searches or any other complex query structures.  Jukebox will ignore small words such as "in" and "to" and return results where all of the remaining words appear in the result in the same order but not necessarily together as a single phrase.

For example, searching for the phrase "great sea" will include results such as "the great sea" and "great white sea" but not "the sea is great".

When multiple queries are provided using the Advanced Search method, only results which satisfy all the queries will be returned.

Examples

It's party time!  I wonder what we have to listen to...

!jb party

Returns all genres, album, artists and track titles which include the word "party".

Dream of Californication...

!jb californication

Returns The Red Hod Chili Pepper's album "Californication" as well as the album's title track.

Hmm, I need to chill out.  Time to lighten the mood...

!jb -genre humor

Returns a list of any genres which include the word "humor".

I want to listen to "Live and Let Die", but not that awful cover version from Guns 'n Roses...

!jb -title live and let die -artist mccartney

Returns only Paul McCartney's original version of "Live and Let Die".