# Library overview

What each of the four library tabs shows, and how to group, filter, and search your scores.

> Type: Overview · Status: Beta · Platforms: iPadOS 17+ · Last reviewed: 2026-07-18

## The four library tabs

The library opens on a row of four tabs. Each one changes which scores the list below shows — your grouping, filters, and search carry over unchanged when you switch.

| Tab | What it shows |
| --- | --- |
| `My Library` | Scores you imported or scanned. This is your private collection, and the default tab. |
| `Catalog` | The shared classical catalog — about 25,000 major works, ranked by importance. Browsing it does not add anything to your library. |
| `Calibrated` | Only the pieces that already have a calibration, so they are ready for score following. |
| `All` | Your library and the catalog together, in one alphabetical list. |

> **Note:** Calibrated pieces have their own tab instead of a filter chip — there is no "Calibrated" entry in the filter row.

## Group the list

On a fresh install the list is grouped by **Period**, with **Composer** and then **Form** nested inside each era. That arrangement is the built-in `Period · Composer · Form` view (see [Saved views](#saved-views)); you can change any part of it.

The `Group by` row sets the top-level grouping. Tap one of:

- **Composer** — one section per composer.
- **Recent** — most recently opened first.
- **Period** — sections by era (Baroque, Romantic, Impressionist, …).
- **Form** — sections by form (sonata, nocturne, fugue, …).
- **Instrument** — sections by instrumentation.
- **A → Z** — one flat alphabetical list, no sections.

### Nest a second level

To divide each top-level section further (for example Period, then Composer inside each era):

1. In the `Group by` row, tap `Add group`.
2. Pick an axis: Period, Composer, Form, Instrument, Tonality, Year, A → Z, Catalog, Favorite, or Duration.

The new level appears as a chip after the top-level grouping. Tap the chip to adjust it:

- `Group by` — swap this level to a different axis.
- `Show as` — how the sub-sections render: `New panel`, `Sub-column`, `Open section` (always expanded), or `Drop-down` with a `Collapsed` or `Expanded` default.
- `Remove` — delete this level.

You can chain several levels; the whole arrangement persists between launches.

## Filter the list

Tap `FILTERS` to expand the filter chips (tap it again to collapse them). Chips appear in this order: Instrument, Period, Form, Difficulty, Importance, Tonality, `⭐ Starred`, `PDF only`, `XML only`. Each chip opens a small panel; active chips stay highlighted.

- **Instrument, Period, Form, Tonality** — pick any number of values. Tonality lists all 30 major and minor keys, plus any other key spellings already present in your own files.
- **Difficulty** — one band at a time: Beginner, Intermediate, Advanced, or Virtuoso. Picking a second band replaces the first; tapping the active band clears it.
- **Importance** — an editorial 0–100 score of how central a work is (50 Notable · 75 Major · 90 Canon). Separate sliders filter by piece importance and by composer importance.
- **`⭐ Starred`** — only pieces you starred.
- **`PDF only` / `XML only`** — only pieces whose file is a PDF, or only pieces with playable MusicXML.

Tap the ✕ at the end of the row (`Clear filters`) to drop every active filter at once.

> **Limit:** `PDF only` is available only on the `My Library` tab.

## Search

The `Search…` field matches every word you type, and it understands structured terms, so you can mix them freely:

- **Composer** — tolerates typos and accents (`chopin`, `debusy`).
- **Year** — a 4-digit year matches works composed around it; if nothing matches the exact year, the search widens to the era (`1722` surfaces Baroque works).
- **Era, form, key, instrument** — `baroque`, `nocturne`, `c minor`, `violin`.
- **Catalog number** — `BWV 846`, `Op. 27 No. 2`, `K. 331`.

For example, `chopin nocturne c minor` narrows to exactly that intersection.

## Saved views

A saved view is a snapshot of your grouping chain and every filter. Views live as chips on their own row above `Group by`; tap a chip to apply it. The app ships with one built-in view, `Period · Composer · Form`, which is also the fresh-install default — you can't rename or delete it, but your own views sit next to it on the same row.

To save the current arrangement:

1. Set up the grouping and filters you want. As soon as they differ from every saved view, a `💾 Save this view` chip appears at the end of the row.
2. Tap it. The view is saved immediately, named after its grouping chain.
3. To pick your own name, long-press the new chip and choose `Rename`.

Long-pressing one of your view chips also offers `Update with current view` (overwrite it with the current arrangement) and delete.

When your current arrangement already matches a saved view, the end of the row shows a `+` chip instead: it clears everything to a blank template (flat A → Z list, no filters) so you can build a new view from scratch.

A saved view does **not** record which tab you were on or your search text, so one view works across tabs. Saved views sync to your other devices through iCloud.

## Where to go next

- [Organize](organize.md) — merge duplicates, link sets, combine movements, and let the cleanup assistant suggest fixes.
- [Collections](collections.md) — group pieces into named collections and setlists.
- [Metadata](metadata.md) — fix titles, composers, and how titles are formatted.
- [Sync](sync.md) — what syncs across devices through iCloud, and what stays on this device.
