How Katalog works, from the first launch to the tools. The same help is inside the app: the ? at the bottom right of the window opens the Guide panel (Modes, Shortcuts and Tools), and Help ▸ Setup Guide reopens the first-launch walkthrough. Every picture is from version 0.10.2. Last updated 26 October 2026.
Add your music.Drag files or folders onto the window, or choose File ▸ Add to Library….
Coming from Apple Music.The first-launch walkthrough has Import from Music. It only adds: it never overwrites a rating you already made in Katalog, and it changes nothing inside Music. Help ▸ Setup Guide opens the walkthrough again any time.
Your folders stay yours.Settings ▸ Locations lists the folders Katalog reads from. It never moves, copies or changes anything in them. A folder covers everything inside it, however deep. Switch one off and its tracks are hidden; switch it back on and they return.
The window.The first time, there is no mode: Player and Browse, nothing on the right. After that, Katalog opens the window the way you left it.
Hover to learn.Tooltips are on from the start. Hover any button, slider or column header and Katalog explains what it does. Switch them off in the Guide panel's Tools tab, or in Settings ▸ Toolbar, once you know your way around.
The window
Modes.Play, Prep, Studio and Desk. Each one sets the window up for a job.
Player, Browse, Crate.The player strip, the column browser and the crate. Each one on or off.
Info, Matches, History.What the panel on the right shows.
Search, Ask, FX.Find tracks by name, ask for them in plain words, or open the effects.
Sidebar.Your library and its sections, your folders and your playlists.
The ?Opens the Guide panel: the modes, every shortcut and the tools.
Modes
Each button along the top turns one part of the window on or off. Nothing belongs to a mode: Player, Browse, Crate, Info, Matches and History work in all of them.
A mode is a ready-made layout for one job. Click one and the window switches to it, replacing whatever you had open. Click the same mode again to turn it off. Then change anything you like, and Katalog keeps it. Tab cycles through the modes and ⌘1 to ⌘4 jump straight to one.
Play
Put it on and let DJ Flow pick the next track, in a matching key and tempo, changing on the beat.
Shows Play and History
Mood.Bright, Dark, Happy, Sad, Calm, Romantic, Tense, Epic or Dreamy. Worked out from the key and the tempo.
Intensity.Calm through to Intense. The steps come from your own library, so Medium really is your middle.
Genre.Narrow it to one genre.
Type.Vocals, instrumentals, originals, remixes or live.
BPM.Set the tempo by hand. Reset puts it back.
Unplayed.Only tracks you have never played.
DJ Flow.Each track picks a next one in a matching key and close tempo. It keeps going.
Random Album.Plays one album, start to finish.
Shuffle Play.Plays everything that matches, in random order.
Prep
Build a set. See what pairs with a record and preview it without moving the deck.
Shows Deck, Matches and the crate
Deck.Waveform, cue points, tap tempo and key. Turning Prep off takes it away.
Matches.Tracks in a matching key and close tempo. ▶ previews one, and a double-click loads it in the deck.
Crate.The set you are building, under the list. Sort it like the list; # is your own order.
Cues.⌘ with a number sets a cue. The number alone jumps to it. Or use + Cue and Loop In on the deck.
Clock.Shows milliseconds, so you can land a cue exactly.
Studio
Every version of one song side by side, and A/B between them without losing your place.
Shows Studio, the player and Info
Versions.Every cut of the same song. Click one to play it.
Info.Edit the tags, artwork, tempo and key.
Desk
Three steps to getting a record out the door. Desk works on one release at a time.
Shows Desk, the player and Info
Create Release.Select the tracks you are putting out, then Create. They go into a release of their own. Choose whether the masters stay as they are, so a WAV stays a WAV, or become FLAC 16-bit / 44.1; Katalog remembers the choice.
Complete the Metadata.Ready counts the tracks a distributor will take. Under it is one bar for each thing they ask for: artist, title, album, album artist, track number, release year, genre, a lossless master and artwork. Click a bar to see just those tracks. BPM and key are shown but never required.
Package for Upload.One folder: the masters, the cover and the metadata sheet a distributor asks you to fill in. Upload it to any of them. You can package with tracks still incomplete, but a distributor will bounce them. Masters are WAV, AIFF or FLAC, and artwork at least 3,000 px square.
Settings
Katalog ▸ Settings (⌘,) is where the customising lives. Each tab covers one thing.
The tabs.Thirteen, one per subject, all in one row. The list below goes through them left to right.
Import.Where added files go: copy them into one folder, or use Music's folder. What happens on import is split in two. Working out tempo and key, and finding the first and last beat, write only to Katalog's own database. Fetching Discogs metadata, filling in missing cover art, adding to Apple Music, watching your music folder, keeping the DJ library file up to date and converting on import all write to your files, so they sit in their own group.
Library.How musical keys are shown, Complete as you type for editing, and Library Sections. Sections are smart filters: nothing is moved or changed.
Locations.The folders Katalog reads from. Add a folder, rename it, set it as the import folder, count the files on disk, reveal it in Finder or remove it from Katalog. Also where new files are saved when you drag music in.
Appearance.List size (Small, Medium or Large), the theme (System follows your Mac's setting), and colour-coded mode buttons.
Toolbar.Which modes appear, tooltips on or off, a colour-coded toolbar, and whether buttons show icon and text, icon only or text only.
License.Enter your licence code.
Video.Keep video playback or the mini player on top, get a notification when the song changes, and play videos in a floating window.
AI.Your own Anthropic key, for Ask in the Search panel. Ask finds tracks from a question in plain words, and what it finds becomes a normal selection you can save as a crate or work on like any other list.
Playback.How far Mute drops the volume (instead of cutting it), how much play history to keep, from 50 to 5,000 tracks, and Clear Play History….
iPhone.Pair an iPhone… shows the code that pairs Katalog for iPhone with this Mac, and lists the iPhones already paired. See iPhone.
Menu Bar.Show Katalog in the menu bar, and choose what it reads out: title, artist, time, a countdown of the time left, and a length limit.
Discogs.Your own Discogs personal access token, for catalogue metadata.
Shortcuts.Set your own keys for every customisable action, inside Katalog or anywhere on your Mac. Restore Defaults puts them back.
Columns and Sorting
Choose your columns.Right-click any column header for a list of every column, A to Z. Tick the ones you want.
Arrange them.Drag a header to move a column, drag its edge to resize it. Katalog remembers the layout, and the crate follows the same one.
Sort.Click a header to sort by it. Shift-click another header to add a level. The header menu shows the current sort, and Sort by One Column Only takes you back to one.
Right-click any column header.
Shortcuts
These keys are always the same.
Space
Play or pause
⇧⌘Space
Play at half speed
0 – 9
Jump to a cue. With ⌘, set that cue
← → tap
Previous or next track
→ hold
Audible fast-forward at 5×
← hold
Scrub back at 5×
⌘← ⌘→
Jump 5 seconds
⌥← ⌥→
Nudge 10 ms
↑ ↓
Move the selection
⌘↑ ⌘↓
Jump 20 rows
Return
Edit the cell. Return again commits
Delete
Remove the selection (always asks first)
[ ]
Loop in, loop out
- =
Hold to bend the pitch down or up
Shift tap
Tap tempo, four taps minimum
Tab
Cycle through the modes
⌘1 – ⌘4
Jump straight to a mode
⌘B
Show or hide the column browser
⌥⌘M
Mini player
⇧⌘L
Lyrics window
⌘Z ⇧⌘Z
Undo, redo
⌘,
Settings
⌘Q
Quit
Everything else can be set to your own keys in Settings ▸ Shortcuts. The same list is in the app: click the ? at the bottom right and choose Shortcuts. Set My Own Shortcuts… at the end of it opens Settings.
The Guide panel, Shortcuts tab.
Tools
Three ways in, all to the same tools. A tool that works on the tracks you picked stays greyed out until you pick some.
The Tools menu.Every tool, in the menu bar.
The Guide panel.Click the ? at the bottom right, choose Tools, pick one and click Run….
Right-click.Right-click the tracks and choose Tools.
Show tooltips.On from the start. Switch it off here.
Tool.Pick one. What it does and how it works are written under it.
Run…Starts it.
Every tool:
Find & Recover Missing Files.Finds tracks whose file moved or was renamed, then relinks them or copies them back in. Scans your home folder and any mounted drives, matching by filename and then by exact byte size to catch renamed files.
Files Not In The Library.Audio sitting in your media folders that Katalog has never seen. Nothing is imported until you say so.
Find Empty Folders.Folders left behind with no audio in them. It only lists them; deleting is yours to do in Finder.
Convert & Replace.Re-encodes the selection and swaps the file in place. See Converting below.
Export List As Text.Writes whatever is in view to a tab-separated text file, in the order and columns you are looking at. A set list, a delivery sheet or a backup of a crate.
Find Fake Bitrates.Finds MP3s that say 320 but were made from a 128k source. It reads the spectrum of each file. Vinyl and cassette sources roll off naturally and are not flagged.
Re-scan File Info.Re-reads tags and file size from disk, for when you edited a file in another app.
Find Missing Artwork.Finds albums with no cover and fetches matching artwork. The artist has to match, so a near miss on the album alone will not attach the wrong cover.
Fetch Lyrics.Looks up the words from LRCLIB, a free open database, so you can search your library by what a song says. No account and no key. Matched on artist, title and length, with time-synced words where they exist, and written into the files so they travel to other apps.
Update DJ Library File.Writes the library file that Serato, rekordbox, Traktor and Engine read, so they see your Katalog library. It carries titles, artists, albums, genres, BPM and play counts. It has no field for key or cue points.
Find Duplicates.Groups tracks that are the same recording so you can keep the best copy. Opens the Duplicates view in the sidebar.
Analyze BPM & Key.Detects tempo, key and in and out points on your Mac. Runs on the selection, or everything in view when nothing is selected, and asks first if that is more than 30 tracks.
Detect & Fix Damage.For a track you can hear a fault in. It finds the click or dropout, repairs it and writes the result beside the original, ending in “(fix)”, so you can compare the two and keep the better one. Your file is never touched.
Snapshot Library.A restore point of the library database before you change anything big. The last ten are kept.
Loved and Disliked
Two flags, and neither one is a rating. A rating says how good a record is. Loved says you want it near you. Disliked says get it out of my way.
Favorite, Dislike.Right-click a track to flag it. Favorite puts it in Loved.
Convert & Replace, Tools.Run on the tracks you right-clicked.
Disliking a track removes it from every view and stops it coming up while something is playing: shuffle, auto-advance and DJ Flow all skip it. Nothing is deleted and no file is touched. Disliked tracks collect under Disliked in the sidebar, marked with a thumbs-down. Click the thumb, or right-click and choose Put Back in Library, and the track returns to where it was.
Converting
Converting up does not make a file sound better, only bigger. A 128k MP3 saved as a 24-bit WAV is still a 128k MP3. The good reason to do it is a site or service that demands a format when you no longer have the original.
Right-click the tracks and choose Convert & Replace, or find it in the Tools menu.
WAV, AIFF, FLAC, ALAC.Convert. A big master becomes a smaller file for everyday use.
.m4a.Depends on what is inside. Apple Lossless converts, AAC is refused. Katalog reads the codec rather than trusting the extension.
MP3, AAC.Refused. They are already lossy, and each pass loses more.
Protected purchases.Refused. They are encrypted, so download an unprotected copy first.
320 or V0.320 CBR is the biggest and works everywhere. V0 VBR averages about 245k, roughly a quarter smaller, and holds up the same in listening tests. V0 to save space, 320 to hand to someone else.
Undo.Your original goes to the Trash, so the space comes back when you empty it. To undo, find it in the Trash and use Put Back. Cue points, ratings, playlists and the date added stay with the track.
iPhone
Katalog for iPhone takes your library with you: browse it, play it, rate, tag and cue it, and build playlists. It syncs straight with the Mac on your own network. Nothing goes through a cloud, and there is no account. Every screen and setting is in the Guide for iPhone.
Pair it with your Mac
On the Mac.Katalog ▸ Settings ▸ iPhone, then Pair an iPhone…. It shows a six-digit code for two minutes.
On the iPhone.Open Katalog and tap Pair With Mac. Later, Pair With a Mac is at the top of Settings, behind the gear on the Home tab. Your Mac shows under Macs on This Network.
Type the code.Tap your Mac, type the six digits and tap Pair. The iPhone needs to be on the same Wi-Fi as the Mac, or plugged into it with a cable.
Choose what syncs
Once paired, the iPhone shows in the Mac's sidebar under Devices. Its page shows the iPhone's space, what fits and what is choosing it. The same choices are on the iPhone in Settings ▸ Choose What Syncs.
Entire Library.Every song and video the Mac holds, newest first, until the iPhone is full. The rest waits for space. On a new iPhone it starts off.
Chosen Playlists, Artists, Albums and Genres.Tick what you want on the Mac. The iPhone ticks playlists; the artists, albums and genres chosen on the Mac show there under Chosen on the Mac. Ticked playlists come first, in the order they are listed.
Include Music Videos.Videos come along as well.
Nothing chosen.The whole library still syncs, so the iPhone can browse and edit all of it. Only what you choose brings its audio and video.
Changing your mind.Songs no longer chosen leave the iPhone on the next sync. Their edits, cues and plays stay in the library.
Sync
On its own.With Sync when Katalog opens on this Wi-Fi switched on, as it is from the start, the Mac catches the iPhone up whenever Katalog opens on it nearby. Only what changed is sent, so a second sync takes seconds.
When you ask.Tap Sync on the Mac card at the top of the iPhone's Home tab, or click Sync on the iPhone's page on the Mac. The Mac counts the songs as it copies them.
While it charges.Switch on Sync When Charging in the iPhone's Settings and it syncs while Katalog is open on the charger, at most every 15 minutes.
Wi-Fi and Cable.The iPhone's Settings ▸ Sync chooses which connections it may use. Both are on from the start.
Edits go both ways
Made on the iPhone.Ratings, tags, colours, cues and playlist changes wait in the Sync screen, under Waiting to Send, until the next sync. Tap Undo on any of them before then and it never goes. Plays are counted on the Mac at the next sync.
Applied on the Mac.The Mac's History can undo them too. The iPhone's Sync screen lists the Mac's latest changes under From the Mac · Last Sync.
Changed on both.If the same field changed on both, the newest wins and the Mac's History keeps the other.
Unpair
From the Mac.The iPhone's page ▸ Forget This iPhone…. It stops syncing until it pairs again. The songs on it stay until then, and nothing in the library changes.
From the iPhone.Settings ▸ your Mac ▸ Forget This Mac. The library stays on the iPhone and you can keep editing. Changes wait until you pair again with a new code.
Syncing is part of the full version: free for the first 30 days, then it needs a licence on the Mac.
Help and Your Licence
The full version is free for 30 days. After that, the library, browsing, search, playback, playlists and editing tags by hand stay free for good. The tools, the AI features, effects, DJ exports, automatic metadata and iPhone sync need a licence: $30 a year. A licence bought during the beta is yours for life, and nothing changes for it. See the terms.
Something not working, or something you want it to do? Choose Help ▸ Report a Problem… in the app, or write to info@musickatalog.com.
Keep It Simple
None of the above is required. If Katalog feels like too much, switch off what you don't use, and it is a plain music library and player, only faster.
Switch off the modes.Settings ▸ Toolbar ▸ Modes. Switch a mode off and its button leaves the top bar. With all four off, the bar keeps Player, Browse and Crate, and the window is your library and a player.
Trim the sidebar.Settings ▸ Library ▸ Library Sections. Untick a section and it leaves the sidebar. Sections are only filters, so nothing is moved or deleted.
Bring them back.Switch them on again in the same place, any time. Everything you set up is still there.