Audiocanon catalogs the music on your drives without reorganizing it. Browse the collection, listen, choose covers and correct information while your files stay where you keep them.
Corrections are saved in Audiocanon first. Changing original filenames, writing tags or saving covers beside the music requires a separate review and confirmation.
Start with an archive#
An archive is a music folder and Audiocanon's catalog of it. You can add several archives and switch between them. A release is an album or another recorded programme; a release set holds related releases or volumes.
Add a music folder#
- Open Archive beside the logo to see Your archives.
- Choose Add archive and select the top-level music folder.
- Name the archive. Leave Archive Type on Automatic (recommended) unless you want to choose the type yourself.
- Choose Create and index.
- Follow progress in Your archives, then choose Load Archive when ready.
The first scan reads the audio, tags, artwork and notes. It calculates a checksum—a file fingerprint—for each audio file to check identity and find exact duplicates. It doesn't copy or change your music.
Large collections take time to scan, especially on external hard drives. If you quit before completion, Audiocanon can resume on the next launch.
New catalogs are stored in ~/Library/Application Support/Audiocanon.
Catalogs from older installations may be elsewhere; Your archives shows
their locations.
Choose an archive type#
- Single-artist archive suits a collection centred on one artist, including related projects and collector series. Archive view follows your filing structure.
- Multi-artist archive groups albums under artists, even when their folders sit inside genre or collection folders.
Automatic detection uses tags and folder names. To change its choice, open Your archives → Archive Type. This rebuilds the view without rescanning audio or rearranging folders.
Keep an archive current#
Audiocanon watches for additions, removals, replacements, renames and moves while running. It checks changes in batches, then updates the view. Large copies may take time to finish and verify.
To request an update, right-click the active Archive control and choose Update Archive Now. Your archives and the bottom status bar show progress or errors. A disconnected drive appears offline; its catalog is kept.
Remove an archive from Audiocanon#
Load another archive first. In Your archives, choose Delete Archive, read the warning and drag the confirmation slider fully right. You can't delete an archive while it's selected or updating.
This removes an app-managed catalog and its saved corrections, not the music. An externally stored legacy catalog is removed from the list but stays on disk. Export the catalog first if you want to keep your work.
Browse your collection#
Archive displays the collection as covers. Click an artist to see their albums, or open folders and collections in a single-artist archive. Open a release set to choose a volume.
The path above the covers shows your location. Click a breadcrumb to go back, or empty space around the covers to return one level. Audiocanon keeps your place.
Other views include:
- Artists: releases listed by artist, where available.
- Releases: a sortable table. Click once to select, double-click to open, or use disclosure arrows to expand sets.
- Chronology: additions during Last Week, Last Month, Last Year or All Time. Existing collections use Finder Date Added where available, with other file dates as a fallback. Later additions use the date Audiocanon first finds them. Older dates may be incomplete; a set is placed by its most recently added member, not its release year.
- Versions: editions of recurring albums in single-artist archives, without changing their folders or release groups.
- Folders, in the bottom status bar: the original folder tree, with loose tracks kept separate from releases beneath them.
Click a table heading to sort. Drag a divider to resize its column, or right-click the headings to choose columns. Layout choices are saved.
Command-click selects separate rows; Shift-click selects a range. Right-click a selection for its available actions.
Review and Duplicates are at the right of the bottom status bar, or under Maintenance in smaller windows. Their indicators show pending work you can return to later.
Arrange releases and sets#
Select related releases in the table, right-click and choose Release Title. Pick a suggestion or Enter title manually… to group them under that name. Existing sets can be included in a larger set. The same menu offers Remove from release set and Dissolve release set where applicable. Source folders don't move.
To change how a release opens, right-click it and choose Release Presentation:
- Automatic: let Audiocanon determine the structure.
- Combined Multi-Disc Release: one tracklist for all components.
- Expandable Release Set: choose a component before opening its tracklist.
For releases with separable components, this setting also appears under Edit Release → Edit release details → Structure. Check the release name before applying it. The change affects that release, not the whole folder branch, and can be undone.
Search#
Type in the main search field and press Return. To change the query, edit the words and press Return again; typing alone doesn't replace the results.
Results open in the Releases layout. Choose Releases or Tracks for
each kind of match. Words needn't form an exact phrase: midnight live can
find a track called “Midnight” on an album with “Live” in its title.
Click a track result to play it. Double-click opens its release without restarting that track if it's already playing. For release results, click to select and double-click to open.
Clear the field with × to restore your previous view, expanded groups and browsing position. Search covers the active archive.
Play music#
Click a track in a Release Window to play it; the rest of the release follows. Pressing Play without choosing a track starts at the beginning. Use previous and next to change tracks, play/pause to pause and resume, and the seek bar to move within a song.
All players share one session. Closing a Release Window, browsing another album, switching archives or changing layouts leaves playback running. Starting another track or release changes the music.
The top-bar player hides while the Release Window's player is visible. Listening Room has its own controls for the same session. Volume is shared, except when Reference Mode is active.
Double-click the top-bar player's title or the area around its controls to open the playing release without restarting it. Buttons and sliders keep their usual functions.
Choose an audio output#
Open the gear button, then Settings → Playback. Choose System Default or a connected device; Refresh updates the list. The choice is remembered.
Compatible Mode is the default. It supports software volume and the broadest range of files. Sample rate can preserve the device rate or match the source where supported. Matching rates alone doesn't prove bit-perfect playback. If the saved output is unavailable, Compatible Mode can switch visibly to the system output.
Reference Mode needs a specific supported wired output. It uses the source rate and a verified exclusive route where available.
Set a safe hardware volume before enabling Reference Mode. Audiocanon applies no software volume adjustment (unity gain); control loudness on your DAC, amplifier or monitor controller. Platinum meters indicate active Reference playback, and route details show the mode used by the current track.
An incompatible file, such as an unsupported multichannel recording, can fall back to Compatible Mode on the same connected output. Reference remains selected and is tried again when you choose another track or album. Disconnecting the Reference device stops playback rather than rerouting it. Reference claims apply to the verified route, not processing inside the DAC.
Shorten (.shn) files use Compatible Mode without saving converted audio to
a playback cache. DSD and DoP playback aren't included in this version.
Use the Release Window#
The cover, title, year and player sit above four tabs:
- Tracklist: tracks, titles, artists, playing times and formats.
- Files: indexed audio files and their locations.
- Identity: release information and its supporting evidence.
- Documents: indexed notes and other supported accompanying files.
Tracklist opens by default. Change this under Settings → Browsing → Opening release tab. The track area scrolls while the heading and player stay put; total playing time appears at the bottom.
For albums with multiple formats, click Format to choose one. FLAC is preferred when available. Opening a specific alternate-format track keeps that format selected.
Bonus tracks, alternate mixes and other meaningful subfolders appear as collapsible sections. Play a section alone or the whole release in sequence.
Add to Listening Room saves the release to your shelf. Right-click a release or track and choose Show in Finder to locate it on the drive.
Correct titles and other information#
Corrections are saved in Audiocanon without changing filenames or embedded tags.
Double-click a release title or year to edit it. In the tracklist, double-click a number, title or artist. Return saves a track edit and advances to the same field on the next row; Escape cancels it. Click Track to sort by disc and track number.
Double-click the Artist heading to set one artist for the release's tracks. For shared fields on selected tracks, use their right-click editing actions.
For more fields, choose Edit Release → Edit release details. Select the fields, compare original and new values, then choose Save in Audiocanon. Restore original removes the corresponding catalog correction.
Find track titles#
- Choose Edit Release → Find track titles.
- Choose Review proposal on a suitable result.
- Check release details and track assignments. Adjust the mapping if your copy has a different track count or disc layout.
- Select the fields you want and apply the reviewed values.
Included notes and back-cover text can supply titles; image text recognition runs on your Mac. Online matching uses MusicBrainz without an account or personal token. Optional Discogs access is available in Settings, with its token stored in macOS Keychain.
Every returned candidate can be reviewed, whatever its score. Check the edition and track order, especially for bootlegs and live recordings.
The proposal can also offer tag and filename previews using accepted values. Applying the catalog correction alone doesn't change the files.
Update original files#
Open Edit Release → Original files to update files on the drive. Tags and filenames are separate actions.
Audiocanon previews each file change, checks the files and prepares recovery information before the final slider confirmation. Keep a separate music backup before maintenance.
Update embedded tags#
Tags hold titles, artists and other information inside an audio file.
- Select Titles, Track #, Disc #, Artist, Album and/or Year.
- Choose Review tag updates. For titles alone, leave the other fields unchecked.
- Check the before-and-after values and any blocked entries.
- Continue through preparation, confirm the correct changes with the slider and wait for the result.
Only native FLAC tag writing is supported. Other formats can be previewed but not written. Updates change selected fields only and verify that the encoded audio is unchanged.
A * beside a track means its catalog information differs from the source metadata. The footer explains the difference and offers Sync original tags… to review pending changes. Asterisks clear once checked source values agree with Audiocanon.
Renaming doesn't update tags and may leave the asterisk. To use the source information instead, restore the catalog correction. Closing a preview doesn't clear a difference.
Rename audio files#
Choose Review filename updates. Names use Audiocanon's track information,
normally 01 - Song Title.flac. Check them before preparing and confirming.
Files stay in the same folder with their extension and audio bytes unchanged. Missing or changed files and conflicting destination names are blocked. Corrections follow the new paths.
Renaming a playing file may require Play to start a fresh queue. Do file maintenance between listening sessions to avoid interruption.
Undo and recovery#
Use Edit → Undo … or Command-Z; the menu names the change. Command-Shift-Z redoes supported catalog changes. Redoing a file change may require a fresh review and confirmation.
FLAC updates need temporary space for a full recovery copy. After verification, Audiocanon normally keeps only the original metadata needed for Undo. If that can't be done safely, the full copy stays and a storage warning appears. Renames and same-volume duplicate moves record how to move the files back, without copying the audio.
Undo won't overwrite files changed outside Audiocanon or replace missing or damaged music. Don't delete recovery files by hand or treat them as a backup.
Choose and save artwork#
Choose Edit Release → Choose cover…, or right-click the cover and choose Choose Cover Visually…. Pick from included artwork and enabled online suggestions. The choice appears in the Release Window, Archive and Listening Room.
Opening an album doesn't search online. Opening the chooser can request suggestions when there's no saved result; Refresh suggestions searches again. To open Artwork Finder, use More online options…, Edit Release → Find artwork online, or a release's Find Artwork Online… right-click action.
Find artwork online#
Check the title and artist, then choose Search artwork. Review the full previews before selecting a cover. For sets, choose shared or individual covers and check which volumes will receive them.
Try a shorter title or another query if needed. Search Google Images… opens a browser search, and Import downloaded image… imports a saved picture. Available results vary; this version has no archive-wide automatic cover-filling command.
Orientation and collection display#
Click the cover for the full-size viewer, with zoom and clockwise rotation. Orientation is saved without changing the original image. Square frames show the right-hand panel of wide sleeve scans; the full viewer shows the complete image.
For collections, right-click in Archive view and choose Artwork Display → Single Cover, Mosaic or Automatic. Individual volume covers are unchanged.
Save a downloaded cover beside the music#
Enable Settings → Artwork → Offer to save covers beside the audio files (off by default). After choosing artwork online, review the save offer and destination, then complete its separate confirmation.
The file is saved as accover.jpg. Other cover files stay untouched;
replacing an existing accover.jpg requires approval. Declining the save
still lets you use the image inside Audiocanon.
Build your Listening Room#
Save favourites from any archive on the Record Shelf (albums, collections and mixtapes) or in the Song Tray (individual tracks). Use Add to Listening Room on a release, or a track's right-click action. These are links, not audio copies, so the source drive must be connected to play them.
Click a shelf cover outside its play button to open it. Sets open a volume browser in the Release Window. Releases from other archives open without loading that archive, though catalog editing controls may differ.
The cover's play button starts playback; pressing it again stops that item. Opening details doesn't restart the music. Close the release to return to Listening Room behind it.
Arrange songs and make a mixtape#
Drag Song Tray rows into order; Play queue plays available songs from top to bottom.
Select at least two songs and press Make mixtape. Their initial order is the order you selected them. The tape appears on the Record Shelf; right-click to name it.
Open a tape to play songs or drag them into a new order. Add more by right-clicking a Song Tray track and using the mixtape addition command. Removing items leaves the original music alone. Listening Room changes can be undone.
Review duplicates#
Open Duplicates in the bottom status bar. Exact matches are releases containing the same complete set of byte-identical audio files, including repeated copies. Similar titles don't count. Different tags or encodings can change a file's checksum even when the music sounds the same.
Review comparisons share many exact files but aren't identical albums. Review these before marking them. Keeper suggestions consider filing context, artwork and accompanying files, not which mastering sounds best. Use the star to choose another keeper.
Mark all identical marks the other exact copies while preserving keepers and excluding manual-review comparisons. Releases and sets can also be marked through right-click menus. Marking doesn't move or delete files.
Dismiss comparisons through their right-click menu; Dismissed lets you restore them later. Suggestions in the separate Review view can be dismissed too.
Move marked duplicates#
- Choose Review marked moves, or Preview Duplicate Move… for a marked selection.
- Check folders, destinations and blocked entries.
- Choose Prepare protected move. Checking complete folders can take time.
- Review the prepared selection and complete the confirmation slider.
- Check the completion report for failed or skipped entries.
Cancel Operation cancels preparation before moving starts. Closing a preview doesn't approve a move, and dismissing a window after execution starts doesn't necessarily cancel it.
Folders move beneath DUPLICATES at the archive root, and those releases
disappear from the active catalog. If a destination name is taken, Audiocanon
adds a suffix. Cross-volume moves aren't supported.
The moved music stays on disk but isn't indexed. Edit → Undo … can move it back if the required files haven't changed. Audiocanon can't recover it if you delete it in Finder.
Export, back up and restore#
- Catalog and corrections: choose File → Export Current Archive… for
an
.audiocanonarchivepackage, without music or sidecars. - Albums or release sets: right-click and choose Export to ZIP File… to copy the physical folders and accompanying files.
- Mixtapes: right-click a tape and choose Export Mixtape… for audio
copies in tape order,
Tracklist.txtand an.m3u8playlist.
Save ZIP and mixtape exports outside the contributing archive folders. Copies are checked and the finished export appears only after success. Numbered names preserve existing files and folders.
Back up an archive#
Back up the music, artwork, notes and other sidecars independently. After important curation work, also choose File → Export Current Archive….
A catalog package isn't a complete app backup. It excludes Listening Room, application settings and downloaded artwork kept only in Audiocanon. Included and embedded cover choices are references to source files, not copies of the images.
A managed-only cover choice won't return from a catalog restore. Include
~/Library/Application Support/Audiocanon in your regular Mac backup for
managed images, Listening Room and settings, along with any legacy catalogs
stored elsewhere. Back up saved accover.jpg files with the music.
To restore a catalog:
- Connect or restore the source music.
- Choose File → Import Audiocanon Archive… and select the package.
- Select the collection's current top-level folder.
- Let Audiocanon check the restored catalog against the files.
Import installs the catalog in managed storage without copying or changing the music.
Database upgrade snapshots#
Audiocanon verifies a catalog snapshot before upgrading its database format. It contains no music or later edits.
Open Settings → Database backups → Review database backups to review the snapshots. Audiocanon keeps the newest verified snapshot per archive. Older ones become eligible for removal only after the required 30-day validation period and integrity checks.
Removal is separate, explicit and can't be undone. Nothing expires automatically, and cleanup leaves music, current catalogs and source-file Undo records alone.
The app's File → Archive Backup & Recovery Guide… offers a separate backup reference.
Set up your workspace#
Use Window configuration, beside Settings, to choose Full Archive Workspace, Compact Browser, Sidebar Browser or Floating Player. The smaller layouts have fixed sizes; Workspace allows resizing and full screen. Switching layouts doesn't stop playback.
Under Settings → Appearance, choose Classic or Private Press. Private Press offers Champagne, Silver and Midnight in Light, Dark or Follow macOS. Classic keeps its original dark appearance. Changes apply to open windows without altering artwork colours.
Settings → Browsing controls row spacing, opening view, Release Window tab and reduced motion across all archives.
The red close button hides the window while playback and monitoring continue. Click the Dock icon to reopen it. Command-Q or Audiocanon → Quit asks for confirmation before stopping the app.
Use the keyboard#
Tab and Shift-Tab move between controls; Return activates them. Text fields keep normal editing keys. Escape backs out of an edit, dialog or browsing level, but doesn't cancel a file write already running.
| Focus | Keys | Action |
|---|---|---|
| Archive covers | Arrows; Home/End | Move between tiles; first/last tile |
| Archive cover | Return or Space | Open artist, folder, set or release |
| Table rows | Up/Down; Left/Right | Move selection; collapse/expand collections |
| Table row | Return | Open release or play track search result |
| Release tracklist | Up/Down; Home/End | Browse without playing |
| Release track | Return | Play focused track |
| Release track field | Left/Right, then Return | Choose number, title or artist and edit |
| Track inline editor | Return; Escape | Save and advance; cancel edit |
| Player module itself | Left/Right tap | Previous/next on key release |
| Player module itself | Hold Left/Right, then release | Move seek preview at 10×, then seek once |
| Playback, outside text fields or other controls | Space | Play/pause |
| Seek or volume slider | Arrows | Adjust slider |
| Audiocanon history | Command-Z; Command-Shift-Z | Undo; redo supported changes |
Release the held arrow to seek to the previewed position; music plays at normal speed while you hold it. Tab stays within the active dialog, and closing it returns focus to the control that opened it.
Troubleshooting#
A new or changed file has not appeared#
Check Your archives for an offline drive, progress or an error. Let copies and updates finish, or choose Update Archive Now. If it still looks wrong, note the status and what changed before restarting or importing again. Don't delete the catalog as a first step.
The player is silent#
Check the active output and hardware volume. Software volume is unavailable in Reference Mode; read any fallback or device-loss message. Keep the hardware level low—sound may return suddenly.
Note the format, sample rate, channel count and whether the problem followed a seek, track change or device change.
A file change is blocked or does not finish#
Check the stated reason: drive connection and write access, missing files, unsupported formats or conflicting names. A changed source needs a fresh preview.
Keep the result or error visible. Don't repeat confirmation while work is running. Audiocanon may refuse changes or recovery rather than overwrite external edits.
Artwork or identification has no useful result#
Check Work offline and artwork settings. Try a shorter title, another artist/title query or an image you already have. Included notes and manual corrections can help when your edition isn't listed online.
A long update appears idle#
Large files can take time to check without changing the displayed phase. Playback takes priority over background work. If progress stops or failures repeat, note the displayed phase, processed count and any error message.
Report a problem without sharing the collection#
Settings shows the version and build. Settings → Diagnostics lets you enable or clear local error history.
File → Export Support Diagnostics… discloses the contents before saving environment details and anonymous totals. Nothing is sent automatically. The package excludes music, artwork, archive names, paths, filenames, music metadata, credentials and listening history. Check screenshots and extra notes separately before sharing them.
About this guide#
This guide covers v0.33.0 for macOS, which is still in private testing. Public installation instructions aren't included. Keyboard and VoiceOver checks cover selected journeys, not every assistive setting or hardware configuration.