Library and import

Library is where you organize music and decide what reaches the decks. Selecting a track opens its inspector. Loading it into a deck is a separate action, and loading never starts playback.

Import music#

Choose Import audio…, use ⌘O, or drag files from Finder into Library. Grit accepts individual audio files, multiple files, audio folders with subfolders, and prepared Grit packages. Folder batches are limited to 128 tracks; divide larger collections into smaller folders.

Common import formats include WAV, MP3, FLAC, AIFF, Ogg, and M4A. Import success still depends on the file’s codec and integrity.

Grit creates a managed copy, analyzes the track, and adds it to your catalog. Keep an eye on the row’s state: queued, analyzing, saving, failed, and ready-to-open states describe different stages. You can return to Perform while accepted imports finish in the background.

Import the same folder again to pick up new files. Grit recognizes original paths and exact file copies, including renamed duplicates, and reports imported and skipped counts. Different encodings are separate files even if their titles match. Folders are not watched automatically.

Understand analysis and review#

Analysis estimates BPM, key, a beatgrid, and sections. Stem enhancement adds separated audio for performance. Needs review asks for a listening check; completing analysis does not mean you have approved the result.

Open Edit to inspect and correct a track. Follow Preparing tracks before marking it ready. From Library, Mark as ready saves that review acknowledgement immediately. Row checkboxes let you Mark N ready together; Undo ready reverses the latest batch when later edits have not superseded it.

Enhance pending (N) works across your entire library, regardless of the current search or playlist. It skips completed enhancements, active tracks, and missing sources. For an intentional fresh analysis of one track, use Reanalyze… from its menu. Existing preparation remains available while the new result is being prepared.

Find and audition a track#

Search with / or ⌘F. Search matches title, artist, and key. The review filter cycles through All, Needs review, and Ready.

Click Track / Artist, BPM, Key, or State to sort; repeated clicks choose descending order and then restore the collection’s original order. Sorting a playlist changes its display, not its saved sequence.

Select a row and click ▶, or press Shift+Enter, to preview. ↑/↓ selects tracks and Shift+←/→ selects a section. Preview uses the headphone route when configured. Without one, it can use Master only while the decks are stopped. Audio and headphones explains that fallback.

Choose a target deck with ←/→ or 1–8, then click Load → Deck or press Enter. An active target is protected: stop it first or choose another deck. Plain Space in Library controls the focused deck; use Shift+Enter for auditioning.

Build playlists#

Use + in the sidebar to create a playlist. A track’s ⋯ menu adds it to playlists or an open set. The same menu offers playlist ordering and removal actions.

Removing a playlist keeps the tracks and their audio in your library. Use Sets and scenes when you want to save deck arrangements and coordinated launches.

Keep your music safe#

The default library is ~/Music/Grit. Back up the complete folder to preserve audio, stems, edits, catalog, settings, and sets together. Playback uses Grit’s managed copy, so moving your original download folder does not normally break imported tracks.

If a row says Missing, use Relink and choose the matching source. Relink preserves the track identity, preparation, and set references; an incompatible replacement is refused. Rescan files & artwork retries availability and missing artwork after reconnecting a drive.

Missing covers may be looked up automatically through MusicBrainz and the Cover Art Archive using artist and title text. Audio and local paths are not sent. Downloaded covers remain available offline.

⋯ → Delete from library… permanently removes the Grit-managed copy, stems, analysis, and library entries. External originals remain intact. Stop previews, release loaded tracks, and remove saved-set references before deletion. If you only want to clear a deck, use its Eject track action instead.