Installation

Install DuoBolt Desktop on macOS or Windows, or the free DuoBolt CLI on macOS, Windows, or Linux. Supported paths: Homebrew, Scoop, the Microsoft Store, or a direct binary download — all take under a minute.

• DuoBolt Desktop — full GUI app for macOS and Windows
• DuoBolt CLI — command-line version for power users and automation

Choose the install path you need:

Install DuoBolt Desktop Full GUI app for macOS and Windows

Install DuoBolt CLI Command-line version for automation

---

Prerequisites

DuoBolt Desktop

• macOS 11+ (Intel or Apple Silicon)
• Windows 10/11

DuoBolt CLI

• macOS, Windows, or Linux
• Terminal or PowerShell
• (Optional) A modern shell environment for scripting (bash/zsh/fish/PowerShell)

---

Install DuoBolt Desktop

macOS

1. Download the latest .dmg file from the Download page.

2. Open the image and drag DuoBolt.app into Applications.

3. Launch DuoBolt (you may need to approve it in System Settings → Privacy & Security).

4. Or install with Homebrew (optional):

   Homebrew

   brew tap rnine/duobolt
   brew install --cask duobolt-desktop

Windows

1. Open the Microsoft Store on your Windows device.

2. Search for DuoBolt and click Get or Install.

3. Launch DuoBolt from the Start menu or Microsoft Store.

---

Install DuoBolt CLI

macOS / Linux

1. Install with Homebrew (recommended):

   Homebrew

   brew tap rnine/duobolt
   brew install duobolt

2. Verify it works:

   Test CLI

   duobolt-cli --version

3. Or download the CLI binary (duobolt-cli) from the Download CLI section and move it into your PATH:

   Manual install

   sudo mv duobolt-cli /usr/local/bin/

Windows

1. Install with Scoop (recommended):

   Scoop

   scoop bucket add duobolt https://github.com/rnine/scoop-duobolt
   scoop install duobolt

2. Verify it works:

   Test CLI

   duobolt-cli --version

3. Or download the .exe binary and place it anywhere in your PATH, for example:

   Example location

   C:\Tools\duobolt-cli.exe

---

Verify Your Installation

Desktop

Open DuoBolt → Settings → About

You should see the version number and engine details.

CLI

Check CLI

duobolt-cli

Expected output (shows version and usage):

duobolt-cli v0.3.76 aarch64-apple-darwin (built: 1764327121)

Usage: duobolt-cli <directory> [options]
Options:
  --min-size=SIZE           Minimum file size (e.g., 10K, 2M, 1GiB)
  ...

---

First Steps

Desktop

1. Open DuoBolt

2. Select Add Folder

3. Choose a directory to scan

4. Click Scan

5. Review detected duplicates using the visual comparison panel

6. Select files to delete and confirm

Tip

DuoBolt will never delete files automatically — you always stay in control.

CLI

Run a quick scan:

Basic scan

duobolt-cli ~/Downloads

Find duplicates and output results as JSON:

JSON output

duobolt-cli ~/Documents --ignore-system-files --output=json > dupes.json

Limit hashing to specific file types:

Filter by extension

duobolt-cli ~/Music --only-ext=mp3,wav

---

What’s Next?

Desktop Guide Continue with the UI workflow

CLI Usage Learn automation and scripting

Core Concepts Understand how the engine works

Changelog See what changed recently