# clone-detect
♻️ A simple Python CLI tool to recursively detect duplicate files based on their content hash — not filenames.
## 🔍 Features
- Recursively scans directories
- Finds duplicates based on file **content**, not name or size
- CLI interface with options for dry-run and preview
- Lets you choose which copies to keep (coming soon)
## 🚀 Installation
To install the package after cloning:
```bash
pip install -e .
Or once uploaded to PyPI:
pip install clone-detect
usage:
clone-detect <directory> [--dry-run]
example:
clone-detect ./my_folder --dry-run
sample output:
clone-detect ./test_dupes --dry-run
Scanning ./test_dupes...
Duplicate group (hash=bbb2f10dc8c1b0e2cc367816797afd48fdc3777d6265cb6b8504169a80ddeedf):
[1] ./test_dupes/whitecat.mp4 (keep)
[2] ./test_dupes/catnew.mp4
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/clone-detect",
"name": "clone-detect",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "duplicate files, hash, dedupe, cleaner",
"author": "Naila",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b2/54/c8b1ac8cf931bfe47bd9862f25bb587391af81c0ebdc78f61fab77b2d597/clone_detect-0.1.tar.gz",
"platform": null,
"description": "# clone-detect\n\n\u267b\ufe0f A simple Python CLI tool to recursively detect duplicate files based on their content hash \u2014 not filenames.\n\n## \ud83d\udd0d Features\n\n- Recursively scans directories\n- Finds duplicates based on file **content**, not name or size\n- CLI interface with options for dry-run and preview\n- Lets you choose which copies to keep (coming soon)\n\n## \ud83d\ude80 Installation\n\nTo install the package after cloning:\n\n```bash\npip install -e .\n\nOr once uploaded to PyPI:\n\npip install clone-detect\n\nusage:\n\nclone-detect <directory> [--dry-run]\n\nexample: \n\nclone-detect ./my_folder --dry-run\n\nsample output:\n\nclone-detect ./test_dupes --dry-run\n\nScanning ./test_dupes...\n\nDuplicate group (hash=bbb2f10dc8c1b0e2cc367816797afd48fdc3777d6265cb6b8504169a80ddeedf):\n [1] ./test_dupes/whitecat.mp4 (keep)\n [2] ./test_dupes/catnew.mp4\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Find duplicate files by content hash",
"version": "0.1",
"project_urls": {
"Homepage": "https://github.com/yourusername/clone-detect"
},
"split_keywords": [
"duplicate files",
" hash",
" dedupe",
" cleaner"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "de919f8989d64e76ec77130da5bbbc14271314e36a1530f224a4501c95eda9dd",
"md5": "363a85e128c3a38a7b1403ceb178290c",
"sha256": "536a362bcf17c0e2ad2ff8745f48d6a76cbe779b6d474f875aa3f5911052176a"
},
"downloads": -1,
"filename": "clone_detect-0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "363a85e128c3a38a7b1403ceb178290c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 3779,
"upload_time": "2025-07-31T15:40:59",
"upload_time_iso_8601": "2025-07-31T15:40:59.874510Z",
"url": "https://files.pythonhosted.org/packages/de/91/9f8989d64e76ec77130da5bbbc14271314e36a1530f224a4501c95eda9dd/clone_detect-0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b254c8b1ac8cf931bfe47bd9862f25bb587391af81c0ebdc78f61fab77b2d597",
"md5": "3bf176ecbbce50d8718264c801722fb9",
"sha256": "28123a66ea05df11c370e1e4cdeea3ec1c79f485579eaa63db347017c9fc256e"
},
"downloads": -1,
"filename": "clone_detect-0.1.tar.gz",
"has_sig": false,
"md5_digest": "3bf176ecbbce50d8718264c801722fb9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 2873,
"upload_time": "2025-07-31T15:41:01",
"upload_time_iso_8601": "2025-07-31T15:41:01.341081Z",
"url": "https://files.pythonhosted.org/packages/b2/54/c8b1ac8cf931bfe47bd9862f25bb587391af81c0ebdc78f61fab77b2d597/clone_detect-0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 15:41:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "clone-detect",
"github_not_found": true,
"lcname": "clone-detect"
}
JSON
