summaryrefslogtreecommitdiff
path: root/help/C/search.page
blob: 4926ec0c196886b5c65a7692acab5f057c4d12b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      type="topic" style="task"
      id="search">

  <info>
    <link type="guide" xref="index#manage"/>
    <link type="seealso" xref="sort"/>
    <desc>Search your media and perfom basic queries.</desc>
    <revision pkgversion="1.6" version="0.1" date="2009-01-22" status="draft"/>
    <credit type="author">
      <name>Paul Cutler</name>
      <email>pcutler@gnome.org</email>
    </credit>
    <credit type="editor">
      <name>Aruna sankaranarayanan</name>
      <email>aruna.evam@gmail.com</email>
    </credit>
<!--
    <copyright>
      <year>2010</year>
      <name>GNOME Documentation Project</name>
    </copyright>
-->
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Searching your <app>Banshee</app> Library</title>

  <p><app>Banshee</app> features a powerful search language. You can search
  your library quickly and easily with basic search terms or perform detailed
  searches with the <app>Banshee</app> advanced search terminology.</p>

  <p>To perform a search of your media in <app>Banshee</app>, press the
  <key>S</key> or click the <gui>Search</gui> box in the upper right hand
  corner of the Library view in <app>Banshee</app>.</p>

  <p>A search query consists of some basic terms, for example,
  <em>dave matthews</em>. By entering <em>dave matthews</em> in the search
  box, <app>Banshee</app> will search all metadata fields including
  Track Title, Album Title, Album Artist, Year, etc. Any track whose metadata
  includes <em>dave</em> and <em>matthews</em> will be returned. Search terms
  are case insensitive, meaning you do not have to capitalize. <em>dave</em>,
  <em>Dave</em>, and <em>DAVE</em> all mean the same thing when searching.</p>

  <section id="operators">
    <title>Basic Operators</title>

  <p>Operators can be placed between any two search words or placed before a
  search word. The default operation is <gui>AND</gui> and is used when
  no other operators are used between two search terms. Since it is the
  default, there is no explicit AND operator.</p>

  <p>Other basic operators include <gui>OR</gui> and <gui>NOT</gui>. Together,
  these three operations can yield very powerful queries to help you search
  your media.</p>

  </section>

  <section id="logical">
    <title>Logical Operators and Examples</title>

  <p>The following is a list of logical operators and examples of the search
  results when searching using them.</p>

  <table frame="all" rules="rows" shade="rows">
  <tr>
    <td><p><gui>Operator</gui></p></td>
    <td><p><gui>Description</gui></p></td>
  </tr>
  <tr>
    <td><p><em>default</em>, <em>white space</em></p></td>
    <td><p>Search for two terms with a space between the two
    words or terms.</p></td>
  </tr>
  <tr>
    <td><p>OR, or, <key>|</key>, <key>,</key></p></td>
    <td><p>Search results will be two songs with either result in any
    field.</p></td>
  </tr>
  <tr>
    <td><p>NOT, not,<key>-</key></p></td>
    <td><p>Do not display search results with any search term that follows
    the operator of NOT, not,<key>-</key></p></td>
  </tr>
  </table>

  <p>Examples of logical operations include:</p>

  <table frame="all" rules="rows" shade="rows">
  <tr>
    <td><p><gui>Query</gui></p></td>
    <td><p><gui>Description</gui></p></td>
  </tr>
  <tr>
    <td><p>dave matthews</p></td>
    <td><p>Matches any fields in a track containing both <em>dave</em> and
    <em>matthews</em>.</p></td>
  </tr>
  <tr>
    <td><p>dave, matthews</p></td>
    <td><p>Matches any fields in a track containing either <em>dave</em> or
    <em>matthews</em>.</p></td>
  </tr>
  <tr>
    <td><p>dave or matthews</p></td>
    <td><p>Matches any fields in a track containing either <em>dave</em> or
    <em>matthews</em>.</p></td>
  </tr>
  <tr>
    <td><p>dave | matthews</p></td>
    <td><p>Matches any fields in a track containing either <em>dave</em> or
    <em>matthews</em>.</p></td>
  </tr>
  <tr>
    <td><p>-"dave matthews"</p></td>
    <td><p>Displays all tracks whose fields do not contain
    <em>dave matthews</em>.</p></td>
  </tr>

  </table>

  <p>For more information on performing more complex search queries, see the
  <link xref="adv-search"/> page.</p>

</section>

</page>