iCloud Drive Bulk File Organizer

WHAT IT DOES

iCloud Drive Bulk File Organizer is a file management tool that streamlines the process of organizing multiple iCloud Drive files into folders. Instead of manually dragging each file or folder to a destination, or using the Move dialog repeatedly—a process that can be tedious when organizing many files—this script automates the entire workflow. It scans the current iCloud Drive folder page, identifies visible files and subfolders with their names and types, and presents them as a scrollable checklist. You can select individual files, use Select All/Deselect All toggles, enter a target folder name, optionally create the folder if it doesn't exist, and move all selected files to that folder in configurable batches. The tool handles the complete interaction sequence: selecting items, opening the Move dialog or context menu, entering the target folder name, and confirming the move. Real-time progress updates show how many files have been moved, and the list automatically refreshes after completion. This is ideal for iCloud Drive users who want to keep their files organized by project, category, or date.

WHERE IT RUNS

This script operates exclusively on iCloud Drive (*.icloud.com/*) as a userscript injected through the BotGentz extension. It runs within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify files and folders using iCloud Drive's selectors (.item-container, .file-item, .folder-item), extracts item names and types, and interacts with iCloud Drive's native UI controls—selection checkboxes, Move buttons, folder pickers, and confirm dialogs—to perform moves. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Navigate to any iCloud Drive folder containing files you want to organize.

2. Click the BotGentz extension icon and select "iCloud Drive Bulk File Organizer" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current folder for items.

4. Review the displayed items, showing file/folder names and type indicators (📁 for folders, 📄 for files).

5. Enter the target folder name in the "Target folder" field.

6. Toggle "Create folder if missing" to automatically create the target folder if it doesn't exist.

7. Click "Refresh Folders" to copy a list of existing folder names to your clipboard.

8. Adjust the "Batch size" number (default 3) to control how many files are moved per batch.

9. Toggle "Confirm before each batch" if you want a confirmation popup before each batch executes.

10. Check the boxes next to files you wish to move. Folders are automatically excluded from selection.

11. Click "Move to Folder" to begin. The script processes files in batches, shows progress, and handles errors.

12. After completion, the item list automatically refreshes showing your updated organization.

WHY IT WORKS WHERE OTHERS FAIL

Many iCloud Drive automation tools fail because they attempt to call Apple's internal API endpoints or rely on brittle DOM selectors that change with every iCloud UI update. This script takes a resilient approach: it locates the actual interactive DOM elements iCloud Drive renders—the selection checkboxes, the Move button, the folder picker input, and the confirm button—and triggers native click events and value changes on them, exactly as a human would. When moving files, the script selects each file, clicks the Move button (or uses the context menu), waits for the folder picker to appear, enters the target folder name, and confirms the move. It sets the folder name using both the native value setter and dispatches "input" and "change" events, ensuring iCloud Drive's JavaScript UI registers the update. Between operations, the script introduces controlled delays (300ms between actions and 500ms between batches) to mimic human interaction speed and avoid triggering Apple's rate limiting.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. iCloud Drive periodically updates its website layout and UI components; if the script stops working, an updated version may be released. The script moves selected files to the target folder; folders themselves are not moved. If the target folder doesn't exist and "Create folder if missing" is enabled, the script will attempt to create it (if supported by the UI). This script does not store, transmit, or process any of your iCloud Drive data outside your local browser. It does not access your password, hidden inputs, or file inputs. All file moves are performed through iCloud Drive's own authenticated session using the official user interface. Use responsibly and verify the target folder before moving multiple files.