Amarok/Manual/Organization/Collection/SearchInCollection: Difference between revisions

From KDE Wiki Sandbox
(Marked this version for translation)
 
(33 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Category:Amarok]]
<languages />
{{Construction}}
<translate>
{{Todo|need 2.4 edit filter images-5 needed}}


== Search Collection Overview ==
==== Search in Collection ==== <!--T:1-->


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 ''Media Sources'' pane or by clicking on the <menuchoice>Edit Filter</menuchoice>-button right next to the edit box.<br /><br />
<!--T:2-->
[[File:searchincollection.png|center|250px]]
''Search Collection'' lets you specify complex filters to search for specific tracks in your collection. Use the edit box in the ''Media Sources'' pane or click the {{Icon|document-properties}} button right next to the edit box. Alternatively you can simply press <keycap>Ctrl + F</keycap> to activate the search bar.


== 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.<br /><br />
<!--T:31-->
To search in a specific tag, type '''''tag:value''''' into the search bar. Operators like <keycap><</keycap> and <keycap>></keycap> can be used to create more general conditions. Several conditions can be used together by separating them by a <keycap>space</keycap> between them. For time conditions, use the following abbreviations: d=day, w=week, m=month, y=year.
[[File:Amarok_2.8_CollectionBrowserSearchField.png|center|300px]]


=== Tags ===
===== Edit Box ===== <!--T:4-->


The following tags can be searched:
<!--T:5-->
* <menuchoice>Album</menuchoice>
When you type in the input field, '''Amarok''' will search for the text in all available tags such as artist, album and title. Your view of the collection will update automatically to display only the matches of the search.
* <menuchoice>Artist</menuchoice>
* <menuchoice>Bitrate</menuchoice>
* <menuchoice>Composer</menuchoice>
* <menuchoice>AlbumArtist</menuchoice>
* <menuchoice>Genre</menuchoice>
* <menuchoice>Playcount</menuchoice>
* <menuchoice>Rating</menuchoice>
* <menuchoice>Sample Rate</menuchoice>
* <menuchoice>Score</menuchoice>
* <menuchoice>Title</menuchoice>
* <menuchoice>Track</menuchoice>
* <menuchoice>Year</menuchoice>
* <menuchoice>BPM</menuchoice>


=== Additional searchable fields ===
<!--T:30-->
Pressing <keycap>Enter</keycap> after searching will populate your playlist with all of the found search items and clear the search box. This is a great way to quickly add hundreds or thousands of tracks to a playlist instantly!


Along with tags, the following can also be searched:
<!--T:6-->
* <menuchoice>Comment</menuchoice>
To search in a specific tag, type <code>tag:value</code> 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 character. For time conditions, use the following abbreviations: d=day, w=week, m=month, y=year.
* <menuchoice>Filename</menuchoice>
* <menuchoice>Disc number</menuchoice>
* <menuchoice>Length</menuchoice>
* <menuchoice>Filesize</menuchoice>
* <menuchoice>Format</menuchoice>
* <menuchoice>Added (to Collection)</menuchoice>
* <menuchoice>First played</menuchoice>
* <menuchoice>Label</menuchoice>
* <menuchoice>Last modified</menuchoice>


=== Operators ===
===== Tags ===== <!--T:7-->


Numerical tags can use the following operators to create a condition:
<!--T:8-->
* Equal: <keycap>:</keycap>
The following tags can be searched:
* Less than: <keycap><</keycap>
* Album
* Larger than: <keycap>></keycap>
* Artist
* Bitrate
* Composer
* AlbumArtist
* Genre
* Playcount
* Rating
* Sample Rate
* Score
* Title
* Track
* Year
* BPM


=== Examples ===
===== Additional searchable fields ===== <!--T:9-->


Without specifying a tag, '''Amarok''' will search in all important text tags:<br /><br />
<!--T:10-->
[[File:searchincollection_example_editbox.png|center|300px]]<br /><br />
Along with tags, the following can also be searched:
More complex patterns can be used to get better results:<br /><br />
* Comment
[[File:searchincollection_example_editbox2.png|center|300px]]
* Filename
* Disc number
* Length
* Filesize
* Format
* Added (to Collection)
* First played
* Label
* Last modified


== Edit Filter Dialog ==
===== Operators ===== <!--T:11-->


'''Note: The UI of this dialog has changed in version 2.4. The functionality is the same.'''
<!--T:12-->
Numerical tags can use the following operators to create a condition:
* Equal: ":"
* Less than: "<"
* Larger than: ">"


A more complex interface to specify search patterns is provided by the ''Edit Filter'' dialog.<br />
===== Examples ===== <!--T:13-->
The <menuchoice>Append</menuchoice> button adds the current condition to the existing one with the specified connection in the ''Appending Condition''.<br />
By clicking on <menuchoice>Undo</menuchoice> the last action will be removed.<br />
<menuchoice>Clear</menuchoice> deletes the complete search pattern.<br /><br />
[[File:searchincollection_simple.png|center|300px]]


{{todo| 2.4 edit filter dialog image needed here}}
<!--T:14-->
If you search without specifying a tag, '''Amarok''' will search in all important text tags:


=== Appending Condition ===
<!--T:15-->
[[File:searchincollection_example_editbox.png|center|300px]]


Several conditions can be connected to form a complex search expression.
<!--T:16-->
More complex patterns can be used to get better results:


{|
<!--T:17-->
|-
[[File:searchincollection_example_editbox2.png|center|300px]]
! 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 <menuchoice>Simple Search</menuchoice> edit box.
|-
| Match Any Word
| Tracks must contain at least one of the words that are in the <menuchoice>Simple Search</menuchoice> edit box.
|-
| Exact Match
| Tracks must contain exactly the same 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 ===
==== Edit Filter Dialog ==== <!--T:18-->


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 <menuchoice>Equal To</menuchoice>, <menuchoice>Smaller Than</menuchoice>, <menuchoice>Larger Than</menuchoice> and <menuchoice>Between</menuchoice> options.
<!--T:19-->
If you prefer to build your searches more programatically, drag down the icons for the search terms you want, and drag to change search-term order. You may search by: <menuchoice>Simple text</menuchoice>, <menuchoice>Title</menuchoice>, </translate>
<translate><!--T:20-->
<menuchoice>Artist name</menuchoice>, <menuchoice>Album Artist Name</menuchoice>, <menuchoice>Album Name</menuchoice>, <menuchoice>Genre</menuchoice>, <menuchoice>Composer</menuchoice>, <menuchoice>Comment</menuchoice>, <menuchoice>Filename</menuchoice>,</translate>
<translate><!--T:21-->
<menuchoice>Year</menuchoice>, <menuchoice>Track Number</menuchoice>, <menuchoice>Disc Number</menuchoice>, <menuchoice>BPM</menuchoice>, </translate>
<translate><!--T:22-->
<menuchoice>Length</menuchoice>, <menuchoice>Bit Rate</menuchoice>, <menuchoice>Sample Rate</menuchoice>, <menuchoice>File Size</menuchoice>,</translate>
<translate><!--T:23-->
<menuchoice>Format</menuchoice>, <menuchoice>Added to Collection</menuchoice>, <menuchoice>Score</menuchoice>, <menuchoice>Rating</menuchoice>,</translate>
<translate><!--T:24-->
<menuchoice>First Played</menuchoice>, <menuchoice>Playcount</menuchoice>, <menuchoice>Label</menuchoice>, <menuchoice>Last Modified</menuchoice>. </translate>
<translate><!--T:25-->
You can also add <menuchoice>OR</menuchoice> and <menuchoice>AND</menuchoice> here.


=== Example ===
<!--T:26-->
Select a term and check <menuchoice>Invert condition</menuchoice> to exclude items matching this term from the results. Choose <menuchoice>AND</menuchoice> or <menuchoice>OR</menuchoice> for all terms in this search. If you choose <menuchoice>AND</menuchoice>, all search-terms must be present. </translate>
<translate><!--T:27-->
If <menuchoice>OR</menuchoice>, any matches will show up.<br /><br />
Of course, clicking {{Icon|edit-clear-locationbar-rtl}} removes your selections.
[[File:Amarok2.4.1EditFilterDialog.png|center|300px]]


In this example we are trying to find the following track:<br />
Title: Story Of My Life <br />
Artist: Social Distortion <br />
Album: Greatest Hits <br />
We'll search for the track with that conditions in that order. Here again the result when the edit box is used: <br /><br />
[[File:searchincollection_example_editbox.png|center|300px]]<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|center|300px]]<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|center|300px]]<br />
[[File:searchincollection_example_editfilters3.png|center|300px]]
{{todo|more 2.4 edit filter images needed above}}


<!--T:28-->
{{Prevnext2
{{Prevnext2
| prevpage=Amarok/Manual/AdvancedFeatures/QueueManager | nextpage=Amarok/Manual/AdvancedFeatures/TagEditor
| prevpage=Special:myLanguage/Amarok/Manual/Organization/CollectionScanning | nextpage=Special:myLanguage/Amarok/Manual/Organization/Collection/OrganizeCollection
| prevtext=Queue Manager | nexttext=Tag Editor
| prevtext=Collection Scanning | nexttext=Organize Collection
| index= Amarok/Manual | indextext=Back to Menu
| index= Special:myLanguage/Amarok/Manual | indextext=Back to Menu
}}
}}
<!--T:29-->
[[Category:Amarok2.8]]
[[Category:Multimedia]]
[[Category:Tutorials]]
</translate>

Latest revision as of 11:46, 25 July 2013

Search in Collection

Search Collection lets you specify complex filters to search for specific tracks in your collection. Use the edit box in the Media Sources pane or click the button right next to the edit box. Alternatively you can simply press Ctrl + F to activate the search bar.


Edit Box

When you type in the input field, Amarok will search for the text in all available tags such as artist, album and title. Your view of the collection will update automatically to display only the matches of the search.

Pressing Enter after searching will populate your playlist with all of the found search items and clear the search box. This is a great way to quickly add hundreds or thousands of tracks to a playlist instantly!

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 character. For time conditions, use the following abbreviations: d=day, w=week, m=month, y=year.

Tags

The following tags can be searched:

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

Along with tags, the following can also be searched:

  • Comment
  • Filename
  • Disc number
  • Length
  • Filesize
  • Format
  • Added (to Collection)
  • First played
  • Label
  • Last modified
Operators

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

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

If you search without specifying a tag, Amarok will search in all important text tags:

More complex patterns can be used to get better results:

Edit Filter Dialog

If you prefer to build your searches more programatically, drag down the icons for the search terms you want, and drag to change search-term order. You may search by: Simple text, Title, Artist name, Album Artist Name, Album Name, Genre, Composer, Comment, Filename, Year, Track Number, Disc Number, BPM, Length, Bit Rate, Sample Rate, File Size, Format, Added to Collection, Score, Rating, First Played, Playcount, Label, Last Modified. You can also add OR and AND here.

Select a term and check Invert condition to exclude items matching this term from the results. Choose AND or OR for all terms in this search. If you choose AND, all search-terms must be present. If OR, any matches will show up.

Of course, clicking removes your selections.