From 28bfaeca110c2bf164f1d9f1c37ef267a14030c2 Mon Sep 17 00:00:00 2001 From: TRaSH Date: Mon, 12 Aug 2024 20:26:34 +0200 Subject: [PATCH] feat(guide): jdupes improve descriptions (#2035) * feat(guide): jdupes improve descriptions * Apply suggestions from code review Thnx Co-authored-by: yammes08 <111231042+yammes08@users.noreply.github.com> --------- Co-authored-by: yammes08 <111231042+yammes08@users.noreply.github.com> --- .../Replace-copies-with-hardlinks.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/Hardlinks/Replace-copies-with-hardlinks.md b/docs/Hardlinks/Replace-copies-with-hardlinks.md index 8c1e97f96..34cbd2e5e 100644 --- a/docs/Hardlinks/Replace-copies-with-hardlinks.md +++ b/docs/Hardlinks/Replace-copies-with-hardlinks.md @@ -1,8 +1,6 @@ # 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 ? +Have you recently switched to a setup that supports hardlinks and Instant Moves (Atomic-Moves), and would like to replace duplicate files with hardlinks? If your Operating System supports it you could make use of [Jdupes](https://codeberg.org/jbruchon/jdupes). @@ -18,31 +16,33 @@ If your Operating System supports it you could make use of [Jdupes](https://code This process can take a long time and a pretty big hit on your resources depending on the size of your library. We did notice the first time can take longer than the second time, this may be due to some sort of caching behavior on disk. - - That's why we suggest doing it based on categories (Movies, TV, Music etc). + - That's why we suggest doing it based on categories (Movies, TV, Music, etc). - We don't suggest using this on a cloud-based setup. ```bash jdupes [options] DIR1 DIR2 ``` -This will do a dry run and summarize at the end. +Example: This will do a dry run and summarize at the end. ```bash -jdupes -rMX onlyext:mp4,mkv,avi "/data/torrents/movies/" "/data/media/movies" +jdupes -rMX onlyext:mp4,mkv,avi "/mnt/user/data/torrents/movies/" "/mnt/user/data/media/movies" ``` -This will hard link all duplicate files without prompting. +!!! info "Folder paths should be changed to match what you're using in your setup" + +Example: This will hard link all duplicate files without prompting. ```bash -jdupes -rLX onlyext:mp4,mkv,avi "/data/torrents/movies/" "/data/media/movies" +jdupes -rLX onlyext:mp4,mkv,avi "/mnt/user/data/torrents/movies/" "/mnt/user/data/media/movies" ``` -!!! bug "" +!!! info "Folder paths should be changed to match what you're using in your setup" - Windows allows a maximum of 1023 hard links per file +--- -!!! Warning +!!! bug "Windows allows a maximum of 1023 hard links per file" - 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! +!!! 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!" {! include-markdown "../../includes/support.md" !}