Installing

installing

requires apple silicon + macos 14 or newer.

get an available build from releases, move betterfinder.app to applications, then open it. if there isnt a release for u yet, build from source.

allow access to folders as u use them. full disk access is separate in system settings; enable it only if u need protected locations. onboarding can help u make betterfinder the default, and u can undo that later.

mods: settings → mods has browse and installed tabs. install shows the permissions first, checks the authors signature, runs preflight, then asks before enabling. nothing auto-enables. the mods menu has manage mods, install mod from file, load unpacked mod (hot reload), reload mods (⌥⇧⌘R), safe mode and mod logs. see getting started.

density: settings → general → listing. compact, regular or comfortable for the sidebar, lists, columns and icons. leave it unset and the theme decides, so the retro themes stay compact.