Left Right
サポート · LEFT RIGHT

サポート / FAQ

Left Right の使いかたと、よくある質問をまとめました。解決しないときは、メールでご連絡ください。

Left Right 1.0.0 は 2026年9月22日に Mac App Store で公開しました。

アプリ · Left Right 対応 · macOS 27 以降 最終更新 · 2026年9月27日

01動作環境

  • macOS 27 以降(Apple シリコン搭載の Mac)
  • ネットワーク接続は不要です。Left Right は通信しません。
  • Mac App Store から入手できます。紹介ページから DMG を直接ダウンロードすることもできます(Developer ID 署名・Apple の公証済み)。

02何を比べられるか

Left Right は、ファイルの型と内容から比較の種類を自動で判定します。利用者が種類を選ぶ必要はありません。

  • 2 つのテキストファイル — 左右 2 ペインに並べ、対応する行を水平に揃えて同期スクロールします。行単位の追加・削除・変更、行内ハイライト、塊単位のマージ、ペイン内検索(⌘F)に対応します。
  • 2 つのフォルダー — 再帰的に走査し、ツリー表示(階層/一覧)で違いを並べます。比較モードは賢く/内容/メタデータ/バイトです。
  • 3 つのファイル — 左・元・右として 3-way マージします。離れた変更は自動で合わせ、重なった変更は競合として git 互換の印で結果に残ります。
  • 表 — CSV / TSV と .xlsx / .ods / .numbers を表として並べます。見出し行で列を対応づけ、鍵の列で行を対応づけられます。
  • バイナリ — 16 進で同じオフセットどうしを比べます。両脇に見取り図(バイトマップ+エントロピー帯)を出します。
  • 画像 — 並べる/重ねる/境界を動かす/差分/点滅/熱地図の 6 つの見せ方と、しきい値を備えます。

03保存するまで書かない

テキストの編集・塊の取り込み・3-way の結果は、保存するまでディスクへ書きません。

  • これらは内部バッファのみで扱われ、⌘S で初めてディスクに触れます。
  • 比較を始めたあとでファイルがディスク上で変わったら、保存前に知らせます。
フォルダーマージは別です

フォルダーマージはその場でディスクを変えます。上書きの前に、既存の項目をゴミ箱へ移します。くわしくは次の節をご覧ください。

04フォルダーマージはその場で変える

フォルダー比較では、片側にしか無い項目を取り込めます。取り込みはその場でディスクを変えるため、次の点に注意してください。

  • 上書きの前に、既存の項目をゴミ箱へ移します。
  • 写し方は Finder と同じ(既定)/結合/置き換えから選べます。
  • ゴミ箱に入れた項目は Finder から戻せます。

05ファイルへのアクセス

Left Right は App Sandbox の中で動きます。触れるのは、利用者が開いた・選んだファイルとフォルダーだけです。

最近使った比較はブックマークで覚えます。ブックマークが失効しても項目を消さず、灰色で残します。灰色の項目にあるアクセスを許可…から、もう一度許可できます。

ファイルの移動・改名・外付けボリューム・OS 更新で、ブックマークは失効します。

06git から呼ぶ

Left Right は git difftool / git mergetool から呼べます。CLI の実行体は同梱していません。

  1. ヘルプ →「Git 連携…」を開きます。
  2. 表示されたコマンドを、コマンドをコピーで写します。
  3. ターミナルで実行します。

以後、git mergetool は競合を Left Right で開き、git difftool は変更を左右に並べて見せます。

Left Right を別のフォルダーへ移したら、ヘルプ →「Git 連携…」をもう一度開いて、コマンドを再実行してください。

競合が残っているあいだは保存できません

git はすべて解決したファイルしか受け付けません。結果に競合の印が残っているあいだは、git 経路での保存を止めます。

07いまはできないこと

