Difference between revisions of "Amarok/Manual/Organization/Collection/SearchInCollection"

Jump to: navigation, search
m (nav)
(formatting)
Line 1: Line 1:
 
[[Category:Amarok]]
 
[[Category:Amarok]]
 
{{Construction}}
 
{{Construction}}
{{TODO change Appending Conditions to a table, other tables too. Much too long as is. wiki markup...}}
+
{{Todo|change Appending Conditions to a table, other tables too. Much too long as is. wiki markup...}}
  
 
The ''Search Collection'' feature makes it possible to specify complex filters to search for specific tracks in your collection. This can be done by using the edit box in the left pane or by clicking on the <menuchoice>Edit Filter</menuchoice>-button right next to the edit box.<br /><br />
 
The ''Search Collection'' feature makes it possible to specify complex filters to search for specific tracks in your collection. This can be done by using the edit box in the left pane or by clicking on the <menuchoice>Edit Filter</menuchoice>-button right next to the edit box.<br /><br />
Line 13: Line 13:
 
=== Tags ===
 
=== Tags ===
  
Following tags can be searched:
+
The following tags can be searched:
 
* <menuchoice>Album</menuchoice>
 
* <menuchoice>Album</menuchoice>
 
* <menuchoice>Artist</menuchoice>
 
* <menuchoice>Artist</menuchoice>
Line 33: Line 33:
 
Numerical tags can use the following operators to create a condition:
 
Numerical tags can use the following operators to create a condition:
 
* Equal: <keycap>:</keycap>
 
* Equal: <keycap>:</keycap>
* Less: <keycap><</keycap>
+
* Less than: <keycap><</keycap>
* Larger Than: <keycap>></keycap>
+
* Larger than: <keycap>></keycap>
  
 
=== Examples ===
 
=== Examples ===
  
Without specifying a tag, Amarok will search in all tags:<br /><br />
+
Without specifying a tag, '''Amarok''' will search in all tags:<br /><br />
 
[[File:searchincollection_example_editbox.png]]<br /><br />
 
[[File:searchincollection_example_editbox.png]]<br /><br />
 
More complex patterns can be used to get better results:<br /><br />
 
More complex patterns can be used to get better results:<br /><br />
Line 55: Line 55:
 
Several conditions can be connected to form a complex search expression.
 
Several conditions can be connected to form a complex search expression.
  
===== AND =====
+
{|
 
+
|-
Choose this if you want the get tracks that apply to the new as well as to the previous condition.
+
! Condition
 
+
! Meaning
===== OR =====
+
|-
 
+
| AND
Choose this if you want the get tracks that apply to the new or to the previous condition.
+
| Choose this if you want the get tracks that apply to the new as well as to the previous condition.
 
+
|-
===== Invert Condition =====
+
| OR
 
+
| Choose this if you want the get tracks that apply to the new or to the previous condition.
Negates the defined filter condition.
+
|-
 
+
| Invert Condition
===== Simple =====
+
| Negates the defined filter condition.
 
+
|-
The simple search mode acts like the edit box and searches through all tags.
+
| Simple
 +
| The simple search mode acts like the edit box and searches through all tags.
 +
|}
  
 
=== Filter Action ===
 
=== Filter Action ===
Line 75: Line 77:
 
Furthermore, the matching of simple conditions can be configured.
 
Furthermore, the matching of simple conditions can be configured.
  
===== Match All Words =====
+
{|
 
+
|-
Tracks must contain all words that are in the <menuchoice>Simple Search</menuchoice> edit box.
+
! Filter Action
 
+
! Meaning
===== Match Any Word =====
+
|-
 
+
| Match All Words
Tracks must contain at least one of the words that are in the <menuchoice>Simple Search</menuchoice> edit box.
+
| Tracks must contain all words that are in the <menuchoice>Simple Search</menuchoice> edit box.
 
+
|-
===== Exact Match =====
+
| Match Any Word
 
+
| Tracks must contain at least one of the words that are in the <menuchoice>Simple Search</menuchoice> edit box.
Tracks must contain exactly the same words that are in the <menuchoice>Simple Search</menuchoice> edit box.
+
|-
 
+
| Exact Match
===== Exclude =====
+
| Tracks must contain exactly the same words that are in the <menuchoice>Simple Search</menuchoice> edit box.
 
+
|-
Tracks must not contain any of the words that are in the <menuchoice>Simple Search</menuchoice> edit box.
+
| Exclude
 +
| Tracks must not contain any of the words that are in the <menuchoice>Simple Search</menuchoice> edit box.
 +
|}
  
 
=== Advanced ===
 
