github.com/artpar/rclone@v1.67.3/docs/content/commands/rclone_moveto.md (about) 1 --- 2 title: "rclone moveto" 3 description: "Move file or directory from source to dest." 4 slug: rclone_moveto 5 url: /commands/rclone_moveto/ 6 groups: Filter,Listing,Important,Copy 7 versionIntroduced: v1.35 8 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/moveto/ and as part of making a release run "make commanddocs" 9 --- 10 # rclone moveto 11 12 Move file or directory from source to dest. 13 14 ## Synopsis 15 16 17 If source:path is a file or directory then it moves it to a file or 18 directory named dest:path. 19 20 This can be used to rename files or upload single files to other than 21 their existing name. If the source is a directory then it acts exactly 22 like the [move](/commands/rclone_move/) command. 23 24 So 25 26 rclone moveto src dst 27 28 where src and dst are rclone paths, either remote:path or 29 /path/to/local or C:\windows\path\if\on\windows. 30 31 This will: 32 33 if src is file 34 move it to dst, overwriting an existing file if it exists 35 if src is directory 36 move it to dst, overwriting existing files if they exist 37 see move command for full details 38 39 This doesn't transfer files that are identical on src and dst, testing 40 by size and modification time or MD5SUM. src will be deleted on 41 successful transfer. 42 43 **Important**: Since this can cause data loss, test first with the 44 `--dry-run` or the `--interactive`/`-i` flag. 45 46 **Note**: Use the `-P`/`--progress` flag to view real-time transfer statistics. 47 48 49 ``` 50 rclone moveto source:path dest:path [flags] 51 ``` 52 53 ## Options 54 55 ``` 56 -h, --help help for moveto 57 ``` 58 59 60 ## Copy Options 61 62 Flags for anything which can Copy a file. 63 64 ``` 65 --check-first Do all the checks before starting transfers 66 -c, --checksum Check for changes with size & checksum (if available, or fallback to size only). 67 --compare-dest stringArray Include additional comma separated server-side paths during comparison 68 --copy-dest stringArray Implies --compare-dest but also copies files from paths into destination 69 --cutoff-mode HARD|SOFT|CAUTIOUS Mode to stop transfers when reaching the max transfer limit HARD|SOFT|CAUTIOUS (default HARD) 70 --ignore-case-sync Ignore case when synchronizing 71 --ignore-checksum Skip post copy check of checksums 72 --ignore-existing Skip all files that exist on destination 73 --ignore-size Ignore size when skipping use modtime or checksum 74 -I, --ignore-times Don't skip items that match size and time - transfer all unconditionally 75 --immutable Do not modify files, fail if existing files have been modified 76 --inplace Download directly to destination file instead of atomic download to temp/rename 77 --max-backlog int Maximum number of objects in sync or check backlog (default 10000) 78 --max-duration Duration Maximum duration rclone will transfer data for (default 0s) 79 --max-transfer SizeSuffix Maximum size of data to transfer (default off) 80 -M, --metadata If set, preserve metadata when copying objects 81 --modify-window Duration Max time diff to be considered the same (default 1ns) 82 --multi-thread-chunk-size SizeSuffix Chunk size for multi-thread downloads / uploads, if not set by filesystem (default 64Mi) 83 --multi-thread-cutoff SizeSuffix Use multi-thread downloads for files above this size (default 256Mi) 84 --multi-thread-streams int Number of streams to use for multi-thread downloads (default 4) 85 --multi-thread-write-buffer-size SizeSuffix In memory buffer size for writing when in multi-thread mode (default 128Ki) 86 --no-check-dest Don't check the destination, copy regardless 87 --no-traverse Don't traverse destination file system on copy 88 --no-update-dir-modtime Don't update directory modification times 89 --no-update-modtime Don't update destination modtime if files identical 90 --order-by string Instructions on how to order the transfers, e.g. 'size,descending' 91 --partial-suffix string Add partial-suffix to temporary file name when --inplace is not used (default ".partial") 92 --refresh-times Refresh the modtime of remote files 93 --server-side-across-configs Allow server-side operations (e.g. copy) to work across different configs 94 --size-only Skip based on size only, not modtime or checksum 95 --streaming-upload-cutoff SizeSuffix Cutoff for switching to chunked upload if file size is unknown, upload starts after reaching cutoff or when file ends (default 100Ki) 96 -u, --update Skip files that are newer on the destination 97 ``` 98 99 ## Important Options 100 101 Important flags useful for most commands. 102 103 ``` 104 -n, --dry-run Do a trial run with no permanent changes 105 -i, --interactive Enable interactive mode 106 -v, --verbose count Print lots more stuff (repeat for more) 107 ``` 108 109 ## Filter Options 110 111 Flags for filtering directory listings. 112 113 ``` 114 --delete-excluded Delete files on dest excluded from sync 115 --exclude stringArray Exclude files matching pattern 116 --exclude-from stringArray Read file exclude patterns from file (use - to read from stdin) 117 --exclude-if-present stringArray Exclude directories if filename is present 118 --files-from stringArray Read list of source-file names from file (use - to read from stdin) 119 --files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin) 120 -f, --filter stringArray Add a file filtering rule 121 --filter-from stringArray Read file filtering patterns from a file (use - to read from stdin) 122 --ignore-case Ignore case in filters (case insensitive) 123 --include stringArray Include files matching pattern 124 --include-from stringArray Read file include patterns from file (use - to read from stdin) 125 --max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off) 126 --max-depth int If set limits the recursion depth to this (default -1) 127 --max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off) 128 --metadata-exclude stringArray Exclude metadatas matching pattern 129 --metadata-exclude-from stringArray Read metadata exclude patterns from file (use - to read from stdin) 130 --metadata-filter stringArray Add a metadata filtering rule 131 --metadata-filter-from stringArray Read metadata filtering patterns from a file (use - to read from stdin) 132 --metadata-include stringArray Include metadatas matching pattern 133 --metadata-include-from stringArray Read metadata include patterns from file (use - to read from stdin) 134 --min-age Duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off) 135 --min-size SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off) 136 ``` 137 138 ## Listing Options 139 140 Flags for listing directories. 141 142 ``` 143 --default-time Time Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z) 144 --fast-list Use recursive list if available; uses more memory but fewer transactions 145 ``` 146 147 See the [global flags page](/flags/) for global options not listed here. 148 149 # SEE ALSO 150 151 * [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends. 152