次のものは 1.0.0 に入っていません。

  • 別名で保存
  • 旧い .xls 形式(.xlsx に保存し直してから開いてください)
  • パスワードで保護された .xlsx / .ods の比較(復号は行いません)
  • 独立したミニマップ(スクロールバー上の差分目盛りで代えます)
  • 左右をまとめた検索と置換(片側のペインの中ではできます)
  • 折り返し表示(対応行の水平揃えと両立しません)
  • 改行コードの一括変換(判定と維持だけを行います)
  • 3 フォルダー比較、書庫(ZIP 等)の比較、パッチの適用
  • 自動更新(アプリ内では更新しません)
  • CLI の同梱
  • Finder のクイックアクション、Finder Sync 拡張
  • 実行時プラグイン機構、利用者定義の配色テーマ、差分アルゴリズムの選択

08よくある質問

何を比べられますか。

2 つのテキストファイル、2 つのフォルダー、3 つのファイル(3-way マージ)、表(CSV / TSV と .xlsx / .ods / .numbers)、バイナリ、画像です。種類は自動で判定します。

保存するまで本当に書かない?

テキストの編集・塊の取り込み・3-way の結果は、保存するまでディスクへ書きません。⌘S で初めてディスクに触れます。フォルダーマージはその場でディスクを変えます。

上書きした項目は戻せる?

上書きの前に、既存の項目をゴミ箱へ移します。ゴミ箱に入れた項目は Finder から戻せます。

「アクセスを許可…」を求められたら?

最近使った比較のブックマークが失効したときです。項目は消えずに灰色で残っています。アクセスを許可…から、もう一度許可してください。

git から呼ぶには?

ヘルプ →「Git 連携…」に、ターミナルで実行するコマンドがあります。実行すれば、git mergetool と git difftool から Left Right を使えます。Left Right を別のフォルダーへ移したときは、同じ画面を開き直してコマンドを再実行してください。

.xls が開けない。

旧い .xls 形式には対応していません。.xlsx に保存し直してから開いてください。

パスワードで保護されたファイルが開けない。

暗号化された .xlsx / .ods は扱えません。パスワードを外してから開いてください。

更新はどうする?

Mac App Store 版はストアから自動で更新されます。DMG 版は自動では更新されません。ヘルプメニューの「Web で更新を確認…」で紹介ページを開き、新しい DMG を入手してください。設定は両方の版で共通なので、入れ替えても引き継がれます。

09お問い合わせ

ご質問・ご要望・不具合の報告はメールでお願いします。

メール: support@nambu.dev

プライバシーの扱いは、プライバシーポリシーにまとめています。

不具合の報告には、次があると原因に早く辿り着けます。

  • macOS のバージョン
  • Left Right のバージョン
  • どの画面で何をしたか
  • 画面に出たメッセージ(そのまま貼り付けてください)

Left Right サポート · 最終更新 2026年9月27日 · Shinichi Nambu · support@nambu.dev

SUPPORT · LEFT RIGHT

Support / FAQ

How to use Left Right, and answers to common questions. If you need more help, email us.

Left Right 1.0.0 was released on September 22, 2026, and is available on the Mac App Store.

App · Left Right Requires · macOS 27+ Last updated · September 27, 2026

01Requirements

  • macOS 27 or later on a Mac with Apple silicon
  • No network connection is needed — Left Right does not communicate over the network.
  • Download it from the Mac App Store, or download the DMG directly from the product page (signed with Developer ID and notarized by Apple).

02What You Can Compare

Left Right picks the comparison type automatically from the file’s type and contents. You never have to choose.

  • Two text files — side-by-side panes with corresponding lines aligned horizontally and synchronized scrolling. Line-level additions, deletions and changes, in-line highlights, hunk-by-hunk merge, and find in pane (⌘F).
  • Two folders — recursive scanning with a tree view (hierarchy or list). Compare modes: Smart, Contents, Metadata, Bytes.
  • Three files — a three-way merge with left, base and right. Separate changes merge automatically; overlapping changes stay in the result as git-compatible conflict markers.
  • Tables — CSV / TSV and .xlsx / .ods / .numbers side by side. Align columns by the header row and match rows by a key column.
  • Binary — hexadecimal, comparing the same offsets. A byte map and entropy strip on each side.
  • Images — six views: Side by Side, Overlay, Slider, Difference, Blink and Heat Map, plus a threshold.