=== Advanced ===
Line 105: Line 109:
 
Now click on the <menuchoice>Edit Filters</menuchoice>-button next to the edit box. Choose <menuchoice>Title</menuchoice> in the combobox and click the <menuchoice>Append</menuchoice>-button.<br /><br />
 
Now click on the <menuchoice>Edit Filters</menuchoice>-button next to the edit box. Choose <menuchoice>Title</menuchoice> in the combobox and click the <menuchoice>Append</menuchoice>-button.<br /><br />
 
[[File:searchincollection_example_editfilters1.png|600px]]<br /><br />
 
[[File:searchincollection_example_editfilters1.png|600px]]<br /><br />
Amarok already updates the view in the background. But to get a non-ambiguous result we need the other filters. Adding the filters for artist and album work the same way. Use <menuchoice>AND</menuchoice> to connect the conditions, because the track needs to fulfill all requirements.<br /><br />
+
'''Amarok''' already updates the view in the background. But to get a non-ambiguous result we need the other filters. Adding the filters for artist and album work the same way. Use <menuchoice>AND</menuchoice> to connect the conditions, because the track needs to fulfill all requirements.<br /><br />
 
[[File:searchincollection_example_editfilters2.png|600px]]<br />
 
[[File:searchincollection_example_editfilters2.png|600px]]<br />
 
[[File:searchincollection_example_editfilters3.png|600px]]
 
[[File:searchincollection_example_editfilters3.png|600px]]

Revision as of 02:21, 4 January 2011

Under construction.png
Under Construction
This is a new page, currently under construction!
noframe
TODO
change Appending Conditions to a table, other tables too. Much too long as is. wiki markup...


The Search Collection feature makes it possible to specify complex filters to search for specific tracks in your collection. This can be done by using the edit box in the left pane or by clicking on the Edit Filter-button right next to the edit box.

Searchincollection.png

Edit Box

When you type in the input field, Amarok will search for the expression in all available tags such as artist, album and title. The view of the collection will update automatically to display only the matches of the search.
To search in a specific tag, type tag:value into the search bar. Operators like < and > can be used to create more general conditions. Several conditions can be used together by separating them by a space between them.

Tags

The following tags can be searched:

  • Album
  • Artist
  • Bitrate
  • Composer
  • AlbumArtist
  • Genre
  • Playcount
  • Rating
  • Sample Rate
  • Score
  • Title
  • Track
  • Year
  • BPM

Operators

Numerical tags can use the following operators to create a condition:

  • Equal: :
  • Less than: <
  • Larger than: >

Examples

Without specifying a tag, Amarok will search in all tags:

Searchincollection example editbox.png

More complex patterns can be used to get better results:

Searchincollection example editbox2.png

Edit Filter Dialog

A more complex interface to specify search patterns is provided by the Edit Filter dialog.
The Append button adds the current condition to the existing one with the specified connection in the Appending Condition.
By clicking on Undo the last action will be removed.
Clear deletes the complete search pattern.

Searchincollection simple.png

Appending Condition

Several conditions can be connected to form a complex search expression.

Condition Meaning
AND Choose this if you want the get tracks that apply to the new as well as to the previous condition.
OR Choose this if you want the get tracks that apply to the new or to the previous condition.
Invert Condition Negates the defined filter condition.
Simple The simple search mode acts like the edit box and searches through all tags.

Filter Action

Furthermore, the matching of simple conditions can be configured.

Filter Action Meaning
Match All Words Tracks must contain all words that are in the Simple Search edit box.
Match Any Word Tracks must contain at least one of the words that are in the Simple Search edit box.
Exact Match Tracks must contain exactly the same words that are in the Simple Search edit box.
Exclude Tracks must not contain any of the words that are in the Simple Search edit box.

Advanced

To search for in a specific tag it needs to be selected in the combobox. Numerical values can further form a more complex condition with the Equal To, Smaller Than, Larger Than and Between options.

Example

In this example we are trying to find the following track:
Title: Story Of My Life
Artist: Social Distortion
Album: Greatest Hits
We'll search for the track with that conditions in that order. Here again the result when the edit box is used:

Searchincollection example editbox.png

Now click on the Edit Filters-button next to the edit box. Choose Title in the combobox and click the Append-button.

Searchincollection example editfilters1.png

Amarok already updates the view in the background. But to get a non-ambiguous result we need the other filters. Adding the filters for artist and album work the same way. Use AND to connect the conditions, because the track needs to fulfill all requirements.

Searchincollection example editfilters2.png
Searchincollection example editfilters3.png


Content is available under Creative Commons License SA 4.0 unless otherwise noted.