Macorn
A file manager for macOS, built for developers. Keep your folders where they are, and organize files across as many virtual dimensions as you need — tags (nestable like work/client-a) and sidebar sections — without moving anything. Use it alongside Finder, not instead of it.
- Split the window into up to 6 panes, and copy or move between them with F5 / F6
- Command palette (⌘K) with fuzzy search
- Built-in terminal that follows the folder you are viewing, plus "open in terminal / editor"
- Git branch and status in the list, and a read-only diff window
- Preview for Markdown, text, HTML, CSV, images, PDF, video and documents; edit Markdown and text right in the preview
- Filter the current folder by name, optionally including subfolders (⌘F, ⌥⌘F)
- No third-party dependencies (Swift 6, AppKit + SwiftUI). macOS 15 or later
Download the signed and notarized app from https://macorn.app. The app and documents are in Japanese.
Build from source: open Macorn.xcodeproj in Xcode 26 or later and press ⌘R. Debug builds are ad-hoc signed, so no Apple developer account is needed.
Licensed under the MIT License. The name "Macorn" and its icon and logo (Branding/, Macorn/Assets.xcassets) are not covered by the license; please don't use them when you distribute your own builds or forks.
開発者向けに作り変えた macOS のファイルマネージャー。旧名は noxy（2026-10-26 に改名）。要件は docs/REQUIREMENTS.md を参照。
進捗
| マイルストーン | 状態 |
|---|
| M1 ウィンドウ・サイドバー・リスト表示・移動 | 完了 |
| M2 基本のファイル操作・クイックルック | 完了 |
| M3 2画面表示 | 完了 |
| M4 コマンドパレット | 完了 |
| M5 ターミナル・エディタ連携 | 完了（MVP 完成） |
| M6 v1.0 の残り | 完了 |
v1.x 以降（カスタムコマンド、ワークスペース保存など）は、内蔵ターミナルの最初の版を除いて未着手。詳しくは要件定義書の「13. 実装状況」を参照。
主な操作
| 操作 | キー |
|---|
コマンドパレット（> コマンド、/ ~ パス、@ ファイル、# サイドバー） | ⌘K |
| 2画面表示 / もう一方の画面へ | ⌘\ / Tab |
| 反対側の画面へコピー / 移動 | F5 / F6 |
| ターミナルで開く / エディタで開く | ⌥⌘T / ⌥⌘E |
| パスをコピー | ⌥⌘C、パスバーのパスのすぐ右のボタン、右クリック（ほかの形式も） |
| 絞り込み | ⌘F または / |
タグを編集（名前は自由、仕事/案件A で階層） | ⌥⌘G |
| タグの親を変える | サイドバーでタグをほかのタグの行の真ん中へドラッグ（見出しへ置くといちばん上）、右クリック › 親のタグ |
| タグの並び順を変える | サイドバーでタグを行の間（行の上下の端）へドラッグ |
| 並び順（名前・変更日・サイズ・種類・タグ） | ⌃⌘1〜5、列の見出しをクリック |
| お気に入りに追加・外す（フォルダもファイルも。「お気に入り」のタグの付け外し） | ⌃⌘T、パスバーの右の ★、右クリック |
| プレビュー（.md・.txt・.html・.csv・画像・PDF・動画・書類を選ぶと右に表示）の切り替え | ⌥⌘P |
| テーマ（外観・アクセントカラー） | 設定（⌘,）› 一般 |
| プレビューの拡大・縮小 | ⌘+ / ⌘− / ⌘0、トラックパッドのピンチ |
| サイドバーの構成（セクションの順番・表示、タグのセクション、お気に入りのタグ） | 見出しやタグをドラッグ＆ドロップ、見出しを右クリック、設定（⌘,）› サイドバー |
| フォルダ・ファイルをセクションに置く | 一覧で右クリック ›「セクションに置く」（新しいセクションを作って置くこともできる） |
| セクションを作る（タグ・フォルダ・ファイルをまとめる見出し。項目には何も付かない。最初に「マイセクション」が1つある） | サイドバーの上部の「＋ 追加」›「セクションを作る…」、見出しや空き場所を右クリック ›「セクションを作る…」、設定（⌘,）› サイドバー |
| お気に入り・セクションの項目をほかのタグへ移す | 項目をタグへドラッグ（⌥ を押しながらで元の場所にも残す） |
| 名前を変更（複数選択なら一括） | Return |
| クイックルック | スペース |
| パスを入力（Tab で補完） | ⌘L、パスバーの空いている所か今いるフォルダの名前を1回クリック |
| 新規フォルダ / 新規ファイル | ⇧⌘N / ⌥⌘N、パスバーの右のボタン |
| PDF・Markdown・HTML・CSV・画像・動画・音声を Macorn で開く（「このアプリケーションで開く」に出る。種類ごとに既定のアプリにもできる） | 設定（⌘,）› 連携 ›「ファイルを Macorn で開く」 |
| ほかのアプリの「Finder に表示」を Macorn で開く（フォルダの既定のアプリは macOS の制限で変えられない） | 設定（⌘,）› 連携 ›「Finder の代わりに使う」 |
| 新しいバージョンを確認し、「今すぐ更新」で入れ替えて開き直す（起動時にも確認。設定でオフにできる） | Macorn ›「アップデートを確認…」、設定（⌘,）› 一般 › アップデート |
| 設定 | ⌘, |
ショートカットは設定の「ショートカット」タブで変更できる。
必要なもの
ビルドと起動
Xcode で Macorn.xcodeproj を開き、⌘R で起動する。コマンドラインからは次のとおり。
xcodebuild -project Macorn.xcodeproj -scheme Macorn -derivedDataPath build/DerivedData build
open build/DerivedData/Build/Products/Debug/Macorn.app
テスト（約 200 件）:
xcodebuild -project Macorn.xcodeproj -scheme Macorn -derivedDataPath build/DerivedData test
ターミナルから macorn . で開けるようにするには、アプリのメニュー「Macorn › コマンドラインツールをインストール…」を使う。
配布用の DMG
Developer ID で署名し、Apple の公証を通した DMG を作る。ほかの Mac でも警告なしに開ける。作者（配布する人）の証明書と公証の資格情報が要るので、作者だけが使う。自分で使うだけなら、上の「ビルドと起動」で足りる。
bash scripts/release.sh
- 出力は
build/release/Macorn-<バージョン>.dmg。バージョンは Xcode の MARKETING_VERSION
- 普段の開発ビルドは簡易署名（
-）のまま。署名の設定はこのスクリプトの中でだけ上書きする
- 前提：キーチェーンに「Developer ID Application: TAKUMI KON (Q9Q29NW29B)」の証明書と、公証の資格情報（
xcrun notarytool store-credentials macorn-notary … で登録したもの）があること
- 公証は数分〜数十分かかる（初回は約35分だった）。
--no-notarize を付けると公証を省く（手元での確認用）
- DMG を開くと、背景の矢印の左右に Macorn と「アプリケーション」が並び、ドラッグを促す。背景は
scripts/dmg/make-background.swift で描き（swift scripts/dmg/make-background.swift scripts/dmg）、配置は scripts/dmg/layout.applescript で Finder に設定させる。初回は「Finder を操作する」許可を求められることがある
- 公証の結果は DMG に添付する。DMG から取り出したアプリは、初めて開くときに macOS がネットで公証を確かめる
LP（https://macorn.app）から配る DMG を新しくするときは --publish を付ける。LP は別の非公開のリポジトリ（作者だけが使う macorn-site）にあり、既定では隣のフォルダ ../macorn-site/site に書き込む（違う場所なら MACORN_SITE_DIR）。DMG（download/Macorn.dmg）を差し替え、LP のバージョンとサイズの表記と、アプリが新しい版を確かめる version.json も書き換える。バージョンは先に Xcode の MARKETING_VERSION（と CURRENT_PROJECT_VERSION）を上げておく。そのあと LP のリポジトリで main に push すると、GitHub Actions が LP ごと公開する。
bash scripts/release.sh --publish
フォルダ構成
| 場所 | 内容 |
|---|
Macorn/App | 起動処理・メニューバー・ウィンドウとタブの管理・開発用の自動操作 |
Macorn/Window | 1つのウィンドウ（サイドバー＋タブを持つ画面をいくつか＋ツールバー）と画面の分割・タブのドラッグ、Git の変更（差分）のウィンドウ |
Macorn/Browser | 1つの画面（ファイル一覧・パスバー・絞り込み・ステータスバー）と、その操作 |
Macorn/Operations | コピー・移動・ゴミ箱・名前変更などの実行と取り消し、進み具合の表示、クリップボード |
Macorn/Preview | ファイルのプレビュー（Markdown → HTML の変換、CSV → 表の変換、Word の書類を幅に合わせて折り返す HTML への変換と、Markdown・HTML・CSV・画像・PDF・動画・書類の表示。Markdown・テキスト（.txt）はプレビューのまま編集でき、MarkdownEditor.swift が編集と保存を受け持つ） |
Macorn/Palette | コマンドパレット（あいまい検索・ローマ字・フォルダ履歴） |
Macorn/Terminal | 内蔵ターミナル（疑似端末・制御文字の読み取りと画面の中身・描画とキー入力・ウィンドウの下のパネル） |
Macorn/Integration | ターミナル・エディタ連携、パスのコピー、Git の状態と差分の読み取り |
Macorn/Settings | 設定ウィンドウ、ショートカットの変更、コマンドラインツール |
Macorn/Sidebar | サイドバー |
Macorn/Model | フォルダの読み込み・並べ替え・履歴・パス補完・変更監視・名前の規則・フォルダサイズ |
MacornTests | ユニットテスト |
Macorn/Assets.xcassets | アプリアイコン（元データは Branding/） |
プロジェクトは Xcode の「フォルダ同期」形式のため、Macorn/ や MacornTests/ にファイルを置くだけでビルド対象になる。
開発用の自動操作（Debug ビルドのみ）
環境変数で操作手順を渡すと、自動で操作しながらウィンドウの画像を保存する。画面収録の許可がなくても見た目を確認できる。自動操作中はウィンドウをキーにしないので、ほかのアプリでの入力を奪わない。
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