03Nothing Is Written Until You Save

Text editing, hunk merges and the three-way result do not touch the disk until you save.

  • They live in memory only; ⌘S is the first moment the disk is touched.
  • If a file changes on disk after the comparison starts, you are told before saving.
Folder merge is different

Folder merge changes the disk as it runs. Existing items are moved to the Trash before an overwrite. See the next section for details.

04Folder Merge Changes the Disk

In a folder comparison, you can copy items that exist only on one side. The copy changes the disk as it runs, so keep these points in mind.

  • Existing items are moved to the Trash before an overwrite.
  • Copying can follow the Finder (default), merge, or replace.
  • Items in the Trash can be put back from the Finder.

05File Access

Left Right runs in the App Sandbox. It reaches only the files and folders you open or choose.

Recent comparisons are remembered as bookmarks. An expired bookmark is kept in gray rather than being dropped. Use Grant Access… on the gray item to grant access again.

Bookmarks expire when files are moved or renamed, on external volumes, or after an OS update.

06Calling Left Right from git

Left Right can be called from git difftool / git mergetool. No CLI is bundled.

  1. Open Help → “Git Integration…”.
  2. Use Copy commands to copy the commands shown.
  3. Run them in Terminal.

After that, git mergetool opens conflicts in Left Right, and git difftool shows changes side by side.

If you move Left Right to another folder, open Help → “Git Integration…” again and run the commands once more.

Saving is blocked while conflicts remain

git only accepts a fully resolved file. While conflict markers remain in the result, saving through the git path is stopped.

07Not in This Version

These are not included in 1.0.0.

  • Save As
  • The legacy .xls format (save it as .xlsx first)
  • Comparing password-protected .xlsx / .ods files (no decryption)
  • A separate minimap (the marks on the scroll bar cover the same ground)
  • Searching both sides at once and replacing across both sides (each pane can find and replace on its own)
  • Line wrapping (it cannot coexist with aligning corresponding lines)
  • Bulk conversion of line endings (they are detected and preserved only)
  • Three-folder comparison, archive (ZIP and similar) comparison, and applying patches
  • Automatic updates (the app does not update itself)
  • A bundled CLI
  • Finder Quick Actions and a Finder Sync extension
  • A runtime plug-in mechanism, user-defined color themes, and choosing the difference algorithm

08Frequently Asked Questions

What can I compare?

Two text files, two folders, three files (a three-way merge), tables (CSV / TSV and .xlsx / .ods / .numbers), binary files, and images. The type is detected automatically.

Does it really not write until I save?

Text editing, hunk merges and the three-way result do not touch the disk until you save. ⌘S is the first moment the disk is touched. Folder merge changes the disk as it runs.

Can I undo an overwrite?

Existing items are moved to the Trash before an overwrite. Items in the Trash can be put back from the Finder.

Why am I asked to “Grant Access…”?

A recent-comparison bookmark has expired. The item is kept in gray rather than being dropped. Use Grant Access… to grant access again.

How do I call Left Right from git?

Help → “Git Integration…” has commands you can paste into Terminal. Run them and both git mergetool and git difftool can use Left Right. If you move Left Right to another folder, open the same window again and run the commands once more.

A .xls file won’t open.

The legacy .xls format is not supported. Save it as .xlsx first.

A password-protected file won’t open.

Encrypted .xlsx / .ods files are not supported. Remove the password before opening them.

How do updates work?

The Mac App Store version updates through the App Store. The DMG version does not update automatically — choose Help → Check for Updates on the Web… to open the product page and download the latest DMG. Settings are shared between both versions, so switching keeps them.

09Contact & Reporting Bugs

Questions, requests and bug reports are welcome by email.

Email: support@nambu.dev

Privacy details are in the privacy policy.

A report gets to the cause faster with:

  • Your macOS version
  • The Left Right version
  • Which screen you were on and what you did
  • The message shown on screen, pasted verbatim

Left Right Support · Last updated September 27, 2026 · Shinichi Nambu · support@nambu.dev