Skip to content

Commit 11c6229

Browse files
authored
Update README.md
1 parent 063798b commit 11c6229

File tree

1 file changed

+41
-1
lines changed

1 file changed

+41
-1
lines changed

README.md

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,42 @@
11
# SameFile
2-
Easily find duplicate files on your disk
2+
This tool can be used to easily find duplicate files on your disk and save info about them to file.
3+
## How it works
4+
SameFile does not care about file names and extensions, the only thing matters here is files' content. The tool recursively walks over user-specified directory and uses ```md5sum``` from ```coreutils``` to calculate MD5 of each file found. Equal MD5 sums of two or more files means equal content of these files. Those are called duplicates. SameFile finds duplicate files on your disk and writes their paths to the text file.
5+
## Requirements
6+
- bash
7+
- coreutils
8+
## Installation
9+
- Download ```SameFile.sh``` file from this repository
10+
- Run ```chmod +x SameFile.sh``` to make it executable
11+
## Usage
12+
You can retrieve usage info anytime using ```--help```:
13+
```
14+
$ ./SameFile.sh --help
15+
SameFile v1.0 by MasterDevX
16+
Made in Ukraine
17+
18+
Usage:
19+
./SameFile.sh <path> <output>
20+
21+
path - Derectory to analyze.
22+
output - Output file with results.
23+
24+
```
25+
#### Example of usage
26+
```
27+
$ ./SameFile.sh /home/user/Documents/ duplicates.txt
28+
```
29+
The command above will search for duplicate files in ```/home/user/Documents/```. If SameFile will find any, it will create file ```duplicates.txt``` and save search results there.
30+
#### Example of generated results file
31+
```
32+
1. c3b356ffe522cfcf9098641d3733922e [ 9,1M ]
33+
/home/user/Documents/Records/Video.mp4
34+
/home/user/Documents/SD/Video.mp4
35+
/home/user/Documents/August 2021/VID_0232.mp4
36+
37+
2. c88663bc1853d2cfa69d1ccb3371cc31 [ 4,6M ]
38+
/home/user/Documents/Charts/12.png
39+
/home/user/Documents/Archives/Charts/Archived_12.png
40+
41+
```
42+
You can see that SameFile has generated text file containing enumerated list of all duplicate files in given directory. The header of each list entry has MD5 sum of duplicate file and it's size, below are paths to identical files.

0 commit comments

Comments
 (0)