Importing Collections

This guide walks through building a collection from a URL using the command palette. The flow is the same for both supported sources: preview first, then build, then let it finish in the background.

Internet Archive

Find the collection on archive.org – a details page or a search URL both work.
Copy the URL.
In the catalog app, click the search bar to open the command palette and paste the URL.
deadca7 previews the import: collection name, album and track counts, cover art, and a provider badge.
Click Import.

The Internet Archive importer respects file-format ranking, so you get the best available files.

YouTube

Copy a YouTube playlist, channel, or single video URL.
Paste it into the command palette.
Review the preview – name, album and track counts, cover art.
Click Import.

Preview, Then Build

Pasting a URL never imports anything on its own. You always get a preview first and decide whether to build the collection. Nothing is added until you click Import.

Background Progress

Once you start an import:

It runs in the background – keep browsing and playing.
Live progress shows in the footer.
New albums appear as they finish.
Imports are crash-safe and resumable, per-album atomic, and duplicate-free on retry.

Prefer the Command Line?

Every import is also a CLI command:

deadca7 imports create <url>   # returns an import id
deadca7 imports get <id>       # poll progress

See Using the CLI for the full set, and Importing Music for the feature overview.