Duplicate files plugin for Yazi file manager, leveraging jdupes for fast and efficient duplicate detection.

• 🔍 Fast Duplicate Detection - Uses jdupes for high-performance scanning
• 👁️ Visual Preview - See duplicates directly in Yazi with deletion markers
• 🧪 Dry Run Mode - Preview what will be deleted before applying changes
• ⚙️ Profile System - Define custom scanning or override profiles for different use cases
• 💾 Export Results - Save scan results to JSON or text files
• 🔒 Safe by Default - Confirmation required for destructive operations

• Yazi file manager (v25.5.31+)
• jdupes command-line tool

Using yazi package manager:

ya pkg add mshnwq/dupes

Using nix home-manager (nixpkgs): (recommended)

{ pkgs, ... }: {
  programs.yazi = {
    enable = true;
    plugins = {
      # jdupes is self contained within
      dupes = pkgs.yaziPlugins.dupes
    };
  };
}

Using nix home-manager (github):

{ pkgs, ... }: {
  home.packages = with pkgs; [ jdupes ];
  programs.yazi = {
    enable = true;
    plugins = {
      dupes = pkgs.fetchFromGitHub {
        owner = "mshnwq";
        repo = "dupes.yazi";
        rev = "4666b6f299c2257c011f622319ae97fab8adbabe";
        hash = "sha256-v9xuSY/i/trIHHbOPbijd0AmcUb2vufNL9BSjBE6+Vo=";
      };
    };
  };
}

Manual installation:

git clone https://github.com/mshnwq/dupes.yazi.git ~/.config/yazi/plugins/dupes.yazi

Configuration in ~/.config/yazi/init.lua:

require("dupes"):setup {
	-- Global settings
	save_op = false,        -- Save results to file by default
	-- auto_confirm = true, -- Skip confirmation for apply (use with caution!)
	
	profiles = {
		-- Interactive mode: recursively scan and display duplicates
		interactive = {
			args = { "-r" },
		},
		-- Apply mode: recursively scan and DELETE duplicates
		apply = {
			args = { "-r", "-N", "-d" },
			save_op = true,  -- Save results before deletion
		},
		-- Custom profile example (uncomment to use)
		-- custom = {
		-- 	args = { "-r", "-s", },  -- Your custom jdupes flags
		-- },
	},
}

Keybindings in ~/.config/yazi/keymap.toml:

[[manager.prepend_keymap]]
on = ["<A-J>", "i"]
run = "plugin dupes interactive"
desc = "Run dupes interactive"

[[manager.prepend_keymap]]
on = ["<A-J>", "o"]
run = "plugin dupes override"
desc = "Run dupes override"

[[manager.prepend_keymap]]
on = ["<A-J>", "d"]
run = "plugin dupes dry"
desc = "Run dupes dry"

[[manager.prepend_keymap]]
on = ["<A-J>", "a"]
run = "plugin dupes apply"
desc = "Run dupes apply"

# [[mgr.prepend_keymap]]
# on = ["<A-J>", "c"]
# run = "plugin dupes custom"
# desc = "Run dupes custom"

Scans for duplicates and displays them in Yazi. Safe to use - no files are deleted.

interactive = {
	args = { "-r" },  -- Recursive scan
}

Shows what would be deleted using the same settings as apply mode. Files marked 'X' will be deleted. The first file in each duplicate set is kept.

• Normal files: displayed normally (will be kept)
• Files marked 'X': will be deleted

DESTRUCTIVE OPERATION - Permanently deletes duplicate files.

apply = {
	args = { "-r", "-N", "-d" },
	save_op = true,  -- Saves results to dupes.json
}

Opens an input dialog where you can enter custom jdupes arguments for one-time scans.

Example inputs:

• -r -s - Recursive, follow symlinks

require("dupes"):setup {
	save_op = false,        -- Default: don't save results to file
	auto_confirm = false,   -- Default: prompt before deletion
	profiles = {
		-- Your profiles here
	},
}

Each profile can have:

profile_name = {
	args = { "-r", "-N" },  -- jdupes command arguments
	save_op = true,         -- Override global save_op for this profile
}

See jdupes --help for complete flag list.

shallow = {
	args = {},  -- No -r flag, current directory only
}

When save_op = true, results are saved to:

• dupes.json - JSON format
• dupes.txt - Text format (when destructive)

Files are saved in the current working directory.

This plugin is MIT-licensed. For more information check the LICENSE file.

• Yazi file manager
• jdupes for duplicate detection
• boydaihungst for help on Yazi's Discord channel

• jdupes Documentation
• Yazi Plugins