Wishlist
The Wishlist lets you track releases you want to acquire. Items live separately from your collection and can be moved into it with a single tap when you get the album.
Accessing the Wishlist
Tap the heart icon in the toolbar to enter Wishlist mode. The sidebar switches from your collection to the Wishlist list and the heart icon becomes highlighted in pink. Tap it again, or tap the Discography logo, to return to your collection.
Wishlist List
The Wishlist sidebar works similarly to the Collection list.
Filtering and Sorting
A control strip above the list lets you:
- Filter by format — show only a specific media format or show all.
- Sort — by Artist, Album title, or Year.
- Sort direction — toggle ascending/descending order.
A total count banner shows how many items match the current filter and search.
List Actions
- Tap / click an item to open its detail view.
- Swipe left
iOSon a row to reveal a Delete button. - Right-click / long-press a row for a context menu with:
| Action | Description |
|---|---|
| Add to Collection | Moves the item into your collection and removes it from the Wishlist |
| Duplicate | Creates a copy of the item in the Wishlist |
| Delete | Removes the item from the Wishlist |
Toolbar Buttons
| Button | Action |
|---|---|
| Discography logo | Return to the collection Home screen |
| MusicBrainz icon | Switch to MusicBrainz search mode |
| Heart (highlighted) | Exit Wishlist mode |
| Trash | Delete the currently selected item |
| + | Add a new blank Wishlist item |
Wishlist Item Detail
Read-Only View
Tapping a Wishlist item opens its detail view. The layout mirrors the Album Detail view:
- A hero banner with blurred cover art, gradient, and a thumbnail on the right.
- Title and artist overlaid on the banner.
- Format / Release Type displayed below the banner.
- A pink Wishlist badge.
- Release metadata: year, country, label, UPC, and catalog number.
- Added date — shown centered below the divider, indicating when the item was added to your Wishlist.
- Notes — free-text notes (if set).
Toolbar Buttons (read-only mode)
| Button | Action |
|---|---|
| MusicBrainz icon | Opens MusicBrainz metadata options (Match Album / Fix Match) |
| Pencil / Edit | Switches to edit mode |
| Add to Collection | Moves the item into your collection and removes it from the Wishlist |
After tapping Add to Collection, the button changes to Added to Collection (green checkmark) and becomes disabled.
MusicBrainz Match
Tap the MusicBrainz icon in the toolbar while viewing a wishlist item to enrich its metadata from MusicBrainz. Two options are available:
| Option | Description |
|---|---|
| Match Album | Automatically searches MusicBrainz using the item's existing title, artist, year, country, UPC, or catalog number and applies the best match. Only empty fields are filled; existing values are not overwritten. |
| Fix Match | Opens a full release list so you can manually choose the correct pressing. Applying a release from this view overwrites all fields with the selected release's data. |
After a successful match, a note is appended to the item's Notes field recording what was updated and when.
Note: MusicBrainz match for wishlist items updates all applicable fields (title, artist, year, country, format, release type, label, catalog number, barcode, MusicBrainz ID, and cover art). Tracklists and credits are not applicable to wishlist items and are available after moving the item into your collection.
Edit Mode
Tap Edit (pencil icon) to enter edit mode. Tap Save (checkmark) to commit, or Cancel (×) to discard.
Fields available in edit mode
| Field | Notes |
|---|---|
| Album Title | Required |
| Artist | Required |
| Year | Original release year |
| Country | Two-letter country code or full name |
| Format | Vinyl, CD, Cassette, DVD, Blu-Ray, 8-Track, Other |
| Release Type | Album, EP, Single, Compilation |
| Label | Record label |
| UPC / Barcode | Numeric barcode |
| Catalog Number | Label catalog number |
| MusicBrainz ID | UUID for the release on musicbrainz.org |
| Cover Art URL | Direct URL to cover art image |
| Notes | Free-text personal notes |
Cover art can be set by:
- Clicking the camera button on the artwork thumbnail to pick an image from your Photos library
iOSor file systemmacOS. - Dragging an image file onto the artwork thumbnail
macOS. - Right-clicking / long-pressing the thumbnail and choosing Remove Artwork to clear it.
Note: Wishlist items do not support tracklists, credits, or tags. These fields are available when the item is moved into your collection.
Adding Items to the Wishlist
There are two ways to add an item to your Wishlist:
-
Manually — while in Wishlist mode, tap the + button in the toolbar. A blank edit form opens. Fill in at least the Title and Artist, then tap Save.
-
From MusicBrainz — search MusicBrainz, open a release detail view, then tap the heart (Add to Wishlist) button in the toolbar. The item is added with full metadata and cover art. See MusicBrainz Integration.
You can also right-click / long-press any MusicBrainz search result row and choose Add to Wishlist without opening the detail view.
Moving a Wishlist Item to Your Collection
When you acquire an album on your Wishlist, move it to your collection in one of two ways:
- Open the item's detail view and tap Add to Collection in the toolbar.
- Right-click / long-press the item's row in the Wishlist list and choose Add to Collection.
The item is copied into your collection with all its metadata and cover art, then removed from the Wishlist. You can continue editing the resulting album entry to add tracks, credits, and tags.
Wishlist on the Home Screen
If your Wishlist contains any items, a Wishlist coverflow section appears on the Home screen between the Recently Added and Spotlight sections. Tap any card to open that item's detail view. The number of items shown is configurable in Settings under Wishlist Settings.
Import and Export (macOS)
The Wishlist can be exported to a CSV file and imported from one. This lets you back up your wishlist, transfer it between machines, or edit it in a spreadsheet application.
Exporting
- Go to File > Export Wishlist CSV…
- Click Choose… to select the destination folder (defaults to
~/Documents/Discography/). - Click Export.
A progress log updates in real time. The resulting file is named Wishlist-<timestamp>.csv and saved to the chosen folder. When the export finishes, you can click Show in Finder to reveal it immediately.
Importing
- Go to File > Import Wishlist CSV…
- Click Choose to select a Wishlist CSV file (
.csv). - Select an import mode:
- Replace Wishlist — deletes all existing wishlist items and replaces them with the imported data.
- Append to Wishlist — adds the imported items alongside your existing wishlist items.
- Click Import.
A progress log updates in real time. You can cancel an in-progress import at any time.
Note: Cover art is not stored in CSV files. After importing, use the MusicBrainz Match Album button on each item to re-fetch artwork, or add it manually in edit mode.
For full details on the CSV file format, see Wishlist CSV Format.