DocumentationLibrary search

Library search

With twenty songs in the library, scrolling is enough. With three hundred, you need a search that understands what you are looking for.

A typed word is matched against the title, artist, variant, tags and the song body itself.
Search is diacritic-insensitivenekdo finds "Někdo", praha finds "Prahá" and "Praha" alike. That matters, because song titles arrive in a library from different sources with different levels of care.

Operators

For a more precise search you can use prefixes:

OperatorSearchesExample
tag:Song tagstag:live
key:Keykey:Am
chord:Chords used in the songchord:F#m
variant:Variant namevariant:acoustic
bpm:Tempobpm:120

Text without a prefix is searched normally, so operators mix freely with ordinary words.

Searching by chord

chord: is the most interesting operator — it walks the actual chords in the song body, not just the key.
text
chord:F#m

Finds every song where F#m appears anywhere. Practical uses:

  • Find everything in the repertoire with a barre chord a new guitarist is still learning
  • Locate songs with a particular turnaround
  • Check whether a typo slipped into a chord somewhere

BPM ranges

bpm: does more than exact matching:
SyntaxMeaning
bpm:120Exactly 120
bpm:100-140In the 100 to 140 range
bpm:>120Faster than 120
bpm:<90Slower than 90
bpm:>=100100 and above
bpm:<=9090 and below
Handy when building a setlist — slow material at the start, fast at the end, and bpm:100-140 shows you what fits in between.

Combining

Operators stack:

text
tag:live key:G bpm:>110

Songs tagged live, in G, faster than 110.

text
chord:Bm variant:acoustic

Acoustic variants that use Bm.

text
love tag:ballad

Songs tagged ballad that contain the word "love" somewhere.

Conditions add up — a song has to satisfy all of them. There is no "or".

Filters and sorting

Next to the search box the library also has tap-to-use filters, for when you would rather not type:

  • By tag
  • By key
  • By BPM

Plus sorting to order the result. Filters and search work together — narrow the library with a filter first, then search within it.

Duplicate songs

When the same song lands in your library twice — say from an import and from the band — the app notices. It does not look for an exact match but for similarity of title, artist and content, so it catches "Hallelujah" against "Halleluja" too.
You find duplicates in the Library and can merge them. On import the app warns you before the song is even added.