This script is used to Fix user share sub-folders that have been spread accross multiple disks to one disk.
This script was inspired and basedon the original unRAID diskmv script, it is HEAVLY modified from the original diskmv script by trinapicot. See: https://github.com/trinapicot/unraid-diskmv
If this script helps you keep your unRAID array tidy, please consider supporting its development!
A powerful bash script for managing and consolidating fragmented user shares across your unRAID array disks.
This script automates or facilitates the safe movement of files from fragmented shares (like TVSHOWS or MOVIES) to a single target disk/cache drive, optimizing disk usage and spin-down efficiency.
In an unRAID environment, user shares often become fragmented, with different parts of the same logical folder spread across multiple physical disks. consld8-auto solves this by safely moving all file fragments of a selected sub-folder (e.g., a specific TV show or movie folder) to a single, chosen destination disk using rsync with the --remove-source-files option for maximum safety and efficiency.
- Dual Operation Modes: Run in Interactive Mode for manual control, or Automatic Mode for fully optimized consolidation planning.
- Fully Automated Cron/Scheduler Support (New in v2.0.0): Use the new
-L <path>flag alongside-ato bypass all interactive prompts (Share Selection, Safety Margin, Verbosity), making it perfect for scheduling via the User Scripts plugin or cron. - Intelligent Planning (Auto Mode): The script scans fragmented folders and selects the optimal destination disk based on a tiered priority system:
- Safety Margin: Must meet a configurable minimum free space (default 200 GB) after the move.
- Existing Files: Prioritizes moving to the disk that already holds the largest fragment for that specific folder, reducing I/O and increasing the likelihood of successful spin-down.
- Free Space: Uses available free space as a tie-breaker.
- Dry Run/Test Mode: Default-enabled safety feature to simulate the entire move process without touching files.
- Safe Execution: Uses
rsync -avh --remove-source-filesto ensure the move completes before the source files are deleted.
This script is written in Bash and requires standard Linux tools available on the unRAID OS, including:
- Bash (v4.0 or higher is recommended)
findduanddfawkrsyncnumfmt(standard utility for human-readable size formatting)
-
SSH into your unRAID server.
-
Download the script:
wget [https://raw.githubusercontent.com/mejacobarussell/Auto-Consolidate-for-Unraid/refs/heads/main/consld8-2.0.0.sh](https://raw.githubusercontent.com/mejacobarussell/Auto-Consolidate-for-Unraid/refs/heads/main/consld8-2.0.0.sh) # Note: Ensure you download the latest version, or rename the file after download. -
Make the script executable:
chmod +x consld8-2.0.0.sh
-
(Optional but Recommended): Run it using the User Scripts plugin on unRAID for easier management.
The script defaults to Test Mode (Dry Run) for safety. Use the -f flag to enable actual file movement.
| Option | Description | Mode |
|---|---|---|
-h |
Display the usage information. | Both |
-t |
Test Mode (Dry Run). This is the default. No files will be moved. | Both |
-f |
Force Execution. Overrides test mode, and files will be moved. | Both |
-v |
Increase verbosity (recommended for Auto Mode planning). | Both |
-a |
FULL AUTOMATIC PLANNING MODE. Scans all folders, generates an optimized plan, and executes (if -f is also used). |
Auto |
-I |
INTERACTIVE MODE. Prompts you to select a specific folder and destination disk. | Interactive |
-L <path> |
REQUIRED for non-interactive execution with -a. Sets the base share path (e.g., /mnt/user/TVSHOWS) non-interactively, bypassing prompts. |
Auto |
Use this mode for granular control over one specific folder.
# Run in Interactive Mode and Dry Run (Default)
./consld8-2.0.0.sh -I
# Run in Interactive Mode and EXECUTE the move
./consld8-2.0.0.sh -I -f
