yafm

Yet Another File Manager for macOS. A fast, keyboard-driven, modern alternative to Finder — that never freezes silently.

Status: v0.9.6.1 — 1.0 candidate. Native Swift / SwiftUI. The spine (v0.1–0.3: dual-pane + tabs, async listing, own file engine, tags, JS plugins, git, search) is done; v0.4–0.9 added the keyboard-first speed layer, content search, SMB, the plugin capability model, archives, accessibility, and a Russian UI — then a five-dimension audit pass, a float-layout visual redesign, (v0.9.5) colored file-type tiles, live sidebar drag-reorder, configurable columns, and (v0.9.6) collapsible sidebar (icon-strip mode + section collapse), in-window Settings overlay, sidebar active highlights for devices and tags. See ROADMAP.md and CHANGELOG.md. New here? Read the User Guide (RU).

Why

Finder is a rudiment of old releases: weak tags, garbage color coding, and it freezes silently on external disks (empty folder for minutes, no "loading" signal). yafm fixes that — everything async with an honest "reading…" state, real tags, dual-pane keyboard-first navigation.

See VISION.md for the full vision, locked decisions, and roadmap.

Highlights

Core

• Dual pane + tabs, keyboard-first (Total Commander–style) — F-key bar, arrows, multi-select (⇧/Insert/⌘-click), Home/End/PageUp-Down
• Async listing — always shows what it's loading, never a dead empty folder; honest empty/error/limited states
• Own file-operation engine with a visible queue, progress, cancel — atomic replace (no data loss on a failed copy)
• Move to Trash (F8) or permanent delete (⇧F8); real macOS tags + fast index + sidebar tag cloud
• Right-click menus, sortable columns + info inspector, live volumes/USB/network in the sidebar (with eject), QuickLook + preview panel

Speed & polish (v0.4–0.5)

• ⌘K command palette (fuzzy jump to commands / favorites / subfolders), type-to-filter, real file-type icons
• Density modes, full drag-and-drop (⌘ to move), scoped animation, keyboard tab-switching (⌃Tab / ⌘1–9), ⌘/ cheat sheet

Reach (v0.6–0.7)

• Content search (grep-in-files) — streaming, cancellable, bounded; inline find bar (⌘F, name or contents)
• SMB shares mount natively behind a filesystem router (⌘⇧K) — a slow share loads, never freezes
• VoiceOver + Dynamic Type; Russian UI + language picker

Extensibility (v0.8–0.9)

• JavaScript plugins with a capability model — manifests, per-plugin enable/disable, scoped file reads (read:cwd), commands & menu items. See docs/plugins.md
• Browse .zip archives read-only like any folder; bulk-rename transformers + custom previewers; plugin API frozen at 1.0

Distribution

DMG, no App Store, no sandbox. A notarized DMG is the goal once an Apple Developer ID is in place; for now releases ship an unnotarized DMG.

Installing an unnotarized DMG

Until the app is notarized (needs a paid Apple Developer account), Gatekeeper will warn on first launch. Open it once with any of:

• Right-click yafm.app → Open → Open, or
• System Settings → Privacy & Security → scroll down → Open Anyway, or
• Terminal: xattr -dr com.apple.quarantine /Applications/yafm.app

After the first launch it opens normally. Or just build from source (below) — locally built apps aren't quarantined.

Development

Stack: Swift / SwiftUI, SwiftPM (no Xcode project). The app must run from a real .app bundle:

swift build                    # compile Core + yafm
swift test                     # Core unit tests
Scripts/make-app.sh            # wrap .build/debug/yafm into .build/debug/yafm.app
open .build/debug/yafm.app     # run
Scripts/make-dmg.sh            # release build → .dmg (unnotarized; set CODESIGN_IDENTITY + AC_NOTARY_PROFILE to notarize)

See ARCHITECTURE.md for the module layout and ROADMAP.md for status. Triaged feature specs (all closed — shipped or deferred post-1.0) live in docs/feature-requests/.

License

GNU GPL v3.0 with a Plugin Exception — see LICENSE.

What this means in practice:

• yafm itself is copyleft: any fork or modified version of the app must also be open source under the GPL. You can't take this code and ship a closed-source / proprietary fork.
• Plugins are exempt. Anything that talks to yafm only through its published Plugin API (JavaScript plugins via JavaScriptCore, or native/XPC extensions through the extension registry) is not a derivative work and may be licensed however you like — including proprietary and paid plugins.

Contributions are accepted under the same license.

---

На русском

yafm — файловый менеджер для macOS, быстрый и клавиатурный. Альтернатива Finder, которая никогда не зависает молча: весь доступ к файловой системе асинхронный, с честным индикатором «читаю…».

Зачем

Finder — рудимент: слабые теги, кривое цветовое кодирование, зависание на внешних дисках без какого-либо сигнала. yafm исправляет это: двойная панель в стиле Total Commander, собственный движок операций с прогрессом и отменой, нативные теги macOS, JS-плагины.

Ключевые возможности

Ядро

• Двойная панель + вкладки, клавиатурная навигация (F-bar, стрелки, мульти-выбор ⇧/Insert/⌘)
• Асинхронный листинг — всегда видно, что загружается; честные состояния «пусто» / «ошибка»
• Собственный движок файловых операций: очередь, прогресс, отмена, атомарная замена
• Корзина F8, постоянное удаление ⇧F8; нативные теги macOS + индекс + тег-клауд в сайдбаре
• Правый клик, сортируемые колонки, инспектор, QuickLook, панель предпросмотра

Скорость и полировка (v0.4–0.5)

• ⌘K командная палитра (нечёткий поиск команд / закладок / подпапок), type-to-filter
• Режимы плотности, drag-and-drop (⌘ = перемещение), переключение вкладок ⌃Tab / ⌘1–9

Охват (v0.6–0.7)

• Поиск по содержимому — потоковый, с отменой; строка поиска ⌘F
• SMB-шары монтируются нативно (⌘⇧K) — медленный шар не заморозит интерфейс
• VoiceOver + Dynamic Type; русский UI + переключатель языка в Настройках

Расширяемость (v0.8–0.9)

• JavaScript-плагины — манифесты, per-plugin вкл/выкл, права доступа (read:cwd, read:exif, contribute:action и др.). Подробнее: docs/plugins.md
• Просмотр .zip-архивов как папок; трансформеры и превьюеры для массового переименования

Установка

DMG, без App Store, без sandbox. До получения Apple Developer ID релизы выходят без нотаризации. Открыть один раз через:

• Правый клик на yafm.app → Открыть → Открыть, или
• Системные настройки → Конфиденциальность и безопасность → Всё равно открыть, или
• Терминал: xattr -dr com.apple.quarantine /Applications/yafm.app

Сборка из исходников

swift build                 # компиляция Core + yafm
swift test                  # юнит-тесты Core
Scripts/make-app.sh         # обернуть в .app
open .build/debug/yafm.app  # запустить

Руководство пользователя

docs/USER_GUIDE.md (EN) · docs/USER_GUIDE.ru.md (RU)