duodiff

duodiff is a fast, cross-platform terminal user interface (TUI) directory comparison tool written in Rust.

Features

• Side-by-Side Tree View: Balanced, clean double-pane tree view aligning matched, differing, and missing folders/files.
• Asynchronous Scanner: Directory comparison and checksum calculations run in non-blocking background threads, keeping the TUI completely fluid and responsive.
• Vim Keys & Mouse Support: Navigable via arrow keys, hjkl, tab-focus switching, mouse clicks (double-click to open/expand), and synchronized mouse scrolling.
• Flexible Comparison Modes:
  • Fast mode: Compares file size and modification time.
  • Precise mode: Compares file contents using streaming MD5 checksums.
• Built-in Diff View: In-app read-only, color-coded side-by-side file contents diff viewer with synchronous scrolling.
• External Diff Tool & Editor: Configure and launch external diff tools (vim, nvim, code, meld, bcomp, smerge, ksdiff, difft) to compare differing file pairs, or open the selected file in your external editor (using $VISUAL or $EDITOR).
• Configuration Screen & Persistence: A built-in configuration UI to detect system-installed diff tools and save your selection to ~/.config/duodiff/config.toml.
• Right-Click Context Menu: Mouse context actions (Compare via Ext Diff Tool, Edit via Ext Editor, Edit Configuration, Cancel) by right-clicking on any tree item.

Installation

Unix-like (macOS / Linux / Windows Git Bash)

You can download and install the prebuilt binary using the following command:

curl -fsSL https://raw.githubusercontent.com/akunzai/duodiff/main/install.sh | bash

This script will automatically detect your OS and architecture, download and verify the checksum of the latest release binary, and install it to ~/.local/bin/.

Windows (PowerShell)

Run the following command in PowerShell:

irm https://raw.githubusercontent.com/akunzai/duodiff/main/install.ps1 | iex

This will download and verify the latest Windows release binary, install it to ~/.local/bin, and add the installation folder to your environment path.

Via Cargo Binstall

If you have cargo-binstall installed, you can install the prebuilt binary directly:

cargo binstall duodiff

Build from Source (Cargo)

If you have Rust and Cargo installed, you can build and run duodiff directly:

cargo run -- <left_directory_path> <right_directory_path>

Or install it from source:

cargo install --path .

Keyboard & Mouse Shortcuts