How Abisam works

Abisam is a music library manager and player for the Mac, in the spirit of the classic desktop players — a tag-aware home for a music collection you own. It reads the audio files you already have, keeps a tidy library of them, plays them, and gives you deep tools to organize, tag, rate, and curate.

It is deliberately not a streaming service, a cloud locker, or a video player. It doesn't rent you music, upload your library, track your listening, or replace a subscription app. It does one thing — manage and play your own collection — and tries to do it simply and well. Audio only; no video, ever.

It's made for people who own their music and care about it — collectors with big libraries, folks who rip their CDs or buy from Bandcamp, anyone who builds playlists on rating, genre, tempo, or mood and wants their tags and cover art done right. If you've ever been frustrated that a streaming app forgets everything the moment you cancel, Abisam is built for you.

Abisam is a normal Mac app. Download it, open the .dmg, and drag Abisam into your Applications folder. It runs on both Apple Silicon and Intel Macs.

The first time you open Abisam, you'll point it at the folder (or folders) where your music lives. It scans them, reads the tags and cover art from your files, and builds your library. This can take a little while the first time for a big collection — after that, it's quick.

Your files stay exactly where they are. Abisam plays them in place and never copies, moves, or renames them. The library it builds is a separate index that points at your files; your music folders are left untouched.

Added more music later? Use Rescan and Abisam picks up what's new and refreshes what changed — without disturbing any edits you've made inside the app.

The window is built from movable panels. The usual pieces:

• The Views panel switches between Library, Albums, Artists, and Crates.
• The library table is the heart of it — your tracks in sortable columns, with album art, ratings, and everything you'd want to sort on.
• The Cockpit (Now Playing, Rating, Lyrics, and field panels) sits beside the current track so you can edit as you listen — Tab moves you from field to field.
• Up Next shows what's queued and what just played.
• The transport bar along the bottom holds play, skip, the timeline, and volume.

Every panel can be dragged, resized, and rearranged — see Skins & panels. Along the top bar, Add panel brings pieces back, Layout ▾ holds your saved layouts and the layout lock, and ⊞ Arrange opens a grid for fine-tuning.

The same collection, seen four ways:

• Library — every track in one sortable table.
• Albums — a cover browser; open an album to see its tracks. A fast letter-jump strip lets you fling through a big collection quickly. Inside an album, the cover carousel moves with a click on a dimmed neighbouring cover — or the ← → arrow keys while the library panel is focused.
• Artists — grouped by artist, with a flat-track or album-browser sub-view.
• Crates — your own curated shelves (below).

Right-click almost anything — a track, an album cover, an artist card — for a menu that lets you play it, queue it, edit its tags, add it to a playlist or crate, and jump to it in the other views.

A Crate is a hand-picked shelf of albums — grouped by mood, activity, era, whatever you like ("Sunday Morning," "Deep Focus," "Road Trip"). To fill one, right-click any album anywhere and choose Crates → the crate you want, or make a new one.

The Crates view shows each crate covers-forward. Open one and you get a column of play modes on the left and the crate's albums on the right:

• Play in order, shuffle albums, shuffle tracks, full shuffle, or a Sampler (1–3 tracks per album).
• A ★ 3+ gate (on by default) keeps play modes to your better-rated tracks; below-gate tracks show dimmed so you can see what's skipped.
• New playlist from crate opens the Curated Playlist editor pre-filled with the crate and a rating minimum, ready to refine.

Because a crate is written into your files (as a standard grouping tag), your crates survive a rescan — or even a rebuilt library.

The search box filters the current view by title, artist, or album as you type. Click a column header to sort by it; click again to reverse — or use the Sort dropdown in the Library toolbar, which lists exactly the columns you have showing, beside a direction toggle that speaks plainly: A–Z / Z–A for text, Newest / Oldest for dates, Highest / Lowest for ratings, Longest / Shortest for time. Each field starts in its most useful direction, and Tempo sorts by speed (Very Fast → Very Slow), not alphabetically.

Choose your columns. Right-click any column header to show or hide columns — including Date Added, Grouping, Tempo, and BPM, which are available but start hidden (Restore all columns brings everything back). Drag the edges to resize; your choices are remembered. The Albums and Artists walls follow the direction toggle too — flip A–Z to Z–A and the covers flip with it.

In a playlist, "Playlist order" is the playlist's own order (what plays and what a saved copy freezes); other sorts are a temporary view lens that never changes the playlist itself.

Double-click a track to play it, or select tracks and press the play button. The Up Next panel shows the queue — what's coming, the current track highlighted, and a few recently-played tracks above it. Drag to reorder, or right-click a track anywhere to add it to the queue.

