Merge pull request #486 from TRaSH-/Hardlinks-replace-copies-with-hardlinks

NEW: Replace copies with hardlinks

docs/Hardlinks/.pages

@@ -3,3 +3,4 @@ nav:
     - How-to-setup-for
     - Examples: Examples.md
     - Check if hardlinks are working: Check-if-hardlinks-are-working.md
+    - Replace copies with hardlinks: Replace-copies-with-hardlinks.md

docs/Hardlinks/Replace-copies-with-hardlinks.md

@@ -0,0 +1,44 @@
+# Replace copies with hardlinks
+
+You recently switched to a proper setup that supports Hardlinks and Instant Moves (Atomic-Moves).
+
+And you would like to replace copies with hardlinks ?
+
+If your Operating System supports it you could make use of [Jdupes](https://github.com/jbruchon/jdupes).
+
+## Usage
+
+!!! info ""
+    I won't cover every command :bangbang:
+
+    If you want to know what else [Jdupes](https://github.com/jbruchon/jdupes) can do please read the manual.
+
+!!! tip
+    This process can take a long time and a pretty big hit on your resources depending on how big your library is, I did notice the first time it takes longer then the second time. Not sure if this is a cache thing or something else.
+
+    - That's why I suggest to do it based on categories (Movies, TV, Music etc).
+    - I don't suggest to use this on a cloud based setup.
+
+```bash
+jdupes [options] DIR1 DIR2
+```
+
+This will do a dry run and summarize at the end.
+
+```bash
+jdupes -M -r "/data/torrents/movies/" "/data/media/movies"
+```
+
+This will hard link all duplicate files without prompting.
+
+```bash
+jdupes -L -r "/data/torrents/movies/" "/data/media/movies"
+```
+
+!!! bug ""
+    Windows allows a maximum of 1023 hard links per file
+
+!!! Warning
+    The `-Q` or `--quick` option only reads each file once, hashes it, and performs comparisons based solely on the hashes. There is a small but significant risk of a hash collision which is the purpose of the failsafe byte-for-byte comparison that this option explicitly bypasses. Do not use it on ANY data set for which any amount of data loss is unacceptable. You have been warned!
+
+--8<-- "includes/support.md"

mkdocs.yml

@@ -62,7 +62,6 @@ plugins:
         # Radarr old redirects
         Radarr/V3/How-to-importexport-Custom-Formats-and-truly-make-use-of-it.md: Radarr/Radarr-import-custom-formats.md
         Radarr/V3/Collection-of-Custom-Formats-for-RadarrV3.md: Radarr/Radarr-collection-of-custom-formats.md
-        #  Radarr redirects
         Radarr/V3/Radarr-collection-of-custom-formats.md: Radarr/Radarr-collection-of-custom-formats.md
         Radarr/V3/Radarr-import-custom-formats.md: Radarr/Radarr-import-custom-formats.md
         Radarr/V3/Radarr-Quality-Settings-File-Size.md: Radarr/Radarr-Quality-Settings-File-Size.md
@@ -74,16 +73,15 @@ plugins:
         Radarr/V3/Tips/Radarr-show-unknown-movie-items.md: Radarr/Tips/Radarr-show-unknown-movie-items.md
         # Sonarr old redirects
         Sonarr/V3/Remote-Path-Mappings-explained-for-Sonarr.md: Sonarr/Sonarr-remote-path-mapping.md
-        # Sonarr redirects
         Sonarr/V3/Sonarr-Quality-Settings-File-Size.md: Sonarr/Sonarr-Quality-Settings-File-Size.md
         Sonarr/V3/Sonarr-recommended-naming-scheme.md: Sonarr/Sonarr-recommended-naming-scheme.md
         Sonarr/V3/Sonarr-Release-Profile-RegEx.md: Sonarr/Sonarr-Release-Profile-RegEx.md
         Sonarr/V3/Sonarr-Release-Profile-RegEx-Anime.md: Sonarr/Sonarr-Release-Profile-RegEx-Anime.md
         Sonarr/V3/Sonarr-remote-path-mapping.md: Sonarr/Sonarr-remote-path-mapping.md
-        # Downloader redirects
+        # Downloader old redirects
         NZBGet/How-to-setup-NZBGet.md: Downloaders/NZBGet/Basic-Setup.md
         NZBGet/scripts/index.md: Downloaders/NZBGet/scripts/index.md
-        # Hardlinks redirects
+        # Hardlinks old redirects
         Misc/how-to-set-up-hardlinks-and-atomic-moves.md: Hardlinks/Hardlinks-and-Instant-Moves.md
         # Shortcuts redirects
         hardlinks.md: Hardlinks/Hardlinks-and-Instant-Moves.md
@@ -97,6 +95,7 @@ plugins:
         Golden-Rule.md: Misc/x265-4k.md
         show-unknown.md: Radarr/Tips/Radarr-show-unknown-movie-items.md
         merge-quality.md: Radarr/Tips/Merge-quality.md
+        jdupes.md: Hardlinks/Replace-copies-with-hardlinks.md
 theme:
   name: material
   custom_dir: overrides