Skip to content

Commit 4a901b2

Browse files
Update README.md
1 parent 73e1038 commit 4a901b2

1 file changed

Lines changed: 89 additions & 1 deletion

File tree

README.md

Lines changed: 89 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,90 @@
1-
# MediaFileDuplicateFinder
1+
# Media File Duplicate Finder Ver 0.030 (Beta)
2+
[![All Releases](https://img.shields.io/github/downloads/David-Maisonave/MediaFileDuplicateFinder/total.svg)](https://github.com/David-Maisonave/MediaFileDuplicateFinder/releases/latest)
3+
24
Media File Duplicate Finder finds duplicated video, images, and audio files based on similarity. It can finds duplicates which have different resolution, frame rate, watermark, and video file tags.
5+
6+
This fork from [0x90d/videoduplicatefinder](https://github.com/0x90d/videoduplicatefinder), has more features and the UI (user interface) has a more standard interface which makes it more intuitive.
7+
# Features
8+
These features are not on the original base fork, and they're only include in **Media File Duplicate Finder**.
9+
- Only delete files which match the filters.
10+
- The original fork [0x90d/videoduplicatefinder](https://github.com/0x90d/videoduplicatefinder), all actions apply to filtered out items as well as viewable items. It makes it easy for a user to unintentionally delete many files.
11+
- Media File Duplicate Finder does **NOT** delete files which are filtered out.
12+
- Remember window size and location from last running instance.
13+
- On program startup, sets the window size and position from the previous running instance.
14+
- Has logic to reset the window position and size by holding down the shift key during the first few seconds of startup. The reset option may be needed for the following situations.
15+
- Change in quantity of monitors
16+
- Change in monitor resolutions
17+
- Corrupt Window settings between running instances
18+
- [Windows Only] Exclude Hard Links (hardlinks) option which is more reliable and better optimized compared to VDF.
19+
- The exclude hard links option works on all NTFS drive configurations, where-as VDF fails to work on some NTFS configurations.
20+
- Windows Installer (MSI package), which includes ffmpeg binaries.
21+
- Save on exit option has the following options:
22+
- Save_Aways
23+
- Never_Save
24+
- Prompt_to_Save.
25+
- Stream line menu having one toolbar (vs 2) which gives user more real-estate to view scan results.
26+
- Swap file name options. Renames two files in a group, by swapping names.
27+
- Select swap option. On groups with more than 2 files, allows user to select which files to swap names.
28+
- Full scan option. Deletes content in the database before running a scan. Waring: No prompt given with this option.
29+
- Run Clean Scan option. Before running the scan, removes database entries for files which no longer exists or failed on ffmpeg/ffprobe.
30+
- Checkbox for show thumbnails option on main toolbar next to Zoom Thumbnails.
31+
- Select duplicates with shorter file names.
32+
### Future features
33+
- Download release with all the required binaries needed to run the program. The original fork excludes some binaries.
34+
- Option to remove rescan prompt.
35+
- Search Directories listed on main window.
36+
- Option to clear the filters
37+
- Command line options which can be used to schedule a scan and perform action.
38+
39+
# Base Fork Description
40+
## Features
41+
- Finds duplicate videos / images based on similarity
42+
- Fast scanning speed
43+
- Cross-platform: Windows, Linux and MacOS GUI
44+
45+
## Binaries
46+
47+
[Daily build](https://github.com/0x90d/videoduplicatefinder/releases/tag/3.0.x) (You need to download FFmpeg and FFprobe yourself, see below! Please note the attachments of this release are automatically created and replaced on every new commit.)
48+
49+
50+
## Requirements
51+
52+
### FFmpeg:
53+
54+
#### Windows user:
55+
- The MSI package contains and installs the ffmpeg binaries.
56+
- If using the zip file, get the latest package from https://ffmpeg.org/download.html, and extract ffmpeg and ffprobe into the same directory of VDF.GUI.dll.
57+
58+
#### Linux user:
59+
- Installing ffmpeg:
60+
```
61+
sudo apt-get update
62+
sudo apt-get install ffmpeg
63+
```
64+
Open terminal in VDF folder and execute `./VDF.GUI`
65+
You may need to set execute permission first `sudo chmod 777 VDF.GUI`
66+
67+
#### MacOS user:
68+
- Install ffmpeg / ffprobe using homebrew
69+
70+
Open terminal in VDF folder and execute `./VDF.GUI` or if you have .NET installed `dotnet VDF.GUI.dll`
71+
You may get a permission error. Open system settings of your Mac, go to `Privacy & Security` and then `Developer Tools`. Now add `Terminal` to the list.
72+
73+
## Screenshots (slightly outdated)
74+
<img src="https://user-images.githubusercontent.com/46010672/129763067-8855a538-4a4f-4831-ac42-938eae9343bd.png" width="510">
75+
76+
## License
77+
- Media File Duplicate Finder is licensed under GPLv3
78+
- ffmpeg & ffprobe are licensed under LGPL 2.1 / GPL v2
79+
- ffmpeg binaries are only included in the Windows MSI package.
80+
- If using zip file or when using other platform packages, use instructions in [FFmpeg](README.md#FFmpeg)
81+
82+
83+
## Building
84+
- .NET Core 6.x
85+
- Visual Studio 2022
86+
- Avalonia VS Extension is recommended but not required
87+
88+
## Committing
89+
- Your pull request should only contain code for a single addition or fix
90+
- Unless it refers to an existing issue, write into your pull request what it does

0 commit comments

Comments
 (0)