Shuffle and repeat live on the transport bar. Keyboard shortcuts cover the essentials (play/pause, next/previous, and seeking within a track), and every shortcut is editable under Settings → Shortcuts if you prefer your own.

Under Settings → Playback you can turn on a crossfade that overlaps the end of one track with the start of the next when a track finishes naturally. You control both the fade length and how the incoming track ramps up. Skipping is always instant — the crossfade only applies to natural transitions.

Two jump buttons flank the play button and skip forward or back within a track by an amount you set; when the player is focused, the ← and → arrow keys do the same.

Right-click a track (or a selection) and choose Edit tags to open the editor. It's organized into tabs — Core (title, artist, album, and so on), Details (composer, mood, tempo, and more), Lyrics, Artwork, Advanced (custom fields), Identity (service IDs), and Statistics.

You can also edit right from the Cockpit beside the playing track — no dialog needed — and edit a whole album or a multi-track selection at once. In a batch, a blank field means "leave unchanged," so you only touch what you mean to.

Rate any track from 0 to 5 stars (half-stars included); a zero-star "ignore" is distinct from unrated. Ratings drive Crates and Curated Playlists, so they're worth setting as you listen.

Abisam also quietly tracks plays, skips, and last-played: a track counts as played once you've heard about half of it (or four minutes); moving on early counts as a skip; restarts and re-plays judge nothing. Those numbers feed the Statistics tab and are available as playlist criteria — "songs I haven't heard in a while," for instance.

Beyond the standard tags, you can define your own fields — an "Occasion," an "Energy," anything you sort by — on the Advanced tab. Any custom field can be turned into a vocabulary list: a controlled set of allowed values, so instead of typing free-form (and misspelling "Sountrack") you pick from a consistent list, with type-ahead and multi-value support.

Fields like Mood, Tempo, Occasion, and Genre already work this way. Your custom fields and their values are written into your files as standard tags, so they travel with your music.

Every edit — a tag, a rating, a custom field, a crate — is saved to Abisam's library database instantly, so the app is always fast. The audio files are then updated a moment later by a background writer, so your changes end up in standard tags other players understand.

That writer is careful: it never touches a track while it's playing, and it always finishes writing before the app closes. The header shows "(N pending updates)" while anything is still waiting.

For messy or unknown files, right-click a track (or a whole album) to look it up:

• Fix tags (MusicBrainz) — searches the open MusicBrainz encyclopedia by your existing tags. Free, no account, works out of the box.
• Fix album tags (MusicBrainz) — matches the whole tracklist at once.

You get a side-by-side sheet: your current tags next to the match, field by field, with cover art from the Cover Art Archive so you can confirm the right pressing. Tick exactly which fields to apply — nothing is written until you say so. Album lookups can fill in genre, label, catalog number, and the MusicBrainz IDs alongside the basics.

Missing cover art? On the tag editor's Artwork tab, Look up artwork online searches the Cover Art Archive for the album. If the track already carries a MusicBrainz ID (from a lookup or a tagged rip), the exact edition is offered first; otherwise it searches by artist and album, and you can browse a whole artist's covers. Each result shows its real pixel resolution so you can pick the sharpest, and clicking a title opens every image that release holds — front, back, booklet, disc — to apply to the matching slot. As always, nothing is written until you choose one.

Build a regular playlist by dragging tracks in, or right-click a selection → Add to playlist. Drag to reorder; a playlist opens in its own manual order. You can export a playlist as an .m3u file and import one back in.

A Curated Playlist fills itself from rules instead of hand-picked tracks. Click the ✦ in the Playlists panel and describe what you want:

• Rules on any field — rating, genre, tempo, mood, play count, last-played, your own custom fields — matched all or any. Mark a rule must to require it even in "any" mode ("anything upbeat, but it must be 4 stars").
• Tag-set matching for fields that hold several values at once (genre, mood, crate, occasion, tempo, custom tags): has all of requires every listed tag, has any of needs at least one, and has none of excludes them. List the values separated by semicolons (Jazz; Ambient); matches are on whole tags, so "World" won't catch "Worldbeat".
• A limit — so many tracks, or so many minutes — chosen by most-played, highest-rated, most-recent, random, and more.
• A playlist order — the order the tracks actually play in.

A live count shows how many tracks match and how much variety the pool holds, so you know whether re-shuffles will feel fresh or repeat. Hit Regenerate for a new random mix any time, or Save as static to freeze the current list into a normal playlist you can keep. You can edit a Curated Playlist's rules right above its own live results and watch them update as you type.

The interface is yours to arrange. Every panel drags, resizes, and snaps to its neighbours — put the library where you want it, the cockpit where you want it, and hide what you don't use.

Arrange mode. For a deliberate layout pass, click ⊞ Arrange in the top bar: a dot grid appears and every panel is outlined so you can see exactly what sits where. Click a panel and nudge it a few pixels at a time with ⌥ Arrow (add Shift for bigger steps). Press Esc when you're done.

Named layouts & themes. The Layout ▾ menu saves the current setup under a name — and you choose what it carries: ▦ the layout (panel positions & sizes), 🎨 the colors & backgrounds, or both, which makes it a full theme. The icons next to each saved name show what it holds, and applying one restores exactly that. The Reset group restores the standard layout, colors, or panel backgrounds individually.

Lock it. When a layout is right, lock it from the same menu so a stray drag can't move anything: Panel Lock freezes everything exactly as arranged — rounded corners, gaps and all; Bordered Lock settles the panels flush with visible seams; Borderless Lock hides the seams so the window reads as one clean face. Unlock any time from the same place.

Layout stencil. Also under Layout ▾: Export layout stencil (PNG) saves a pair of black-and-white maps of your exact arrangement — one as-is, one in its flush locked form — every panel measured and labeled, sized for Retina, with a small data file alongside. It's made for designing background art that fits your layout to the pixel.

Day & night. Click the Abisam wordmark to cycle the accent color through nine choices — seven hues plus a fixed eggshell White and near Black; double-click it to flip between night and day. Day mode swaps the whole canvas to warm daylight surfaces and re-tunes the seven hues to match (White and Black stay exactly as they are) — your color choice carries across, and both are remembered.

Your own colors. Under Settings → Appearance → Edit colors… (or right-click the wordmark) you can change the night and day surfaces and all nine accent colors. Changes apply live as you pick. You choose the hue; Abisam auto-tunes its depth against each surface so everything stays readable. Hover the swatch strip under each surface to try variations of your pick; "Derive hues from surface" makes the seven hues follow the surface itself (White and Black stay put). You can also fine-tune the three reading colors — primary, secondary, and tertiary — with a hex field or a tonal swatch strip; secondary and tertiary follow the primary unless you set them. Reset all brings back the built-ins.

Panel backgrounds. Right-click any panel's title bar and choose Choose background… to open the background designer: a miniature map of your whole layout — every panel plus the app bar and transport, all paintable. Click zones to select (as many as you like), then apply a fill color or an image and watch it happen live. Images come from your image library: load one once and it's kept for reuse. With several zones selected, an image can fill each panel independently or run as one image across the whole selection — and a spanning image stays continuous even after you rearrange the panels. An image can cover the full panel, the panel only (leaving the title bar to your fill color and its darker/lighter control), or the header only — mix and match per panel. Text takes care of itself: a painted panel re-derives its text colors against your fill automatically, so light fills get dark ink and dark fills get light. "Dim background" is there if you want an image quieter; leave it off and your art shows exactly as-is.

All of this is built in — no external tools or files needed. Save a look you like as a theme from the Layout ▾ menu (it carries your colors and panel backgrounds) and re-apply it any time. And if you ever paint yourself into a corner, double-click the note logo in the top bar for a one-click reset straight back to the built-in dark theme.

Two things live on your Mac, both under your control:

• Your music files — right where you keep them. Abisam never moves or copies them.
• Abisam's library — a database in your Mac's Application Support folder that holds the index of your tracks, your ratings, playlists, crates, and settings. Your edits are also written back into the files themselves, so the files are the durable copy.

Nothing lives on any company's server. There's no account, and nothing about your library or listening is ever uploaded.

Because your ratings and playlists are written into the audio files as standard tags, your most important curation travels with the music itself — back up your music folders (Time Machine, a cloud drive, an external disk) and those come along.

The library database — which also holds things that don't fit in file tags, like playlist membership and layout — sits in your Mac's Application Support folder and is included in a normal Time Machine backup. If you ever move to a new Mac, copy your music folders across and point Abisam at them; a rescan rebuilds the library, and your file-based ratings and crates come right back.

Abisam works fully offline. The only time it reaches the internet is when you ask it to look something up, and it goes straight to the source — never through us.

• MusicBrainz — text-based tag lookup. Free, needs no account or key.
• Cover Art Archive — album covers, fetched by release. Free, no key.

Abisam collects nothing and phones home to no one. There are no accounts, no analytics, no ads, and no tracking. Your library, your listening, your edits — all of it stays on your machine, under your control. Online lookups are the only network activity, they happen only when you initiate them, and they go directly to the service. That's the whole deal.

You can try the complete app free for 30 days — every feature, your whole library, no account and no card. If Abisam earns a place in your setup, a one-time license keeps you going. There's no subscription, and your license is yours to keep.