"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files
Go azure-blobazure-blob-storageazure-filesbackblaze-b2cloud-storagedropboxencryptionftpfuse-filesystemgogolanggoogle-cloud-storagegoogle-driveonedriveopenstack-swiftrclones3sftpsyncwebdav
docs: change syntax hightlighting for command examples from sh to console
albertony059ad47336b5
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 4a75f8975..46fe8881b 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -38,7 +38,7 @@ and [email](https://docs.github.com/en/github/setting-up-and-managing-your-githuNext open your terminal, change directory to your preferred folder and initialiseyour local rclone project:-```sh+```consolegit clone https://github.com/rclone/rclone.gitcd rclonegit remote rename origin upstream@@ -53,13 +53,13 @@ executed from the rclone folder created above.Now [install Go](https://golang.org/doc/install) and verify your installation:-```sh+```consolego version```Great, you can now compile and execute your own version of rclone:-```sh+```consolego build./rclone version```@@ -68,7 +68,7 @@ go buildmore accurate version number in the executable as well as enable you to specifymore build options.) Finally make a branch to add your new feature-```sh+```consolegit checkout -b my-new-feature```@@ -80,7 +80,7 @@ and a quick view on the rclone [code organisation](#code-organisation).When ready - test the affected functionality and run the unit tests for thecode you changed-```sh+```consolecd folder/with/changed/filesgo test -v```@@ -99,7 +99,7 @@ Make sure youWhen you are done with that push your changes to GitHub:-```sh+```consolegit push -u origin my-new-feature```@@ -119,7 +119,7 @@ or [squash your commits](#squashing-your-commits).Follow the guideline for [commit messages](#commit-messages) and then:-```sh+```consolegit checkout my-new-feature # To switch to your branchgit status # To see the new and changed filesgit add FILENAME # To select FILENAME for the commit@@ -130,7 +130,7 @@ git log # To verify the commit. Use q to quit the logYou can modify the message or changes in the latest commit using:-```sh+```consolegit commit --amend```@@ -145,7 +145,7 @@ pushed to GitHub.Your previously pushed commits are replaced by:-```sh+```consolegit push --force origin my-new-feature```@@ -154,7 +154,7 @@ git push --force origin my-new-featureTo base your changes on the latest version of the[rclone master](https://github.com/rclone/rclone/tree/master) (upstream):-```sh+```consolegit checkout mastergit fetch upstreamgit merge --ff-only@@ -170,7 +170,7 @@ If you rebase commits that have been pushed to GitHub, then you will have toTo combine your commits into one commit:-```sh+```consolegit log # To count the commits to squash, e.g. the last 2git reset --soft HEAD~2 # To undo the 2 latest commitsgit status # To check everything is as expected@@ -178,13 +178,13 @@ git status # To check everything is as expectedIf everything is fine, then make the new combined commit:-```sh+```consolegit commit # To commit the undone commits as one```otherwise, you may roll back using:-```sh+```consolegit reflog # To check that HEAD{1} is your previous stategit reset --soft 'HEAD@{1}' # To roll back to your previous state```@@ -219,13 +219,13 @@ to check an error return).rclone's tests are run from the go testing framework, so at the toplevel you can run this to run all the tests.-```sh+```consolego test -v ./...```You can also use `make`, if supported by your platform-```sh+```consolemake quicktest```@@ -246,7 +246,7 @@ need to make a remote called `TestDrive`.You can then run the unit tests in the drive directory. These testsare skipped if `TestDrive:` isn't defined.-```sh+```consolecd backend/drivego test -v```@@ -255,7 +255,7 @@ You can then run the integration tests which test all of rclone'soperations. Normally these get run against the local file system,but they can be run against any of the remotes.-```sh+```consolecd fs/syncgo test -v -remote TestDrive:go test -v -remote TestDrive: -fast-list@@ -268,7 +268,7 @@ If you want to use the integration test framework to run these testsaltogether with an HTML report and test retries then from theproject root:-```sh+```consolego install github.com/rclone/rclone/fstest/test_alltest_all -backends drive```@@ -278,14 +278,14 @@ test_all -backends driveIf you want to run all the integration tests against all the remotes,then change into the project root and run-```sh+```consolemake checkmake test```The commands may require some extra go packages which you can install with-```sh+```consolemake build_dep```@@ -478,7 +478,7 @@ To add a dependency `github.com/ncw/new_dependency` see theinstructions below. These will fetch the dependency and add it to`go.mod` and `go.sum`.-```sh+```consolego get github.com/ncw/new_dependency```@@ -492,7 +492,7 @@ and `go.sum` in the same commit as your other changes.If you need to update a dependency then run-```sh+```consolego get golang.org/x/crypto```diff --git a/RELEASE.md b/RELEASE.mdindex 9ca71989d..4bc50f6f3 100644--- a/RELEASE.md+++ b/RELEASE.md@@ -60,7 +60,7 @@ If `make updatedirect` added a `toolchain` directive then remove it.We don't want to force a toolchain on our users. Linux packagers areoften using a version of Go that is a few versions out of date.-```sh+```consolego list -m -f '{{if not (or .Main .Indirect)}}{{.Path}}{{end}}' all > /tmp/potential-upgradesgo get -d $(cat /tmp/potential-upgrades)go mod tidy -go=1.22 -compat=1.22@@ -70,7 +70,7 @@ If the `go mod tidy` fails use the output from it to remove thepackage which can't be upgraded from `/tmp/potential-upgrades` whendone-```sh+```consolegit co go.mod go.sum```@@ -102,7 +102,7 @@ The above procedure will not upgrade major versions, so v2 to v3.However this tool can show which major versions might need to beupgraded:-```sh+```consolego run github.com/icholy/gomajor@latest list -major```@@ -112,7 +112,7 @@ Expect API breakage when updating major versions.At some point after the release run-```sh+```consolebin/tidy-beta v1.55```@@ -159,7 +159,7 @@ which is a private repo containing artwork from sponsors.Create an update website branch based off the last release-```sh+```consolegit co -b update-website```@@ -167,19 +167,19 @@ If the branch already exists, double check there are no commits that need savingNow reset the branch to the last release-```sh+```consolegit reset --hard v1.64.0```Create the changes, check them in, test with `make serve` then-```sh+```consolemake upload_test_website```Check out <https://test.rclone.org> and when happy-```sh+```consolemake upload_website```@@ -189,14 +189,14 @@ Cherry pick any changes back to master and the stable branch if it is active.To do a basic build of rclone's docker image to debug builds locally:-```sh+```consoledocker buildx build --load -t rclone/rclone:testing --progress=plain .docker run --rm rclone/rclone:testing version```To test the multipatform build-```sh+```consoledocker buildx build -t rclone/rclone:testing --progress=plain --platform linux/amd64,linux/386,linux/arm64,linux/arm/v7,linux/arm/v6 .```@@ -204,6 +204,6 @@ To make a full build then set the tags correctly and add `--push`Note that you can't only build one architecture - you need to build them all.-```sh+```consoledocker buildx build --platform linux/amd64,linux/386,linux/arm64,linux/arm/v7,linux/arm/v6 -t rclone/rclone:1.54.1 -t rclone/rclone:1.54 -t rclone/rclone:1 -t rclone/rclone:latest --push .```diff --git a/cmd/backend/backend.go b/cmd/backend/backend.goindex 1780dd36b..4c5591051 100644--- a/cmd/backend/backend.go+++ b/cmd/backend/backend.go@@ -37,7 +37,7 @@ see the backend docs for definitions.You can discover what commands a backend implements by using-` + "```sh" + `+` + "```console" + `rclone backend help remote:rclone backend help <backendname>` + "```" + `@@ -46,19 +46,19 @@ You can also discover information about the backend using (see[operations/fsinfo](/rc/#operations-fsinfo) in the remote control docsfor more info).-` + "```sh" + `+` + "```console" + `rclone backend features remote:` + "```" + `Pass options to the backend command with -o. This should be key=value or key, e.g.:-` + "```sh" + `+` + "```console" + `rclone backend stats remote:path stats -o format=json -o long` + "```" + `Pass arguments to the backend by placing them on the end of the line-` + "```sh" + `+` + "```console" + `rclone backend cleanup remote:path file1 file2 file3` + "```" + `diff --git a/cmd/copyto/copyto.go b/cmd/copyto/copyto.goindex 85a533d00..ea38819e3 100644--- a/cmd/copyto/copyto.go+++ b/cmd/copyto/copyto.go@@ -35,7 +35,7 @@ name. If the source is a directory then it acts exactly like theSo-` + "```sh" + `+` + "```console" + `rclone copyto src dst` + "```" + `diff --git a/cmd/cryptcheck/cryptcheck.go b/cmd/cryptcheck/cryptcheck.goindex 13360d512..164bd28c2 100644--- a/cmd/cryptcheck/cryptcheck.go+++ b/cmd/cryptcheck/cryptcheck.go@@ -37,14 +37,14 @@ checksum of the file it has just encrypted.Use it like this-` + "```sh" + `+` + "```console" + `rclone cryptcheck /path/to/files encryptedremote:path` + "```" + `You can use it like this also, but that will involve downloading allthe files in ` + "`remote:path`" + `.-` + "```sh" + `+` + "```console" + `rclone cryptcheck remote:path encryptedremote:path` + "```" + `diff --git a/cmd/cryptdecode/cryptdecode.go b/cmd/cryptdecode/cryptdecode.goindex 56acf8fe6..133f01ec7 100644--- a/cmd/cryptdecode/cryptdecode.go+++ b/cmd/cryptdecode/cryptdecode.go@@ -34,7 +34,7 @@ If you supply the ` + "`--reverse`" + ` flag, it will return encrypted file nameuse it like this-` + "```sh" + `+` + "```console" + `rclone cryptdecode encryptedremote: encryptedfilename1 encryptedfilename2rclone cryptdecode --reverse encryptedremote: filename1 filename2` + "```" + `diff --git a/cmd/dedupe/dedupe.go b/cmd/dedupe/dedupe.goindex 9905004c3..6ab1546fa 100644--- a/cmd/dedupe/dedupe.go+++ b/cmd/dedupe/dedupe.go@@ -68,7 +68,7 @@ Here is an example run.Before - with duplicates-` + "```sh" + `+` + "```console" + `$ rclone lsl drive:dupes6048320 2016-03-05 16:23:16.798000000 one.txt6048320 2016-03-05 16:23:11.775000000 one.txt@@ -81,7 +81,7 @@ $ rclone lsl drive:dupesNow the ` + "`dedupe`" + ` session-` + "```sh" + `+` + "```console" + `$ rclone dedupe drive:dupes2016/03/05 16:24:37 Google drive root 'dupes': Looking for duplicates using interactive mode.one.txt: Found 4 files with duplicate names@@ -111,7 +111,7 @@ two-3.txt: renamed from: two.txtThe result being-` + "```sh" + `+` + "```console" + `$ rclone lsl drive:dupes6048320 2016-03-05 16:23:16.798000000 one.txt564374 2016-03-05 16:22:52.118000000 two-1.txt@@ -135,13 +135,13 @@ or by using an extra parameter with the same valueFor example, to rename all the identically named photos in your Google Photosdirectory, do-` + "```sh" + `+` + "```console" + `rclone dedupe --dedupe-mode rename "drive:Google Photos"` + "```" + `Or-` + "```sh" + `+` + "```console" + `rclone dedupe rename "drive:Google Photos"` + "```",Annotations: map[string]string{diff --git a/cmd/genautocomplete/genautocomplete_bash.go b/cmd/genautocomplete/genautocomplete_bash.goindex 28f9a1b59..7d1d26cd3 100644--- a/cmd/genautocomplete/genautocomplete_bash.go+++ b/cmd/genautocomplete/genautocomplete_bash.go@@ -20,13 +20,13 @@ var bashCommandDefinition = &cobra.Command{By default, when run without any arguments,-` + "```sh" + `+` + "```console" + `rclone completion bash` + "```" + `the generated script will be written to-` + "```sh" + `+` + "```console" + `/etc/bash_completion.d/rclone` + "```" + `@@ -43,7 +43,7 @@ can logout and login again to use the autocompletion script.Alternatively, you can source the script directly-` + "```sh" + `+` + "```console" + `. /path/to/my_bash_completion_scripts/rclone` + "```" + `diff --git a/cmd/genautocomplete/genautocomplete_fish.go b/cmd/genautocomplete/genautocomplete_fish.goindex 20191b759..19d27a366 100644--- a/cmd/genautocomplete/genautocomplete_fish.go+++ b/cmd/genautocomplete/genautocomplete_fish.go@@ -21,14 +21,14 @@ var fishCommandDefinition = &cobra.Command{This writes to /etc/fish/completions/rclone.fish by default so willprobably need to be run with sudo or as root, e.g.-` + "```sh" + `+` + "```console" + `sudo rclone completion fish` + "```" + `Logout and login again to use the autocompletion scripts, or sourcethem directly-` + "```sh" + `+` + "```console" + `. /etc/fish/completions/rclone.fish` + "```" + `diff --git a/cmd/genautocomplete/genautocomplete_powershell.go b/cmd/genautocomplete/genautocomplete_powershell.goindex 7ce27657f..19b254b39 100644--- a/cmd/genautocomplete/genautocomplete_powershell.go+++ b/cmd/genautocomplete/genautocomplete_powershell.go@@ -20,7 +20,7 @@ var powershellCommandDefinition = &cobra.Command{To load completions in your current shell session:-` + "```sh" + `+` + "```console" + `rclone completion powershell | Out-String | Invoke-Expression` + "```" + `diff --git a/cmd/genautocomplete/genautocomplete_zsh.go b/cmd/genautocomplete/genautocomplete_zsh.goindex e60589083..3df4dc738 100644--- a/cmd/genautocomplete/genautocomplete_zsh.go+++ b/cmd/genautocomplete/genautocomplete_zsh.go@@ -21,14 +21,14 @@ var zshCommandDefinition = &cobra.Command{This writes to /usr/share/zsh/vendor-completions/_rclone by default so willprobably need to be run with sudo or as root, e.g.-` + "```sh" + `+` + "```console" + `sudo rclone completion zsh` + "```" + `Logout and login again to use the autocompletion scripts, or sourcethem directly-` + "```sh" + `+` + "```console" + `autoload -U compinit && compinit` + "```" + `diff --git a/cmd/gitannex/gitannex.md b/cmd/gitannex/gitannex.mdindex 6e3fd33e3..5612c40ac 100644--- a/cmd/gitannex/gitannex.md+++ b/cmd/gitannex/gitannex.md@@ -11,11 +11,14 @@ users.name. This symlink helps git-annex tell rclone it wants to run the "gitannex"subcommand.- ```sh- # Create the helper symlink in "$HOME/bin".+ Create the helper symlink in "$HOME/bin":++ ```consoleln -s "$(realpath rclone)" "$HOME/bin/git-annex-remote-rclone-builtin"- # Verify the new symlink is on your PATH.+ Verify the new symlink is on your PATH:++ ```consolewhich git-annex-remote-rclone-builtin```@@ -27,11 +30,15 @@ users.Start by asking git-annex to describe the remote's available configurationparameters.- ```sh- # If you skipped step 1:+ If you skipped step 1:++ ```consolegit annex initremote MyRemote type=rclone --whatelse+ ```++ If you created a symlink in step 1:- # If you created a symlink in step 1:+ ```consolegit annex initremote MyRemote type=external externaltype=rclone-builtin --whatelse```@@ -47,7 +54,7 @@ users.be one configured in your rclone.conf file, which can be located with `rcloneconfig file`.- ```sh+ ```consolegit annex initremote MyRemote \type=external \externaltype=rclone-builtin \@@ -61,7 +68,7 @@ users.remote**. This command is very new and has not been tested on many rclonebackends. Caveat emptor!- ```sh+ ```consolegit annex testremote MyRemote```diff --git a/cmd/hashsum/hashsum.go b/cmd/hashsum/hashsum.goindex 4d024f9d8..f0caca9cb 100644--- a/cmd/hashsum/hashsum.go+++ b/cmd/hashsum/hashsum.go@@ -103,13 +103,13 @@ as a relative path).Run without a hash to see the list of all supported hashes, e.g.-` + "```sh" + `+` + "```console" + `$ rclone hashsum` + hash.HelpString(0) + "```" + `Then-` + "```sh" + `+` + "```console" + `rclone hashsum MD5 remote:path` + "```" + `diff --git a/cmd/link/link.go b/cmd/link/link.goindex aa65d11b8..bb9f9bb9f 100644--- a/cmd/link/link.go+++ b/cmd/link/link.go@@ -29,7 +29,7 @@ var commandDefinition = &cobra.Command{Short: `Generate public link to file/folder.`,Long: `Create, retrieve or remove a public link to the given file or folder.-` + "```sh" + `+` + "```console" + `rclone link remote:path/to/filerclone link remote:path/to/folder/rclone link --unlink remote:path/to/folder/diff --git a/cmd/ls/ls.go b/cmd/ls/ls.goindex b850762de..915d87de6 100644--- a/cmd/ls/ls.go+++ b/cmd/ls/ls.go@@ -23,7 +23,7 @@ readable format with size and path. Recurses by default.E.g.-` + "```sh" + `+` + "```console" + `$ rclone ls swift:bucket60295 bevajer5jef90613 canolediff --git a/cmd/lsd/lsd.go b/cmd/lsd/lsd.goindex 355a4a6f2..6a8c23189 100644--- a/cmd/lsd/lsd.go+++ b/cmd/lsd/lsd.go@@ -34,7 +34,7 @@ not), the modification time (if known, the current time if not), thenumber of objects in the directory (if known, -1 if not) and the nameof the directory, E.g.-` + "```sh" + `+` + "```console" + `$ rclone lsd swift:494000 2018-04-26 08:43:20 10000 10000files65 2018-04-26 08:43:20 1 1File@@ -42,7 +42,7 @@ $ rclone lsd swift:Or-` + "```sh" + `+` + "```console" + `$ rclone lsd drive:test-1 2016-10-17 17:41:53 -1 1000files-1 2017-01-03 14:40:54 -1 2500filesdiff --git a/cmd/lsf/lsf.go b/cmd/lsf/lsf.goindex 38e79d62a..03a7d9f0c 100644--- a/cmd/lsf/lsf.go+++ b/cmd/lsf/lsf.go@@ -54,7 +54,7 @@ one per line. The directories will have a / suffix.E.g.-` + "```sh" + `+` + "```console" + `$ rclone lsf swift:bucketbevajer5jefcanole@@ -85,7 +85,7 @@ So if you wanted the path, size and modification time, you would useE.g.-` + "```sh" + `+` + "```console" + `$ rclone lsf --format "tsp" swift:bucket2016-06-25 18:55:41;60295;bevajer5jef2016-06-25 18:55:43;90613;canole@@ -103,13 +103,13 @@ type.For example, to emulate the md5sum command you can use-` + "```sh" + `+` + "```console" + `rclone lsf -R --hash MD5 --format hp --separator " " --files-only .` + "```" + `E.g.-` + "```sh" + `+` + "```console" + `$ rclone lsf -R --hash MD5 --format hp --separator " " --files-only swift:bucket7908e352297f0f530b84a756f188baa3 bevajer5jefcd65ac234e6fea5925974a51cdd865cc canole@@ -126,7 +126,7 @@ putting it last is a good strategy.E.g.-` + "```sh" + `+` + "```console" + `$ rclone lsf --separator "," --format "tshp" swift:bucket2016-06-25 18:55:41,60295,7908e352297f0f530b84a756f188baa3,bevajer5jef2016-06-25 18:55:43,90613,cd65ac234e6fea5925974a51cdd865cc,canole@@ -140,7 +140,7 @@ if they contain,E.g.-` + "```sh" + `+` + "```console" + `$ rclone lsf --csv --files-only --format ps remote:pathtest.log,22355test.sh,449@@ -153,7 +153,7 @@ to pass to an rclone copy with the ` + "`--files-from-raw`" + ` flag.For example, to find all the files modified within one day and copythose only (without traversing the whole directory structure):-` + "```sh" + `+` + "```console" + `rclone lsf --absolute --files-only --max-age 1d /path/to/local > new_filesrclone copy --files-from-raw new_files /path/to/local remote:path` + "```" + `@@ -162,7 +162,7 @@ The default time format is ` + "`'2006-01-02 15:04:05'`" + `.[Other formats](https://pkg.go.dev/time#pkg-constants) can be specified withthe ` + "`--time-format`" + ` flag. Examples:-` + "```sh" + `+` + "```console" + `rclone lsf remote:path --format pt --time-format 'Jan 2, 2006 at 3:04pm (MST)'rclone lsf remote:path --format pt --time-format '2006-01-02 15:04:05.000000000'rclone lsf remote:path --format pt --time-format '2006-01-02T15:04:05.999999999Z07:00'diff --git a/cmd/lsl/lsl.go b/cmd/lsl/lsl.goindex cabcef28b..3fe4875f0 100644--- a/cmd/lsl/lsl.go+++ b/cmd/lsl/lsl.go@@ -23,7 +23,7 @@ readable format with modification time, size and path. Recurses by default.E.g.-` + "```sh" + `+` + "```console" + `$ rclone lsl swift:bucket60295 2016-06-25 18:55:41.062626927 bevajer5jef90613 2016-06-25 18:55:43.302607074 canolediff --git a/cmd/mountlib/mount.md b/cmd/mountlib/mount.mdindex 789adb30b..8d640d5c6 100644--- a/cmd/mountlib/mount.md+++ b/cmd/mountlib/mount.md@@ -16,7 +16,7 @@ mount, waits until success or timeout and exits with appropriate codeOn Linux/macOS/FreeBSD start the mount like this, where `/path/to/local/mount`is an **empty** **existing** directory:-```sh+```consolerclone @ remote:path/to/files /path/to/local/mount```@@ -32,7 +32,7 @@ and is not supported when [mounting as a network drive](#mounting-modes-on-windoand the last example will mount as network share `\\cloud\remote` and map it to anautomatically assigned drive:-```sh+```consolerclone @ remote:path/to/files *rclone @ remote:path/to/files X:rclone @ remote:path/to/files C:\path\parent\mount@@ -44,7 +44,7 @@ a SIGINT or SIGTERM signal, the mount should be automatically stopped.When running in background mode the user will have to stop the mount manually:-```sh+```console# Linuxfusermount -u /path/to/local/mount#... or on some systems@@ -96,7 +96,7 @@ directory or drive. Using the special value `*` will tell rclone toautomatically assign the next available drive letter, starting with Z: and movingbackward. Examples:-```sh+```consolerclone @ remote:path/to/files *rclone @ remote:path/to/files X:rclone @ remote:path/to/files C:\path\parent\mount@@ -111,7 +111,7 @@ to your @ command. Mounting to a directory path is not supported inthis mode, it is a limitation Windows imposes on junctions, so the remote must alwaysbe mounted to a drive letter.-```sh+```consolerclone @ remote:path/to/files X: --network-mode```@@ -129,7 +129,7 @@ volume label for the mapped drive, shown in Windows Explorer etc, while the compIf you specify a full network share UNC path with `--volname`, this will implicitlyset the `--network-mode` option, so the following two examples have same result:-```sh+```consolerclone @ remote:path/to/files X: --network-moderclone @ remote:path/to/files X: --volname \\server\share```@@ -140,7 +140,7 @@ mountpoint, and instead use the UNC path specified as the volume name, as if itspecified with the `--volname` option. This will also implicitly setthe `--network-mode` option. This means the following two examples have same result:-```sh+```consolerclone @ remote:path/to/files \\cloud\remoterclone @ remote:path/to/files * --volname \\cloud\remote```@@ -296,7 +296,7 @@ from the website, rclone will locate the macFUSE libraries without any further iIf however, macFUSE is installed using the [macports](https://www.macports.org/)package manager, the following addition steps are required.-```sh+```consolesudo mkdir /usr/local/libcd /usr/local/libsudo ln -s /opt/local/lib/libfuse.2.dylib@@ -424,7 +424,7 @@ rclone will detect it and translate command-line arguments appropriately.Now you can run classic mounts like this:-```sh+```consolemount sftp1:subdir /mnt/data -t rclone -o vfs_cache_mode=writes,sftp_key_file=/path/to/pem```@@ -456,7 +456,7 @@ WantedBy=multi-user.targetor add in `/etc/fstab` a line like-```sh+```consolesftp1:subdir /mnt/data rclone rw,noauto,nofail,_netdev,x-systemd.automount,args2env,vfs_cache_mode=writes,config=/etc/rclone.conf,cache_dir=/var/cache/rclone 0 0```diff --git a/cmd/mountlib/rc.go b/cmd/mountlib/rc.goindex 67bba5efb..65af12d71 100644--- a/cmd/mountlib/rc.go+++ b/cmd/mountlib/rc.go@@ -65,7 +65,7 @@ This takes the following parameters:Example:-` + "```sh" + `+` + "```console" + `rclone rc mount/mount fs=mydrive: mountPoint=/home/<user>/mountPointrclone rc mount/mount fs=mydrive: mountPoint=/home/<user>/mountPoint mountType=mountrclone rc mount/mount fs=TestDrive: mountPoint=/mnt/tmp vfsOpt='{"CacheMode": 2}' mountOpt='{"AllowOther": true}'@@ -74,7 +74,7 @@ rclone rc mount/mount fs=TestDrive: mountPoint=/mnt/tmp vfsOpt='{"CacheMode": 2}The vfsOpt are as described in options/get and can be seen in the the"vfs" section when running and the mountOpt can be seen in the "mount" section:-` + "```sh" + `+` + "```console" + `rclone rc options/get` + "```" + ``,diff --git a/cmd/moveto/moveto.go b/cmd/moveto/moveto.goindex dd68efa0a..b7a4d2254 100644--- a/cmd/moveto/moveto.go+++ b/cmd/moveto/moveto.go@@ -35,7 +35,7 @@ like the [move](/commands/rclone_move/) command.So-` + "```sh" + `+` + "```console" + `rclone moveto src dst` + "```" + `diff --git a/cmd/obscure/obscure.go b/cmd/obscure/obscure.goindex 07754f2de..531192b0e 100644--- a/cmd/obscure/obscure.go+++ b/cmd/obscure/obscure.go@@ -33,7 +33,7 @@ This command can also accept a password through STDIN instead of anargument by passing a hyphen as an argument. This will use the firstline of STDIN as the password not including the trailing newline.-` + "```sh" + `+` + "```console" + `echo "secretpassword" | rclone obscure -` + "```" + `diff --git a/cmd/rcat/rcat.go b/cmd/rcat/rcat.goindex 29ecbc407..8cf963b42 100644--- a/cmd/rcat/rcat.go+++ b/cmd/rcat/rcat.go@@ -28,7 +28,7 @@ var commandDefinition = &cobra.Command{Short: `Copies standard input to file on remote.`,Long: `Reads from standard input (stdin) and copies it to a single remote file.-` + "```sh" + `+` + "```console" + `echo "hello world" | rclone rcat remote:path/to/fileffmpeg - | rclone rcat remote:path/to/file` + "```" + `diff --git a/cmd/serve/docker/docker.md b/cmd/serve/docker/docker.mdindex c16032f8a..c081d128f 100644--- a/cmd/serve/docker/docker.md+++ b/cmd/serve/docker/docker.md@@ -9,7 +9,7 @@ Docker plugins can run as a managed plugin under control of the docker daemonor as an independent native service. For testing, you can just run it directlyfrom the command line, for example:-```sh+```consolesudo rclone serve docker --base-dir /tmp/rclone-volumes --socket-addr localhost:8787 -vv```diff --git a/cmd/serve/restic/restic.go b/cmd/serve/restic/restic.goindex e295989c0..24af0db69 100644--- a/cmd/serve/restic/restic.go+++ b/cmd/serve/restic/restic.go@@ -119,7 +119,7 @@ following instructions.Now start the rclone restic server-` + "```sh" + `+` + "```console" + `rclone serve restic -v remote:backup` + "```" + `@@ -149,7 +149,7 @@ the URL for the REST server.For example:-` + "```sh" + `+` + "```console" + `$ export RESTIC_REPOSITORY=rest:http://localhost:8080/$ export RESTIC_PASSWORD=yourpassword$ restic init@@ -173,7 +173,7 @@ Note that you can use the endpoint to host multiple repositories. Dothis by adding a directory name or path after the URL. Note thatthese **must** end with /. Eg-` + "```sh" + `+` + "```console" + `$ export RESTIC_REPOSITORY=rest:http://localhost:8080/user1repo/# backup user1 stuff$ export RESTIC_REPOSITORY=rest:http://localhost:8080/user2repo/diff --git a/cmd/serve/s3/serve_s3.md b/cmd/serve/s3/serve_s3.mdindex 7d3cffc13..7143da9ac 100644--- a/cmd/serve/s3/serve_s3.md+++ b/cmd/serve/s3/serve_s3.md@@ -33,14 +33,14 @@ cause problems for S3 clients which rely on the Etag being the MD5.For a simple set up, to serve `remote:path` over s3, run the serverlike this:-```sh+```consolerclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY remote:path```For example, to use a simple folder in the filesystem, run the serverwith a command like this:-```sh+```consolerclone serve s3 --auth-key ACCESS_KEY_ID,SECRET_ACCESS_KEY local:/path/to/folder```diff --git a/cmd/serve/serve.go b/cmd/serve/serve.goindex b2773ba9c..fcf3a445b 100644--- a/cmd/serve/serve.go+++ b/cmd/serve/serve.go@@ -19,7 +19,7 @@ var Command = &cobra.Command{Long: `Serve a remote over a given protocol. Requires the use of asubcommand to specify the protocol, e.g.-` + "```sh" + `+` + "```console" + `rclone serve http remote:` + "```" + `diff --git a/cmd/serve/sftp/sftp.go b/cmd/serve/sftp/sftp.goindex a49d54ba6..ebd6a0de0 100644--- a/cmd/serve/sftp/sftp.go+++ b/cmd/serve/sftp/sftp.go@@ -151,7 +151,7 @@ It can be configured with .socket and .service unit files as described inSocket activation can be tested ad-hoc with the ` + "`systemd-socket-activate`" + `command:-` + "```sh" + `+` + "```console" + `systemd-socket-activate -l 2222 -- rclone serve sftp :local:vfs/` + "```" + `diff --git a/cmd/serve/webdav/webdav.go b/cmd/serve/webdav/webdav.goindex 2183420e5..fbc64b7a4 100644--- a/cmd/serve/webdav/webdav.go+++ b/cmd/serve/webdav/webdav.go@@ -157,13 +157,13 @@ Create a new DWORD BasicAuthLevel with value 2.You can serve the webdav on a unix socket like this:-` + "```sh" + `+` + "```console" + `rclone serve webdav --addr unix:///tmp/my.socket remote:path` + "```" + `and connect to it like this using rclone and the webdav backend:-` + "```sh" + `+` + "```console" + `rclone --webdav-unix-socket /tmp/my.socket --webdav-url http://localhost lsf :webdav:` + "```" + `diff --git a/cmd/settier/settier.go b/cmd/settier/settier.goindex 97480f9fc..97bc48374 100644--- a/cmd/settier/settier.go+++ b/cmd/settier/settier.go@@ -29,19 +29,19 @@ inaccessible.trueYou can use it to tier single object-` + "```sh" + `+` + "```console" + `rclone settier Cool remote:path/file` + "```" + `Or use rclone filters to set tier on only specific files-` + "```sh" + `+` + "```console" + `rclone --include "*.txt" settier Hot remote:path/dir` + "```" + `Or just provide remote directory and all files in directory will be tiered-` + "```sh" + `+` + "```console" + `rclone settier tier remote:path/dir` + "```",Annotations: map[string]string{diff --git a/cmd/test/test.go b/cmd/test/test.goindex 95de40b1b..907c0aa7a 100644--- a/cmd/test/test.go+++ b/cmd/test/test.go@@ -18,7 +18,7 @@ var Command = &cobra.Command{Select which test command you want with the subcommand, eg-` + "```sh" + `+` + "```console" + `rclone test memory remote:` + "```" + `diff --git a/cmd/version/version.go b/cmd/version/version.goindex e588df721..549fae027 100644--- a/cmd/version/version.go+++ b/cmd/version/version.go@@ -42,7 +42,7 @@ build tags and the type of executable (static or dynamic).For example:-` + "```sh" + `+` + "```console" + `$ rclone versionrclone v1.55.0- os/version: ubuntu 18.04 (64 bit)@@ -60,7 +60,7 @@ Note: before rclone version 1.55 the os/type and os/arch lines were merged,If you supply the --check flag, then it will do an online check tocompare your version with the latest release and the latest beta.-` + "```sh" + `+` + "```console" + `$ rclone version --checkyours: 1.42.0.6latest: 1.42 (released 2018-06-16)@@ -69,7 +69,7 @@ beta: 1.42.0.5 (released 2018-06-17)Or-` + "```sh" + `+` + "```console" + `$ rclone version --checkyours: 1.41latest: 1.42 (released 2018-06-16)diff --git a/docs/content/alias.md b/docs/content/alias.mdindex d9e855fca..24dfcfa11 100644--- a/docs/content/alias.md+++ b/docs/content/alias.md@@ -34,7 +34,7 @@ can be used to only show the trashed files in `myDrive`.Here is an example of how to make an alias called `remote` for local folder.First run:-```sh+```consolerclone config```@@ -87,19 +87,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level in `/mnt/storage/backup`-```sh+```consolerclone lsd remote:```List all the files in `/mnt/storage/backup`-```sh+```consolerclone ls remote:```Copy another local directory to the alias directory called source-```sh+```consolerclone copy /home/source remote:source```diff --git a/docs/content/azureblob.md b/docs/content/azureblob.mdindex 0f5773eeb..08c576c23 100644--- a/docs/content/azureblob.md+++ b/docs/content/azureblob.md@@ -15,7 +15,7 @@ command.) You may put subdirectories in too, e.g.Here is an example of making a Microsoft Azure Blob Storageconfiguration. For a remote called `remote`. First run:-```sh+```consolerclone config```@@ -57,26 +57,26 @@ y/e/d> ySee all containers-```sh+```consolerclone lsd remote:```Make a new container-```sh+```consolerclone mkdir remote:container```List the contents of a container-```sh+```consolerclone ls remote:container```Sync `/home/local/directory` to the remote container, deleting any excessfiles in the container.-```sh+```consolerclone sync --interactive /home/local/directory remote:container```@@ -212,25 +212,25 @@ Credentials created with the `az` tool can be picked up using `env_auth`.For example if you were to login with a service principal like this:-```sh+```consoleaz login --service-principal -u XXX -p XXX --tenant XXX```Then you could access rclone resources like this:-```sh+```consolerclone lsf :azureblob,env_auth,account=ACCOUNT:CONTAINER```Or-```sh+```consolerclone lsf --azureblob-env-auth --azureblob-account=ACCOUNT :azureblob:CONTAINER```Which is analogous to using the `az` tool:-```sh+```consoleaz storage blob list --container-name CONTAINER --account-name ACCOUNT --auth-mode login```@@ -253,14 +253,14 @@ explorer in the Azure portal.If you use a container level SAS URL, rclone operations are permittedonly on a particular container, e.g.-```sh+```consolerclone ls azureblob:container```You can also list the single container from the root. This will onlyshow the container specified by the SAS URL.-```sh+```console$ rclone lsd azureblob:container/```@@ -268,7 +268,7 @@ container/Note that you can't see or access any other containers - this willfail-```sh+```consolerclone ls azureblob:othercontainer```@@ -364,7 +364,7 @@ Don't set `env_auth` at the same time.If you want to access resources with public anonymous access then set`account` only. You can do this without making an rclone config:-```sh+```consolerclone lsf :azureblob,account=ACCOUNT:CONTAINER```diff --git a/docs/content/azurefiles.md b/docs/content/azurefiles.mdindex 64ea5695d..0af5a908f 100644--- a/docs/content/azurefiles.md+++ b/docs/content/azurefiles.md@@ -14,7 +14,7 @@ e.g. `remote:path/to/dir`.Here is an example of making a Microsoft Azure Files Storageconfiguration. For a remote called `remote`. First run:-```sh+```consolerclone config```@@ -90,26 +90,26 @@ Once configured you can use rclone.See all files in the top level:-```sh+```consolerclone lsf remote:```Make a new directory in the root:-```sh+```consolerclone mkdir remote:dir```Recursively List the contents:-```sh+```consolerclone ls remote:```Sync `/home/local/directory` to the remote directory, deleting anyexcess files in the directory.-```sh+```consolerclone sync --interactive /home/local/directory remote:dir```@@ -238,19 +238,19 @@ Credentials created with the `az` tool can be picked up using `env_auth`.For example if you were to login with a service principal like this:-```sh+```consoleaz login --service-principal -u XXX -p XXX --tenant XXX```Then you could access rclone resources like this:-```sh+```consolerclone lsf :azurefiles,env_auth,account=ACCOUNT:```Or-```sh+```consolerclone lsf --azurefiles-env-auth --azurefiles-account=ACCOUNT :azurefiles:```diff --git a/docs/content/b2.md b/docs/content/b2.mdindex 5ebe5dbf6..5efec4cc6 100644--- a/docs/content/b2.md+++ b/docs/content/b2.md@@ -15,7 +15,7 @@ command.) You may put subdirectories in too, e.g. `remote:bucket/path/to/dir`.Here is an example of making a b2 configuration. First run-```sh+```consolerclone config```@@ -62,19 +62,19 @@ This remote is called `remote` and can now be used like thisSee all buckets-```sh+```consolerclone lsd remote:```Create a new bucket-```sh+```consolerclone mkdir remote:bucket```List the contents of a bucket-```sh+```consolerclone ls remote:bucket```@@ -82,7 +82,7 @@ rclone ls remote:bucketSync `/home/local/directory` to the remote bucket, deleting anyexcess files in the bucket.-```sh+```consolerclone sync --interactive /home/local/directory remote:bucket```@@ -230,7 +230,7 @@ version followed by a `cleanup` of the old versions.Show current version and all the versions with `--b2-versions` flag.-```sh+```console$ rclone -q ls b2:cleanup-test9 one.txt@@ -243,7 +243,7 @@ $ rclone -q --b2-versions ls b2:cleanup-testRetrieve an old version-```sh+```console$ rclone -q --b2-versions copy b2:cleanup-test/one-v2016-07-04-141003-000.txt /tmp$ ls -l /tmp/one-v2016-07-04-141003-000.txt@@ -252,7 +252,7 @@ $ ls -l /tmp/one-v2016-07-04-141003-000.txtClean up all the old versions and show that they've gone.-```sh+```console$ rclone -q cleanup b2:cleanup-test$ rclone -q ls b2:cleanup-test@@ -268,7 +268,7 @@ When using `--b2-versions` flag rclone is relying on the file nameto work out whether the objects are versions or not. Versions' namesare created by inserting timestamp between file name and its extension.-```sh+```console9 file.txt8 file-v2023-07-17-161032-000.txt16 file-v2023-06-15-141003-000.txt@@ -322,14 +322,14 @@ rclone will show and act on older versions of files. For exampleListing without `--b2-versions`-```sh+```console$ rclone -q ls b2:cleanup-test9 one.txt```And with-```sh+```console$ rclone -q --b2-versions ls b2:cleanup-test9 one.txt8 one-v2016-07-04-141032-000.txt@@ -349,7 +349,7 @@ permitted, so you can't upload files or delete them.Rclone supports generating file share links for private B2 buckets.They can either be for a file for example:-```sh+```console./rclone link B2:bucket/path/to/file.txthttps://f002.backblazeb2.com/file/bucket/path/to/file.txt?Authorization=xxxxxxxx@@ -357,7 +357,7 @@ https://f002.backblazeb2.com/file/bucket/path/to/file.txt?Authorization=xxxxxxxxor if run on a directory you will get:-```sh+```console./rclone link B2:bucket/pathhttps://f002.backblazeb2.com/file/bucket/path?Authorization=xxxxxxxx```diff --git a/docs/content/bisync.md b/docs/content/bisync.mdindex a72bc8e24..85f9ea387 100644--- a/docs/content/bisync.md+++ b/docs/content/bisync.md@@ -31,7 +31,7 @@ section) before using, or data loss can result. Questions can be asked in theFor example, your first command might look like this:-```sh+```consolerclone bisync remote1:path1 remote2:path2 --create-empty-src-dirs --compare size,modtime,checksum --slow-hash-sync-only --resilient -MvP --drive-skip-gdocs --fix-case --resync --dry-run```@@ -40,7 +40,7 @@ After that, remove `--resync` as well.Here is a typical run log (with timestamps removed for clarity):-```sh+```consolerclone bisync /testdir/path1/ /testdir/path2/ --verboseINFO : Synching Path1 "/testdir/path1/" with Path2 "/testdir/path2/"INFO : Path1 checking for diffs@@ -86,7 +86,7 @@ INFO : Bisync successful## Command line syntax-```sh+```console$ rclone bisync --helpUsage:rclone bisync remote1:path1 remote2:path2 [flags]@@ -169,7 +169,7 @@ be copied to Path1, and the process will then copy the Path1 tree to Path2.The `--resync` sequence is roughly equivalent to the following(but see [`--resync-mode`](#resync-mode) for other options):-```sh+```consolerclone copy Path2 Path1 --ignore-existing [--create-empty-src-dirs]rclone copy Path1 Path2 [--create-empty-src-dirs]```@@ -225,7 +225,7 @@ Shutdown](#graceful-shutdown) mode, when needed) for a very robustalmost any interruption it might encounter. Consider adding something like thefollowing:-```sh+```text--resilient --recover --max-lock 2m --conflict-resolve newer```@@ -353,13 +353,13 @@ simultaneously (or just `modtime` AND `checksum`).being `size`, `modtime`, and `checksum`. For example, if you want to comparesize and checksum, but not modtime, you would do:-```sh+```text--compare size,checksum```Or if you want to compare all three:-```sh+```text--compare size,modtime,checksum```@@ -627,7 +627,7 @@ specified (or when two identical suffixes are specified.) i.e. with`--conflict-loser pathname`, all of the following would produce exactly thesame result:-```sh+```text--conflict-suffix path--conflict-suffix path,path--conflict-suffix path1,path2@@ -642,7 +642,7 @@ changed with the [`--suffix-keep-extension`](/docs/#suffix-keep-extension) flagcurly braces as globs. This can be helpful to track the date and/or time thateach conflict was handled by bisync. For example:-```sh+```text--conflict-suffix {DateOnly}-conflict// result: myfile.txt.2006-01-02-conflict1```@@ -667,7 +667,7 @@ conflicts with `..path1` and `..path2` (with two periods, and `path` instead ofadditional dots can be added by including them in the specified suffix string.For example, for behavior equivalent to the previous default, use:-```sh+```text[--conflict-resolve none] --conflict-loser pathname --conflict-suffix .path```@@ -707,13 +707,13 @@ For example, a possible sequence could look like this:1. Normally scheduled bisync run:- ```sh+ ```consolerclone bisync Path1 Path2 -MPc --check-access --max-delete 10 --filters-file /path/to/filters.txt -v --no-cleanup --ignore-listing-checksum --disable ListR --checkers=16 --drive-pacer-min-sleep=10ms --create-empty-src-dirs --resilient```2. Periodic independent integrity check (perhaps scheduled nightly or weekly):- ```sh+ ```consolerclone check -MvPc Path1 Path2 --filter-from /path/to/filters.txt```@@ -721,7 +721,7 @@ For example, a possible sequence could look like this:If one side is more up-to-date and you want to make the other side match it,you could run:- ```sh+ ```consolerclone sync Path1 Path2 --filter-from /path/to/filters.txt --create-empty-src-dirs -MPc -v```@@ -851,7 +851,7 @@ override `--backup-dir`.Example:-```sh+```consolerclone bisync /Users/someuser/some/local/path/Bisync gdrive:Bisync --backup-dir1 /Users/someuser/some/local/path/BackupDir --backup-dir2 gdrive:BackupDir --suffix -2023-08-26 --suffix-keep-extension --check-access --max-delete 10 --filters-file /Users/someuser/some/local/path/bisync_filters.txt --no-cleanup --ignore-listing-checksum --checkers=16 --drive-pacer-min-sleep=10ms --create-empty-src-dirs --resilient -MvP --drive-skip-gdocs --fix-case```@@ -1383,7 +1383,7 @@ listings and thus not checked during the check access phase.Here are two normal runs. The first one has a newer file on the remote.The second has no deltas between local and remote.-```sh+```text2021/05/16 00:24:38 INFO : Synching Path1 "/path/to/local/tree/" with Path2 "dropbox:/"2021/05/16 00:24:38 INFO : Path1 checking for diffs2021/05/16 00:24:38 INFO : - Path1 File is new - file.txt@@ -1433,7 +1433,7 @@ numerous such messages in the log.Since there are no final error/warning messages on line *7*, rclone hasrecovered from failure after a retry, and the overall sync was successful.-```sh+```text1: 2021/05/14 00:44:12 INFO : Synching Path1 "/path/to/local/tree" with Path2 "dropbox:"2: 2021/05/14 00:44:12 INFO : Path1 checking for diffs3: 2021/05/14 00:44:12 INFO : Path2 checking for diffs@@ -1446,7 +1446,7 @@ recovered from failure after a retry, and the overall sync was successful.This log shows a *Critical failure* which requires a `--resync` to recover from.See the [Runtime Error Handling](#error-handling) section.-```sh+```text2021/05/12 00:49:40 INFO : Google drive root '': Waiting for checks to finish2021/05/12 00:49:40 INFO : Google drive root '': Waiting for transfers to finish2021/05/12 00:49:40 INFO : Google drive root '': not deleting files as there were IO errors@@ -1531,7 +1531,7 @@ on Linux you can use *Cron* which is described below.The 1st example runs a sync every 5 minutes between a local directoryand an OwnCloud server, with output logged to a runlog file:-```sh+```text# Minute (0-59)# Hour (0-23)# Day of Month (1-31)@@ -1548,7 +1548,7 @@ If you run `rclone bisync` as a cron job, redirect stdout/stderr to a file.The 2nd example runs a sync to Dropbox every hour and logs all stdout (via the `>>`)and stderr (via `2>&1`) to a log file.-```sh+```text0 * * * * /path/to/rclone bisync /path/to/local/dropbox Dropbox: --check-access --filters-file /home/user/filters.txt >> /path/to/logs/dropbox-run.log 2>&1```@@ -1630,7 +1630,7 @@ Rerunning the test will let it pass. Consider such failures as noise.### Test command syntax-```sh+```textusage: go test ./cmd/bisync [options...]Options:diff --git a/docs/content/box.md b/docs/content/box.mdindex 521962a9a..ac34880fe 100644--- a/docs/content/box.md+++ b/docs/content/box.md@@ -18,7 +18,7 @@ to use JWT authentication. `rclone config` walks you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -96,13 +96,13 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Box-```sh+```consolerclone lsd remote:```List all the files in your Box-```sh+```consolerclone ls remote:```@@ -144,7 +144,7 @@ did the authentication on.Here is how to do it.-```sh+```console$ rclone configCurrent remotes:diff --git a/docs/content/cache.md b/docs/content/cache.mdindex 79b6be29f..780c2094d 100644--- a/docs/content/cache.md+++ b/docs/content/cache.md@@ -31,7 +31,7 @@ with `cache`.Here is an example of how to make a remote called `test-cache`. First run:-```sh+```consolerclone config```@@ -117,19 +117,19 @@ You can then use it like this,List directories in top level of your drive-```sh+```consolerclone lsd test-cache:```List all the files in your drive-```sh+```consolerclone ls test-cache:```To start a cached mount-```sh+```consolerclone mount --allow-other test-cache: /var/tmp/test-cache```diff --git a/docs/content/cloudinary.md b/docs/content/cloudinary.mdindex 8297d9817..bae3ece9e 100644--- a/docs/content/cloudinary.md+++ b/docs/content/cloudinary.md@@ -38,7 +38,7 @@ from the developer section.Now run-```sh+```consolerclone config```@@ -113,19 +113,19 @@ y/e/d> yList directories in the top level of your Media Library-```sh+```consolerclone lsd cloudinary-media-library:```Make a new directory.-```sh+```consolerclone mkdir cloudinary-media-library:directory```List the contents of a directory.-```sh+```consolerclone ls cloudinary-media-library:directory```diff --git a/docs/content/combine.md b/docs/content/combine.mdindex 63a83ffbd..6816c31b8 100644--- a/docs/content/combine.md+++ b/docs/content/combine.md@@ -11,7 +11,7 @@ tree.For example you might have a remote for images on one provider:-```sh+```console$ rclone tree s3:imagesbucket/├── image1.jpg@@ -20,7 +20,7 @@ $ rclone tree s3:imagesbucketAnd a remote for files on another:-```sh+```console$ rclone tree drive:important/files/├── file1.txt@@ -30,7 +30,7 @@ $ rclone tree drive:important/filesThe `combine` backend can join these together into a syntheticdirectory structure like this:-```sh+```console$ rclone tree combined:/├── files@@ -57,7 +57,7 @@ either be a local paths or other remotes.Here is an example of how to make a combine called `remote` for theexample above. First run:-```sh+```consolerclone config```@@ -107,7 +107,7 @@ the shared drives you have access to.Assuming your main (non shared drive) Google drive remote is called`drive:` you would run-```sh+```consolerclone backend -o config drives drive:```diff --git a/docs/content/crypt.md b/docs/content/crypt.mdindex 03e2564dc..e65b5b846 100644--- a/docs/content/crypt.md+++ b/docs/content/crypt.md@@ -274,7 +274,7 @@ details, and a tool you can use to check if you are affected.Create the following file structure using "standard" file nameencryption.-```sh+```textplaintext/├── file0.txt├── file1.txt@@ -287,7 +287,7 @@ plaintext/Copy these to the remote, and list them-```sh+```console$ rclone -q copy plaintext secret:$ rclone -q ls secret:7 file1.txt@@ -299,7 +299,7 @@ $ rclone -q ls secret:The crypt remote looks like-```sh+```console$ rclone -q ls remote:path55 hagjclgavj2mbiqm6u6cnjjqcg54 v05749mltvv1tf4onltun46gls@@ -310,7 +310,7 @@ $ rclone -q ls remote:pathThe directory structure is preserved-```sh+```console$ rclone -q ls secret:subdir8 file2.txt9 file3.txt@@ -321,7 +321,7 @@ Without file name encryption `.bin` extensions are added to underlyingnames. This prevents the cloud provider attempting to interpret filecontent.-```sh+```console$ rclone -q ls remote:path54 file0.txt.bin57 subdir/file3.txt.bindiff --git a/docs/content/docker.md b/docs/content/docker.mdindex c63d74408..c8592c826 100644--- a/docs/content/docker.md+++ b/docs/content/docker.md@@ -45,27 +45,27 @@ on the host.The *FUSE* driver is a prerequisite for rclone mounting and should beinstalled on host:-```sh+```consolesudo apt-get -y install fuse3```Create two directories required by rclone docker plugin:-```sh+```consolesudo mkdir -p /var/lib/docker-plugins/rclone/configsudo mkdir -p /var/lib/docker-plugins/rclone/cache```Install the managed rclone docker plugin for your architecture (here `amd64`):-```sh+```consoledocker plugin install rclone/docker-volume-rclone:amd64 args="-v" --alias rclone --grant-all-permissionsdocker plugin list```Create your [SFTP volume](/sftp/#standard-options):-```sh+```consoledocker volume create firstvolume -d rclone -o type=sftp -o sftp-host=_hostname_ -o sftp-user=_username_ -o sftp-pass=_password_ -o allow-other=true```@@ -78,7 +78,7 @@ for example `-o path=/home/username`.Time to create a test container and mount the volume into it:-```sh+```consoledocker run --rm -it -v firstvolume:/mnt --workdir /mnt ubuntu:latest bash```@@ -88,7 +88,7 @@ or otherwise play with it. Type `exit` when you are done.The container will stop but the volume will stay, ready to be reused.When it's not needed anymore, remove it:-```sh+```consoledocker volume listdocker volume remove firstvolume```@@ -145,7 +145,7 @@ volumes:and run the stack:-```sh+```consoledocker stack deploy example -c ./example.yml```@@ -155,7 +155,7 @@ run service containers on one or more cluster nodes and requestthe `example_configdata` volume from rclone plugins on the node hosts.You can use the following commands to confirm results:-```sh+```consoledocker service lsdocker service ps example_heimdalldocker volume ls@@ -173,7 +173,7 @@ the `docker volume remove example_configdata` command on every node.Volumes can be created with [docker volume create](https://docs.docker.com/engine/reference/commandline/volume_create/).Here are a few examples:-```sh+```consoledocker volume create vol1 -d rclone -o remote=storj: -o vfs-cache-mode=fulldocker volume create vol2 -d rclone -o remote=:storj,access_grant=xxx:heimdalldocker volume create vol3 -d rclone -o type=storj -o path=heimdall -o storj-access-grant=xxx -o poll-interval=0@@ -186,7 +186,7 @@ option.Volumes can be inspected as follows:-```sh+```consoledocker volume listdocker volume inspect vol1```@@ -210,13 +210,13 @@ The `remote=:backend:dir/subdir` syntax can be used to createwhile the `type` and `path` options provide a simpler alternative for this.Using two split options-```sh+```text-o type=backend -o path=dir/subdir```is equivalent to the combined syntax-```sh+```text-o remote=:backend:dir/subdir```@@ -262,13 +262,13 @@ Inside connection string the backend prefix must be dropped from parameternames but in the `-o param=value` array it must be present.For instance, compare the following option array-```sh+```text-o remote=:sftp:/home -o sftp-host=localhost```with equivalent connection string:-```sh+```text-o remote=:sftp,host=localhost:/home```@@ -345,7 +345,7 @@ By default they must exist on host at the following locationsYou can [install managed plugin](https://docs.docker.com/engine/reference/commandline/plugin_install/)with default settings as follows:-```sh+```consoledocker plugin install rclone/docker-volume-rclone:amd64 --grant-all-permissions --alias rclone```@@ -388,7 +388,7 @@ mount namespaces and bind-mounts into requesting user containers.You can tweak a few plugin settings after installation when it's disabled(not in use), for instance:-```sh+```consoledocker plugin disable rclonedocker plugin set rclone RCLONE_VERBOSE=2 config=/etc/rclone args="--vfs-cache-mode=writes --allow-other"docker plugin enable rclone@@ -448,7 +448,7 @@ actual level assigned by rclone in the encapsulated message string.You can set custom plugin options right when you install it, *in one go*:-```sh+```consoledocker plugin remove rclonedocker plugin install rclone/docker-volume-rclone:amd64 \--alias rclone --grant-all-permissions \@@ -486,7 +486,7 @@ You can just run it (type `rclone serve docker` and hit enter) for the test.Install *FUSE*:-```sh+```consolesudo apt-get -y install fuse```@@ -496,7 +496,7 @@ and [docker-volume-rclone.socket](https://raw.githubusercontent.com/rclone/rclonPut them to the `/etc/systemd/system/` directory:-```sh+```consolecp docker-volume-plugin.service /etc/systemd/system/cp docker-volume-plugin.socket /etc/systemd/system/```@@ -505,7 +505,7 @@ Please note that all commands in this section must be run as *root* butwe omit `sudo` prefix for brevity.Now create directories required by the service:-```sh+```consolemkdir -p /var/lib/docker-volumes/rclonemkdir -p /var/lib/docker-plugins/rclone/configmkdir -p /var/lib/docker-plugins/rclone/cache@@ -513,7 +513,7 @@ mkdir -p /var/lib/docker-plugins/rclone/cacheRun the docker plugin service in the socket activated mode:-```sh+```consolesystemctl daemon-reloadsystemctl start docker-volume-rclone.servicesystemctl enable docker-volume-rclone.socket@@ -540,7 +540,7 @@ prefer socket activation.You can [see managed plugin settings](https://docs.docker.com/engine/extend/#debugging-plugins)with-```sh+```consoledocker plugin listdocker plugin inspect rclone```@@ -555,20 +555,20 @@ but their actual level can be seen from encapsulated message string.You will usually install the latest version of managed plugin for your platform.Use the following commands to print the actual installed version:-```sh+```consolePLUGID=$(docker plugin list --no-trunc | awk '/rclone/{print$1}')sudo runc --root /run/docker/runtime-runc/plugins.moby exec $PLUGID rclone version```You can even use `runc` to run shell inside the plugin container:-```sh+```consolesudo runc --root /run/docker/runtime-runc/plugins.moby exec --tty $PLUGID bash```Also you can use curl to check the plugin socket connectivity:-```sh+```consoledocker plugin list --no-truncPLUGID=123abc...sudo curl -H Content-Type:application/json -XPOST -d {} --unix-socket /run/docker/plugins/$PLUGID/rclone.sock http://localhost/Plugin.Activate@@ -582,7 +582,7 @@ diagnosing with the above methods, you can try clearing the state of the plugin.This might be needed because a reinstall don't cleanup existing state files toallow for easy restoration, as stated above.-```sh+```consoledocker plugin disable rclone # disable the plugin to ensure no interferencesudo rm /var/lib/docker-plugins/rclone/cache/docker-plugin.state # removing the plugin statedocker plugin enable rclone # re-enable the plugin afterward@@ -598,14 +598,14 @@ it won't even return an error. I hope that docker maintainers will fixthis some day. In the meantime be aware that you must remove your volumebefore recreating it with new settings:-```sh+```consoledocker volume remove my_voldocker volume create my_vol -d rclone -o opt1=new_val1 ...```and verify that settings did update:-```sh+```consoledocker volume listdocker volume inspect my_vol```diff --git a/docs/content/docs.md b/docs/content/docs.mdindex 3c178af79..f3cfb27bd 100644--- a/docs/content/docs.md+++ b/docs/content/docs.md@@ -22,7 +22,7 @@ file and choose its location.)The easiest way to make the config is to run rclone with the configoption:-```sh+```consolerclone config```@@ -100,7 +100,7 @@ Rclone syncs a directory tree from one storage system to another.Its syntax is like this-```sh+```consolerclone subcommand [options] <parameters> <parameters...>```@@ -115,7 +115,7 @@ used before the `subcommand`. Anything after a `--` option will not beinterpreted as an option so if you need to add a parameter whichstarts with a `-` then put a `--` on its own first, eg-```sh+```consolerclone lsf -- -directory-starting-with-dash```@@ -136,7 +136,7 @@ learning rclone to avoid accidental data loss.rclone uses a system of subcommands. For example-```sh+```consolerclone ls remote:path # lists a remoterclone copy /local/path remote:path # copies /local/path to the remoterclone sync --interactive /local/path remote:path # syncs /local/path to the remote@@ -192,7 +192,7 @@ directory` if it isn't.For example, suppose you have a remote with a file in called`test.jpg`, then you could copy just that file like this-```sh+```consolerclone copy remote:test.jpg /tmp/download```@@ -200,13 +200,13 @@ The file `test.jpg` will be placed inside `/tmp/download`.This is equivalent to specifying-```sh+```consolerclone copy --files-from /tmp/files remote: /tmp/download```Where `/tmp/files` contains the single line-```sh+```consoletest.jpg```@@ -252,25 +252,25 @@ the command line (or in environment variables).Here are some examples:-```sh+```consolerclone lsd --http-url https://pub.rclone.org :http:```To list all the directories in the root of `https://pub.rclone.org/`.-```sh+```consolerclone lsf --http-url https://example.com :http:path/to/dir```To list files and directories in `https://example.com/path/to/dir/`-```sh+```consolerclone copy --http-url https://example.com :http:path/to/dir /tmp/dir```To copy files and directories in `https://example.com/path/to/dir` to `/tmp/dir`.-```sh+```consolerclone copy --sftp-host example.com :sftp:path/to/dir /tmp/dir```@@ -284,7 +284,7 @@ syntax, so instead of providing the arguments as command lineparameters `--http-url https://pub.rclone.org` they are provided aspart of the remote specification as a kind of connection string.-```sh+```consolerclone lsd ":http,url='https://pub.rclone.org':"rclone lsf ":http,url='https://example.com':path/to/dir"rclone copy ":http,url='https://example.com':path/to/dir" /tmp/dir@@ -295,7 +295,7 @@ These can apply to modify existing remotes as well as create newremotes with the on the fly syntax. This example is equivalent toadding the `--drive-shared-with-me` parameter to the remote `gdrive:`.-```sh+```consolerclone lsf "gdrive,shared_with_me:path/to/dir"```@@ -306,13 +306,13 @@ file shared on google drive to the normal drive which **does notwork** because the `--drive-shared-with-me` flag applies to both thesource and the destination.-```sh+```consolerclone copy --drive-shared-with-me gdrive:shared-file.txt gdrive:```However using the connection string syntax, this does work.-```sh+```consolerclone copy "gdrive,shared_with_me:shared-file.txt" gdrive:```@@ -321,13 +321,13 @@ backend. If for example gdriveCrypt is a crypt based on gdrive, then thefollowing command **will not work** as intended, because`shared_with_me` is ignored by the crypt backend:-```sh+```consolerclone copy "gdriveCrypt,shared_with_me:shared-file.txt" gdriveCrypt:```The connection strings have the following syntax-```sh+```textremote,parameter=value,parameter2=value2:path/to/dir:backend,parameter=value,parameter2=value2:path/to/dir```@@ -335,7 +335,7 @@ remote,parameter=value,parameter2=value2:path/to/dirIf the `parameter` has a `:` or `,` then it must be placed in quotes `"` or`'`, so-```sh+```textremote,parameter="colon:value",parameter2="comma,value":path/to/dir:backend,parameter='colon:value',parameter2='comma,value':path/to/dir```@@ -343,7 +343,7 @@ remote,parameter="colon:value",parameter2="comma,value":path/to/dirIf a quoted value needs to include that quote, then it should bedoubled, so-```sh+```textremote,parameter="with""quote",parameter2='with''quote':path/to/dir```@@ -354,13 +354,13 @@ If you leave off the `=parameter` then rclone will substitute `=true`which works very well with flags. For example, to use s3 configured inthe environment you could use:-```sh+```consolerclone lsd :s3,env_auth:```Which is equivalent to-```sh+```consolerclone lsd :s3,env_auth=true:```@@ -372,7 +372,7 @@ If you are a shell master then you'll know which strings are OK andwhich aren't, but if you aren't sure then enclose them in `"` and use`'` as the inside quote. This syntax works on all OSes.-```sh+```consolerclone copy ":http,url='https://example.com':path/to/dir" /tmp/dir```@@ -381,7 +381,7 @@ strings in the shell (notably `\` and `$` and `"`) so if your stringscontain those you can swap the roles of `"` and `'` thus. (This syntaxdoes not work on Windows.)-```sh+```consolerclone copy ':http,url="https://example.com":path/to/dir' /tmp/dir```@@ -394,13 +394,13 @@ If you supply extra configuration to a backend by command line flag,environment variable or connection string then rclone will add asuffix based on the hash of the config to the name of the remote, eg-```sh+```consolerclone -vv lsf --s3-chunk-size 20M s3:```Has the log message-```sh+```textDEBUG : s3: detected overridden config - adding "{Srj1p}" suffix to name```@@ -411,13 +411,13 @@ This should only be noticeable in the logs.This means that on the fly backends such as-```sh+```consolerclone -vv lsf :s3,env_auth:```Will get their own names-```sh+```textDEBUG : :s3: detected overridden config - adding "{YTu53}" suffix to name```@@ -551,13 +551,13 @@ Here are some gotchas which may help users unfamiliar with the shell rulesIf your names have spaces or shell metacharacters (e.g. `*`, `?`, `$`,`'`, `"`, etc.) then you must quote them. Use single quotes `'` by default.-```sh+```consolerclone copy 'Important files?' remote:backup```If you want to send a `'` you will need to use `"`, e.g.-```sh+```consolerclone copy "O'Reilly Reviews" remote:backup```@@ -590,13 +590,13 @@ file or directory like this then use the full path starting with aSo to sync a directory called `sync:me` to a remote called `remote:` use-```sh+```consolerclone sync --interactive ./sync:me remote:path```or-```sh+```consolerclone sync --interactive /full/path/to/sync:me remote:path```@@ -611,7 +611,7 @@ to copy them in place.Eg-```sh+```consolerclone copy s3:oldbucket s3:newbucket```@@ -632,7 +632,7 @@ same.This can be used when scripting to make aged backups efficiently, e.g.-```sh+```consolerclone sync --interactive remote:current-backup remote:previous-backuprclone sync --interactive /path/to/files remote:current-backup```@@ -872,7 +872,7 @@ excluded by a filter rule.For example-```sh+```consolerclone sync --interactive /path/to/local remote:current --backup-dir remote:old```@@ -902,7 +902,7 @@ You can use `--bind 0.0.0.0` to force rclone to use IPv4 addresses andThis option controls the bandwidth limit. For example-```sh+```text--bwlimit 10M```@@ -914,7 +914,7 @@ suffix B|K|M|G|T|P. The default is `0` which means to not limit bandwidth.The upload and download bandwidth can be specified separately, as`--bwlimit UP:DOWN`, so-```sh+```text--bwlimit 10M:100k```@@ -922,7 +922,7 @@ would mean limit the upload bandwidth to 10 MiB/s and the downloadbandwidth to 100 KiB/s. Either limit can be "off" meaning no limit, soto just limit the upload bandwidth you would use-```sh+```text--bwlimit 10M:off```@@ -979,13 +979,13 @@ be unlimited.Timeslots without `WEEKDAY` are extended to the whole week. So thisexample:-```sh+```text--bwlimit "Mon-00:00,512 12:00,1M Sun-20:00,off"```Is equivalent to this:-```sh+```text--bwlimit "Mon-00:00,512Mon-12:00,1M Tue-12:00,1M Wed-12:00,1M Thu-12:00,1M Fri-12:00,1M Sat-12:00,1M Sun-12:00,1M Sun-20:00,off"```@@ -1005,14 +1005,14 @@ of a long running rclone transfer and to restore it back to the value specifiedwith `--bwlimit` quickly when needed. Assuming there is only one rclone instancerunning, you can toggle the limiter like this:-```sh+```consolekill -SIGUSR2 $(pidof rclone)```If you configure rclone with a [remote control](/rc) then you can usechange the bwlimit dynamically:-```sh+```consolerclone rc core/bwlimit rate=1M```@@ -1023,7 +1023,7 @@ This option controls per file bandwidth limit. For the options see theFor example use this to allow no transfers to be faster than 1 MiB/s-```sh+```text--bwlimit-file 1M```@@ -1313,7 +1313,7 @@ time rclone started up.This disables a comma separated list of optional features. For exampleto disable server-side move and server-side copy use:-```sh+```text--disable move,copy```@@ -1321,13 +1321,13 @@ The features can be put in any case.To see a list of which features can be disabled use:-```sh+```text--disable help```The features a remote has can be seen in JSON format with:-```sh+```consolerclone backend features remote:```@@ -1367,7 +1367,7 @@ support ([RFC 8622](https://tools.ietf.org/html/rfc8622)).For example, if you configured QoS on router to handle LE properly. Running:-```sh+```consolerclone copy --dscp LE from:/from to:/to```@@ -1459,7 +1459,7 @@ This flag is supported for all HTTP based backends even those notsupported by `--header-upload` and `--header-download` so may be usedas a workaround for those with care.-```sh+```consolerclone ls remote:test --header "X-Rclone: Foo" --header "X-LetMeIn: Yes"```@@ -1468,7 +1468,7 @@ rclone ls remote:test --header "X-Rclone: Foo" --header "X-LetMeIn: Yes"Add an HTTP header for all download transactions. The flag can be repeated toadd multiple headers.-```sh+```consolerclone sync --interactive s3:test/src ~/dst --header-download "X-Amz-Meta-Test: Foo" --header-download "X-Amz-Meta-Test2: Bar"```@@ -1480,7 +1480,7 @@ currently supported backends.Add an HTTP header for all upload transactions. The flag can be repeated to addmultiple headers.-```sh+```consolerclone sync --interactive ~/src s3:test/dst --header-upload "Content-Disposition: attachment; filename='cool.html'" --header-upload "X-Amz-Meta-Test: FooBar"```@@ -1658,7 +1658,7 @@ especially with `rclone sync`.For example-```sh+```console$ rclone delete --interactive /tmp/dirrclone: delete "important-file.txt"?y) Yes, this is OK (default)@@ -1748,7 +1748,7 @@ ignored.For example if the following flags are in use-```sh+```consolerclone --log-file rclone.log --log-file-max-size 1M --log-file-max-backups 3```@@ -1843,7 +1843,7 @@ once as administrator to create the registry key in advance.severe) than or equal to the `--log-level`. For example to log DEBUGto a log file but ERRORs to the event log you would use-```sh+```text--log-file rclone.log --log-level DEBUG --windows-event-log ERROR```@@ -2074,7 +2074,7 @@ it in `"`, if you want a literal `"` in an argument then enclose theargument in `"` and double the `"`. See [CSV encoding](https://godoc.org/encoding/csv)for more info.-```sh+```text--metadata-mapper "python bin/test_metadata_mapper.py"--metadata-mapper 'python bin/test_metadata_mapper.py "argument with a space"'--metadata-mapper 'python bin/test_metadata_mapper.py "argument with ""two"" quotes"'@@ -2445,7 +2445,7 @@ for more info.Eg-```sh+```text--password-command "echo hello"--password-command 'echo "hello with space"'--password-command 'echo "hello with ""quotes"" and space"'@@ -2650,7 +2650,7 @@ or with `--backup-dir`. See `--backup-dir` for more info.For example-```sh+```consolerclone copy --interactive /path/to/local/file remote:current --suffix .bak```@@ -2661,7 +2661,7 @@ If using `rclone sync` with `--suffix` and without `--backup-dir` thenit is recommended to put a filter rule in excluding the suffixotherwise the `sync` will delete the backup files.-```sh+```consolerclone sync --interactive /path/to/local/file remote:current --suffix .bak --exclude "*.bak"```@@ -3044,7 +3044,7 @@ have to supply the password every time you start rclone.To add a password to your rclone configuration, execute `rclone config`.-```sh+```console$ rclone configCurrent remotes:@@ -3058,7 +3058,7 @@ e/n/d/s/q>Go into `s`, Set configuration password:-```sh+```texte/n/d/s/q> sYour configuration is not encrypted.If you add a password, you will protect your login information to cloud services.@@ -3131,7 +3131,7 @@ environment variables. The script is supplied either viaOne useful example of this is using the `passwordstore` applicationto retrieve the password:-```sh+```consoleexport RCLONE_PASSWORD_COMMAND="pass rclone/config"```@@ -3177,13 +3177,13 @@ at rest or transfer. Detailed instructions for popular OSes:- Generate and store a password- ```sh+ ```consolesecurity add-generic-password -a rclone -s config -w $(openssl rand -base64 40)```- Add the retrieval instruction to your `.zprofile` / `.profile`- ```sh+ ```consoleexport RCLONE_PASSWORD_COMMAND="/usr/bin/security find-generic-password -a rclone -s config -w"```@@ -3196,13 +3196,13 @@ at rest or transfer. Detailed instructions for popular OSes:- Generate and store a password- ```sh+ ```consoleecho $(openssl rand -base64 40) | pass insert -m rclone/config```- Add the retrieval instruction- ```sh+ ```consoleexport RCLONE_PASSWORD_COMMAND="/usr/bin/pass rclone/config"```@@ -3462,7 +3462,7 @@ so it can only contain letters, digits, or the `_` (underscore) character.For example, to configure an S3 remote named `mys3:` without a configfile (using unix ways of setting environment variables):-```sh+```console$ export RCLONE_CONFIG_MYS3_TYPE=s3$ export RCLONE_CONFIG_MYS3_ACCESS_KEY_ID=XXX$ export RCLONE_CONFIG_MYS3_SECRET_ACCESS_KEY=XXX@@ -3482,7 +3482,7 @@ You must write the name in uppercase in the environment variable, butas seen from example above it will be listed and can be accessed inlowercase, while you can also refer to the same remote in uppercase:-```sh+```console$ rclone lsd mys3:-1 2016-09-21 12:54:21 -1 my-bucket$ rclone lsd MYS3:@@ -3497,7 +3497,7 @@ set the access key of all remotes using S3, including myS3Crypt.Note also that now rclone has [connection strings](#connection-strings),it is probably easier to use those instead which makes the above example-```sh+```consolerclone lsd :s3,access_key_id=XXX,secret_access_key=XXX:```diff --git a/docs/content/doi.md b/docs/content/doi.mdindex 75fb8fd7b..b4318f085 100644--- a/docs/content/doi.md+++ b/docs/content/doi.md@@ -27,7 +27,7 @@ Paths may be as deep as required, e.g. `remote:directory/subdirectory`.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```diff --git a/docs/content/downloads.md b/docs/content/downloads.mdindex 0d28ae305..32dd0c055 100644--- a/docs/content/downloads.md+++ b/docs/content/downloads.md@@ -56,13 +56,13 @@ signatures on the release.To install rclone on Linux/macOS/BSD systems, run:-```sh+```consolesudo -v ; curl https://rclone.org/install.sh | sudo bash```For beta installation, run:-```sh+```consolesudo -v ; curl https://rclone.org/install.sh | sudo bash -s beta```diff --git a/docs/content/drive.md b/docs/content/drive.mdindex 5b3579635..5153f89f5 100644--- a/docs/content/drive.md+++ b/docs/content/drive.md@@ -18,7 +18,7 @@ through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -110,19 +110,19 @@ You can then use it like this,List directories in top level of your drive-```sh+```consolerclone lsd remote:```List all the files in your drive-```sh+```consolerclone ls remote:```To copy a local directory to a drive directory called backup-```sh+```consolerclone copy /home/source remote:backup```@@ -270,7 +270,7 @@ account key" button.##### 3. Configure rclone, assuming a new install-```sh+```textrclone confign/s/q> n # New@@ -375,7 +375,7 @@ It will use the `--checkers` value to specify the number of requests to run inIn tests, these batch requests were up to 20x faster than the regular method.Running the following command against different sized folders gives:-```sh+```consolerclone lsjson -vv -R --checkers=6 gdrive:folder```diff --git a/docs/content/dropbox.md b/docs/content/dropbox.mdindex 327c68b8e..c01bc2892 100644--- a/docs/content/dropbox.md+++ b/docs/content/dropbox.md@@ -19,7 +19,7 @@ through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -73,19 +73,19 @@ You can then use it like this,List directories in top level of your dropbox-```sh+```consolerclone lsd remote:```List all the files in your dropbox-```sh+```consolerclone ls remote:```To copy a local directory to a dropbox directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/faq.md b/docs/content/faq.mdindex e2cb94ac2..be3e43ff5 100644--- a/docs/content/faq.md+++ b/docs/content/faq.md@@ -33,7 +33,7 @@ If you need to configure a remote, see the [config help docs](/docs/#configure).If you are using rclone entirely with [on the fly remotes](/docs/#backend-path-to-dir),you can create an empty config file to get rid of this notice, for example:-```sh+```consolerclone config touch```@@ -48,7 +48,7 @@ The syncs would be incremental (on a file by file basis).e.g.-```sh+```consolerclone sync --interactive drive:Folder s3:bucket```@@ -57,7 +57,7 @@ rclone sync --interactive drive:Folder s3:bucketYou can use rclone from multiple places at the same time if you choosedifferent subdirectory for the output, e.g.-```sh+```consoleServer A> rclone sync --interactive /tmp/whatever remote:ServerAServer B> rclone sync --interactive /tmp/whatever remote:ServerB```@@ -65,7 +65,7 @@ Server B> rclone sync --interactive /tmp/whatever remote:ServerBIf you sync to the same directory then you should use rclone copyotherwise the two instances of rclone may delete each other's files, e.g.-```sh+```consoleServer A> rclone copy /tmp/whatever remote:BackupServer B> rclone copy /tmp/whatever remote:Backup```@@ -119,7 +119,7 @@ may use `http_proxy` but another one `HTTP_PROXY`. The `Go` librariesused by `rclone` will try both variations, but you may wish to set allpossibilities. So, on Linux, you may end up with code similar to-```sh+```consoleexport http_proxy=http://proxyserver:12345export https_proxy=$http_proxyexport HTTP_PROXY=$http_proxy@@ -128,7 +128,7 @@ export HTTPS_PROXY=$http_proxyNote: If the proxy server requires a username and password, then use-```sh+```consoleexport http_proxy=http://username:password@proxyserver:12345export https_proxy=$http_proxyexport HTTP_PROXY=$http_proxy@@ -141,7 +141,7 @@ For instance "foo.com" also matches "bar.foo.com".e.g.-```sh+```consoleexport no_proxy=localhost,127.0.0.0/8,my.host.nameexport NO_PROXY=$no_proxy```@@ -170,7 +170,7 @@ where `rclone` can't verify the server with the SSL root certificates.Rclone (via the Go runtime) tries to load the root certificates fromthese places on Linux.-```sh+```text"/etc/ssl/certs/ca-certificates.crt", // Debian/Ubuntu/Gentoo etc."/etc/pki/tls/certs/ca-bundle.crt", // Fedora/RHEL"/etc/ssl/ca-bundle.pem", // OpenSUSE@@ -180,7 +180,7 @@ these places on Linux.So doing something like this should fix the problem. It also sets thetime which is important for SSL to work properly.-```sh+```consolemkdir -p /etc/ssl/certs/curl -o /etc/ssl/certs/ca-certificates.crt https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crtntpclient -s -h pool.ntp.org@@ -193,7 +193,7 @@ provide the SSL root certificates on Unix systems other than macOS.Note that you may need to add the `--insecure` option to the `curl` command lineif it doesn't work without.-```sh+```consolecurl --insecure -o /etc/ssl/certs/ca-certificates.crt https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt```@@ -202,7 +202,7 @@ On macOS, you can installHomebrew, and specify the SSL root certificates with the[--ca-cert](/docs/#ca-cert-stringarray) flag.-```sh+```consolebrew install ca-certificatesfind $(brew --prefix)/etc/ca-certificates -type f```diff --git a/docs/content/fichier.md b/docs/content/fichier.mdindex 7701de80b..51dc084db 100644--- a/docs/content/fichier.md+++ b/docs/content/fichier.md@@ -21,7 +21,7 @@ which you need to do in your browser.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -68,19 +68,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your 1Fichier account-```sh+```consolerclone lsd remote:```List all the files in your 1Fichier account-```sh+```consolerclone ls remote:```To copy a local directory to a 1Fichier directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/filefabric.md b/docs/content/filefabric.mdindex a2ac93144..e27d30f1a 100644--- a/docs/content/filefabric.md+++ b/docs/content/filefabric.md@@ -19,7 +19,7 @@ do in your browser. `rclone config` walks you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -93,19 +93,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Enterprise File Fabric-```sh+```consolerclone lsd remote:```List all the files in your Enterprise File Fabric-```sh+```consolerclone ls remote:```To copy a local directory to an Enterprise File Fabric directory called backup-```sh+```consolerclone copy /home/source remote:backup```@@ -148,7 +148,7 @@ In order to do this you will have to find the `Folder ID` of thedirectory you wish rclone to display. These aren't displayed in theweb interface, but you can use `rclone lsf` to find them, for example-```sh+```console$ rclone lsf --dirs-only -Fip --csv filefabric:120673758,Burnt PDFs/120673759,My Quick Uploads/diff --git a/docs/content/filelu.md b/docs/content/filelu.mdindex 546b68420..4482d3296 100644--- a/docs/content/filelu.md+++ b/docs/content/filelu.md@@ -18,7 +18,7 @@ device.Here is an example of how to make a remote called `filelu`. First, run:-```sh+```consolerclone config```@@ -56,7 +56,7 @@ A path without an initial `/` will operate in the `Rclone` directory.A path with an initial `/` will operate at the root where you can seethe `Rclone` directory.-```sh+```console$ rclone lsf TestFileLu:/CCTV/Camera/@@ -72,79 +72,79 @@ Videos/Create a new folder named `foldername` in the `Rclone` directory:-```sh+```consolerclone mkdir filelu:foldername```Delete a folder on FileLu:-```sh+```consolerclone rmdir filelu:/folder/path/```Delete a file on FileLu:-```sh+```consolerclone delete filelu:/hello.txt```List files from your FileLu account:-```sh+```consolerclone ls filelu:```List all folders:-```sh+```consolerclone lsd filelu:```Copy a specific file to the FileLu root:-```sh+```consolerclone copy D:\hello.txt filelu:```Copy files from a local directory to a FileLu directory:-```sh+```consolerclone copy D:/local-folder filelu:/remote-folder/path/```Download a file from FileLu into a local directory:-```sh+```consolerclone copy filelu:/file-path/hello.txt D:/local-folder```Move files from a local directory to a FileLu directory:-```sh+```consolerclone move D:\local-folder filelu:/remote-path/```Sync files from a local directory to a FileLu directory:-```sh+```consolerclone sync --interactive D:/local-folder filelu:/remote-path/```Mount remote to local Linux:-```sh+```consolerclone mount filelu: /root/mnt --vfs-cache-mode full```Mount remote to local Windows:-```sh+```consolerclone mount filelu: D:/local_mnt --vfs-cache-mode full```Get storage info about the FileLu account:-```sh+```consolerclone about filelu:```diff --git a/docs/content/filescom.md b/docs/content/filescom.mdindex 56d1a2e89..ca3eabea6 100644--- a/docs/content/filescom.md+++ b/docs/content/filescom.md@@ -19,7 +19,7 @@ password. Alternatively, you can authenticate using an API Key fromHere is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -88,26 +88,26 @@ Once configured you can use rclone.See all files in the top level:-```sh+```consolerclone lsf remote:```Make a new directory in the root:-```sh+```consolerclone mkdir remote:dir```Recursively List the contents:-```sh+```consolerclone ls remote:```Sync `/home/local/directory` to the remote directory, deleting anyexcess files in the directory.-```sh+```consolerclone sync --interactive /home/local/directory remote:dir```diff --git a/docs/content/filtering.md b/docs/content/filtering.mdindex 319dccf5b..8c587c968 100644--- a/docs/content/filtering.md+++ b/docs/content/filtering.md@@ -468,14 +468,14 @@ E.g. `rclone ls remote: --include "*.{png,jpg}"` lists the files onE.g. multiple rclone copy commands can be combined with `--include` and apattern-list.-```sh+```consolerclone copy /vol1/A remote:Arclone copy /vol1/B remote:B```is equivalent to:-```sh+```consolerclone copy /vol1 remote: --include "{A,B}/**"```@@ -677,7 +677,7 @@ user2/prefectThen copy these to a remote:-```sh+```consolerclone copy --files-from files-from.txt /home remote:backup```@@ -699,7 +699,7 @@ Alternatively if `/` is chosen as root `files-from.txt` will be:The copy command will be:-```sh+```consolerclone copy --files-from files-from.txt / remote:backup```@@ -805,7 +805,7 @@ useful for:The flag takes two parameters expressed as a fraction:-```sh+```text--hash-filter K/N```@@ -824,7 +824,7 @@ Each partition is non-overlapping, ensuring all files are covered without duplicUse `@` as `K` to randomly select a partition:-```sh+```text--hash-filter @/M```@@ -854,7 +854,7 @@ This will stay constant across retries.Assuming the current directory contains `file1.jpg` through `file9.jpg`:-```sh+```console$ rclone lsf --hash-filter 0/4 .file1.jpgfile5.jpg@@ -879,13 +879,13 @@ file5.jpg##### Syncing the first quarter of files-```sh+```consolerclone sync --hash-filter 1/4 source:path destination:path```##### Checking a random 1% of files for integrity-```sh+```consolerclone check --download --hash-filter @/100 source:path destination:path```@@ -901,7 +901,7 @@ on the destination which are excluded from the command.E.g. the scope of `rclone sync --interactive A: B:` can be restricted:-```sh+```consolerclone --min-size 50k --delete-excluded sync A: B:```@@ -950,13 +950,13 @@ expressions](#regexp).For example if you wished to list only local files with a mode of`100664` you could do that with:-```sh+```consolerclone lsf -M --files-only --metadata-include "mode=100664" .```Or if you wished to show files with an `atime`, `mtime` or `btime` at a given date:-```sh+```consolerclone lsf -M --files-only --metadata-include "[abm]time=2022-12-16*" .```diff --git a/docs/content/ftp.md b/docs/content/ftp.mdindex 638ec2f9e..137b82fb7 100644--- a/docs/content/ftp.md+++ b/docs/content/ftp.md@@ -20,7 +20,7 @@ a `/` it is relative to the home directory of the user. An empty pathTo create an FTP configuration named `remote`, run-```sh+```consolerclone config```@@ -88,26 +88,26 @@ y/e/d> yTo see all directories in the home directory of `remote`-```sh+```consolerclone lsd remote:```Make a new directory-```sh+```consolerclone mkdir remote:path/to/directory```List the contents of a directory-```sh+```consolerclone ls remote:path/to/directory```Sync `/home/local/directory` to the remote directory, deleting anyexcess files in the directory.-```sh+```consolerclone sync --interactive /home/local/directory remote:directory```@@ -124,7 +124,7 @@ Using [on-the-fly](#backend-path-to-dir) orsuch servers, without requiring any configuration in advance. The followingare examples of that:-```sh+```consolerclone lsf :ftp: --ftp-host=speedtest.tele2.net --ftp-user=anonymous --ftp-pass=$(rclone obscure dummy)rclone lsf :ftp,host=speedtest.tele2.net,user=anonymous,pass=$(rclone obscure dummy):```@@ -136,7 +136,7 @@ command to create a password string in the format required by thean already obscured string representation of the same password "dummy", andtherefore works even in Windows Command Prompt:-```sh+```consolerclone lsf :ftp: --ftp-host=speedtest.tele2.net --ftp-user=anonymous --ftp-pass=IXs2wc8OJOz7SYLBk47Ji1rHTmxMrclone lsf :ftp,host=speedtest.tele2.net,user=anonymous,pass=IXs2wc8OJOz7SYLBk47Ji1rHTmxM:```diff --git a/docs/content/gofile.md b/docs/content/gofile.mdindex 6d37101c7..2594e8b18 100644--- a/docs/content/gofile.md+++ b/docs/content/gofile.md@@ -21,7 +21,7 @@ premium account.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -70,13 +70,13 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories and files in the top level of your Gofile-```sh+```consolerclone lsf remote:```To copy a local directory to an Gofile directory called backup-```sh+```consolerclone copy /home/source remote:backup```@@ -139,7 +139,7 @@ directory you wish rclone to display.You can do this with rclone-```sh+```console$ rclone lsf -Fip --dirs-only remote:d6341f53-ee65-4f29-9f59-d11e8070b2a0;Files/f4f5c9b8-6ece-478b-b03e-4538edfe5a1c;Photos/diff --git a/docs/content/googlecloudstorage.md b/docs/content/googlecloudstorage.mdindex fbd47f42a..f3eef23cd 100644--- a/docs/content/googlecloudstorage.md+++ b/docs/content/googlecloudstorage.md@@ -17,7 +17,7 @@ through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -163,26 +163,26 @@ This remote is called `remote` and can now be used like thisSee all the buckets in your project-```sh+```consolerclone lsd remote:```Make a new bucket-```sh+```consolerclone mkdir remote:bucket```List the contents of a bucket-```sh+```consolerclone ls remote:bucket```Sync `/home/local/directory` to the remote bucket, deleting any excessfiles in the bucket.-```sh+```consolerclone sync --interactive /home/local/directory remote:bucket```@@ -224,7 +224,7 @@ If you already have a working service account, skip to step 3.#### 1. Create a service account using-```sh+```consolegcloud iam service-accounts create gcs-read-only```@@ -232,7 +232,7 @@ You can re-use an existing service account as well (like the one created above)#### 2. Attach a Viewer (read-only) or User (read-write) role to the service account-```sh+```console$ PROJECT_ID=my-project$ gcloud --verbose iam service-accounts add-iam-policy-binding \gcs-read-only@${PROJECT_ID}.iam.gserviceaccount.com \@@ -249,7 +249,7 @@ pre-defined roles:#### 3. Get a temporary access key for the service account-```sh+```console$ gcloud auth application-default print-access-token \--impersonate-service-account \gcs-read-only@${PROJECT_ID}.iam.gserviceaccount.com@@ -262,13 +262,13 @@ ya29.c.c0ASRK0GbAFEewXD [truncated]hit `CTRL-C` when you see *waiting for code*. This will save the config withoutdoing oauth flow-```sh+```consolerclone config update ${REMOTE_NAME} access_token ya29.c.c0Axxxx```#### 5. Run rclone as usual-```sh+```consolerclone ls dev-gcs:${MY_BUCKET}/```diff --git a/docs/content/googlephotos.md b/docs/content/googlephotos.mdindex 2b87b235a..a440c84c6 100644--- a/docs/content/googlephotos.md+++ b/docs/content/googlephotos.md@@ -27,7 +27,7 @@ through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -111,26 +111,26 @@ This remote is called `remote` and can now be used like thisSee all the albums in your photos-```sh+```consolerclone lsd remote:album```Make a new album-```sh+```consolerclone mkdir remote:album/newAlbum```List the contents of an album-```sh+```consolerclone ls remote:album/newAlbum```Sync `/home/local/images` to the Google Photos, removing any excessfiles in the album.-```sh+```consolerclone sync --interactive /home/local/image remote:album/newAlbum```@@ -213,7 +213,7 @@ may create new directories (albums) under `album`. If you copy fileswith a directory hierarchy in there then rclone will create albumswith the `/` character in them. For example if you do-```sh+```consolerclone copy /path/to/images remote:album/images```diff --git a/docs/content/gui.md b/docs/content/gui.mdindex d0c72beb8..65abc63a7 100644--- a/docs/content/gui.md+++ b/docs/content/gui.md@@ -13,7 +13,7 @@ change.Run this command in a terminal and rclone will download and thendisplay the GUI in a web browser.-```sh+```consolerclone rcd --rc-web-gui```diff --git a/docs/content/hasher.md b/docs/content/hasher.mdindex 2d483d67f..ccfc141e1 100644--- a/docs/content/hasher.md+++ b/docs/content/hasher.md@@ -115,9 +115,8 @@ Now you can use it as `Hasher2:subdir/file` instead of base remote.Hasher will transparently update cache with new checksums when a fileis fully read or overwritten, like:-```sh+```consolerclone copy External:path/file Hasher:dest/path-rclone cat Hasher:path/to/file > /dev/null```@@ -126,17 +125,15 @@ for a subtree is to **re-download** all files in the subtree. For example,use `hashsum --download` using **any** supported hashsum on the command line(we just care to re-read):-```sh+```consolerclone hashsum MD5 --download Hasher:path/to/subtree > /dev/null-rclone backend dump Hasher:path/to/subtree```You can print or drop hashsum cache using custom backend commands:-```sh+```consolerclone backend dump Hasher:dir/subdir-rclone backend drop Hasher:```@@ -145,7 +142,7 @@ rclone backend drop Hasher:Hasher supports two backend commands: generic SUM file `import` and fasterbut less consistent `stickyimport`.-```sh+```consolerclone backend import Hasher:dir/subdir SHA1 /path/to/SHA1SUM [--checkers 4]```@@ -165,7 +162,7 @@ correspondingly.`--checkers` to make it faster. Or use `stickyimport` if you don't careabout fingerprints and consistency.-```sh+```consolerclone backend stickyimport hasher:path/to/data sha1 remote:/path/to/sum.sha1```diff --git a/docs/content/hdfs.md b/docs/content/hdfs.mdindex 005228c16..70c4d505e 100644--- a/docs/content/hdfs.md+++ b/docs/content/hdfs.md@@ -16,7 +16,7 @@ Paths are specified as `remote:` or `remote:path/to/dir`.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -86,19 +86,19 @@ This remote is called `remote` and can now be used like thisSee all the top level directories-```sh+```consolerclone lsd remote:```List the contents of a directory-```sh+```consolerclone ls remote:directory```Sync the remote `directory` to `/home/local/directory`, deleting any excess files.-```sh+```consolerclone sync --interactive remote:directory /home/local/directory```@@ -109,7 +109,7 @@ or use the docker image from the tests:If you want to build the docker image-```sh+```consolegit clone https://github.com/rclone/rclone.gitcd rclone/fstest/testserver/images/test-hdfsdocker build --rm -t rclone/test-hdfs .@@ -117,7 +117,7 @@ docker build --rm -t rclone/test-hdfs .Or you can just use the latest one pushed-```sh+```consoledocker run --rm --name "rclone-hdfs" -p 127.0.0.1:9866:9866 -p 127.0.0.1:8020:8020 --hostname "rclone-hdfs" rclone/test-hdfs```diff --git a/docs/content/hidrive.md b/docs/content/hidrive.mdindex 316b0c073..6de047f0b 100644--- a/docs/content/hidrive.md+++ b/docs/content/hidrive.md@@ -18,7 +18,7 @@ which you need to do in your browser.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -85,19 +85,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your HiDrive root folder-```sh+```consolerclone lsd remote:```List all the files in your HiDrive filesystem-```sh+```consolerclone ls remote:```To copy a local directory to a HiDrive directory called backup-```sh+```consolerclone copy /home/source remote:backup```@@ -129,7 +129,7 @@ To fix this you will need to authorize rclone to access your HiDrive account agaUsing-```sh+```consolerclone config reconnect remote:```@@ -188,7 +188,7 @@ This works by prepending the contents of the `root_prefix` optionto any paths accessed by rclone.For example, the following two ways to access the home directory are equivalent:-```sh+```consolerclone lsd --hidrive-root-prefix="/users/test/" remote:pathrclone lsd remote:/users/test/path```diff --git a/docs/content/http.md b/docs/content/http.mdindex 2f6aee587..5a79ac8ba 100644--- a/docs/content/http.md+++ b/docs/content/http.md@@ -39,7 +39,7 @@ To just download a single file it is easier to useHere is an example of how to make a remote called `remote`. Firstrun:-```sh+```consolerclone config```@@ -94,19 +94,19 @@ This remote is called `remote` and can now be used like thisSee all the top level directories-```sh+```consolerclone lsd remote:```List the contents of a directory-```sh+```consolerclone ls remote:directory```Sync the remote `directory` to `/home/local/directory`, deleting any excess files.-```sh+```consolerclone sync --interactive remote:directory /home/local/directory```@@ -127,13 +127,13 @@ No checksums are stored.Since the http remote only has one config parameter it is easy to usewithout a config file:-```sh+```consolerclone lsd --http-url https://beta.rclone.org :http:```or:-```sh+```consolerclone lsd :http,url='https://beta.rclone.org':```diff --git a/docs/content/iclouddrive.md b/docs/content/iclouddrive.mdindex d3e60f336..18cfebf12 100644--- a/docs/content/iclouddrive.md+++ b/docs/content/iclouddrive.md@@ -22,7 +22,7 @@ or `rclone config`.Here is an example of how to make a remote called `iclouddrive`. First run:-```sh+```consolerclone config```diff --git a/docs/content/imagekit.md b/docs/content/imagekit.mdindex ffa4f39a9..7792ace58 100644--- a/docs/content/imagekit.md+++ b/docs/content/imagekit.md@@ -27,7 +27,7 @@ from the developer section.Now run-```sh+```consolerclone config```@@ -88,19 +88,19 @@ y/e/d> yList directories in the top level of your Media Library-```sh+```consolerclone lsd imagekit-media-library:```Make a new directory.-```sh+```consolerclone mkdir imagekit-media-library:directory```List the contents of a directory.-```sh+```consolerclone ls imagekit-media-library:directory```diff --git a/docs/content/install.md b/docs/content/install.mdindex b276dffdb..4b50b049e 100644--- a/docs/content/install.md+++ b/docs/content/install.md@@ -29,13 +29,13 @@ signatures on the release.To install rclone on Linux/macOS/BSD systems, run:-```sh+```consolesudo -v ; curl https://rclone.org/install.sh | sudo bash```For beta installation, run:-```sh+```consolesudo -v ; curl https://rclone.org/install.sh | sudo bash -s beta```@@ -48,7 +48,7 @@ won't re-download if not needed.Fetch and unpack-```sh+```consolecurl -O https://downloads.rclone.org/rclone-current-linux-amd64.zipunzip rclone-current-linux-amd64.zipcd rclone-*-linux-amd64@@ -56,7 +56,7 @@ cd rclone-*-linux-amd64Copy binary file-```sh+```consolesudo cp rclone /usr/bin/sudo chown root:root /usr/bin/rclonesudo chmod 755 /usr/bin/rclone@@ -64,7 +64,7 @@ sudo chmod 755 /usr/bin/rcloneInstall manpage-```sh+```consolesudo mkdir -p /usr/local/share/man/man1sudo cp rclone.1 /usr/local/share/man/man1/sudo mandb@@ -72,7 +72,7 @@ sudo mandbRun `rclone config` to setup. See [rclone config docs](/docs/) for more details.-```sh+```consolerclone config```@@ -80,7 +80,7 @@ rclone config### Installation with brew {#macos-brew}-```sh+```consolebrew install rclone```@@ -98,7 +98,7 @@ developers so it may be out of date. Its current version is as below.On macOS, rclone can also be installed via [MacPorts](https://www.macports.org):-```sh+```consolesudo port install rclone```@@ -116,19 +116,19 @@ notarized it is enough to download with `curl`.Download the latest version of rclone.-```sh+```consolecd && curl -O https://downloads.rclone.org/rclone-current-osx-amd64.zip```Unzip the download and cd to the extracted folder.-```sh+```consoleunzip -a rclone-current-osx-amd64.zip && cd rclone-*-osx-amd64```Move rclone to your $PATH. You will be prompted for your password.-```sh+```consolesudo mkdir -p /usr/local/binsudo mv rclone /usr/local/bin/```@@ -137,13 +137,13 @@ sudo mv rclone /usr/local/bin/Remove the leftover files.-```sh+```consolecd .. && rm -rf rclone-*-osx-amd64 rclone-current-osx-amd64.zip```Run `rclone config` to setup. See [rclone config docs](/docs/) for more details.-```sh+```consolerclone config```@@ -153,14 +153,14 @@ When downloading a binary with a web browser, the browser will set the macOSgatekeeper quarantine attribute. Starting from Catalina, when attempting to run`rclone`, a pop-up will appear saying:-```sh+```text"rclone" cannot be opened because the developer cannot be verified.macOS cannot verify that this app is free from malware.```The simplest fix is to run-```sh+```consolexattr -d com.apple.quarantine rclone```@@ -274,7 +274,7 @@ The `:latest` tag will always point to the latest stable release. Youcan use the `:beta` tag to get the latest build from master. You canalso use version tags, e.g. `:1.49.1`, `:1.49` or `:1`.-```sh+```console$ docker pull rclone/rclone:latestlatest: Pulling from rclone/rcloneDigest: sha256:0e0ced72671989bb837fea8e88578b3fc48371aa45d209663683e24cfdaa0e11@@ -357,7 +357,7 @@ kill %1Make sure you have [Snapd installed](https://snapcraft.io/docs/installing-snapd)-```sh+```consolesudo snap install rclone```@@ -384,7 +384,7 @@ Go version 1.24 or newer is required, the latest release is recommended.You can get it from your package manager, or download it from[golang.org/dl](https://golang.org/dl/). Then you can run the following:-```sh+```consolegit clone https://github.com/rclone/rclone.gitcd rclonego build@@ -398,7 +398,7 @@ in the same folder. As an initial check you can now run `./rclone version`Note that on macOS and Windows the [mount](https://rclone.org/commands/rclone_mount/)command will not be available unless you specify an additional build tag `cmount`.-```sh+```consolego build -tags cmount```@@ -424,7 +424,7 @@ You may add arguments `-ldflags -s` to omit symbol table and debug information,making the executable file smaller, and `-trimpath` to remove references tolocal file system paths. The official rclone releases are built with both of these.-```sh+```consolego build -trimpath -ldflags -s -tags cmount```@@ -435,7 +435,7 @@ or `fs.VersionSuffix` (to keep default number but customize the suffix).This can be done from the build command, by adding to the `-ldflags`argument value as shown below.-```sh+```consolego build -trimpath -ldflags "-s -X github.com/rclone/rclone/fs.Version=v9.9.9-test" -tags cmount```@@ -446,7 +446,7 @@ It generates a Windows resource system object file, with extension .syso, e.g.`resource_windows_amd64.syso`, that will be automatically picked up byfuture build commands.-```sh+```consolego run bin/resource_windows.go```@@ -458,7 +458,7 @@ override this version variable in the build command as described above, youneed to do that also when generating the resource file, or else it will stilluse the value from the source.-```sh+```consolego run bin/resource_windows.go -version v9.9.9-test```@@ -468,13 +468,13 @@ followed by additional commit details, embeds version information binary resourcon Windows, and copies the resulting rclone executable into your GOPATH bin folder(`$(go env GOPATH)/bin`, which corresponds to `~/go/bin/rclone` by default).-```sh+```consolemake```To include mount command on macOS and Windows with Makefile build:-```sh+```consolemake GOTAGS=cmount```@@ -491,7 +491,7 @@ The source will be stored it in the Go module cache, and the resultingexecutable will be in your GOPATH bin folder (`$(go env GOPATH)/bin`,which corresponds to `~/go/bin/rclone` by default).-```sh+```consolego install github.com/rclone/rclone@latest```diff --git a/docs/content/internetarchive.md b/docs/content/internetarchive.mdindex cd01aa947..119878de1 100644--- a/docs/content/internetarchive.md+++ b/docs/content/internetarchive.md@@ -20,20 +20,20 @@ Once you have made a remote, you can use it like this:Make a new item-```sh+```consolerclone mkdir remote:item```List the contents of a item-```sh+```consolerclone ls remote:item```Sync `/home/local/directory` to the remote item, deleting any excessfiles in the item.-```sh+```consolerclone sync --interactive /home/local/directory remote:item```@@ -95,7 +95,7 @@ changeable, as they are created by the Internet Archive automatically.These auto-created files can be excluded from the sync using [metadatafiltering](/filtering/#metadata).-```sh+```consolerclone sync ... --metadata-exclude "source=metadata" --metadata-exclude "format=Metadata"```@@ -110,7 +110,7 @@ Most applies to the other providers as well, any differences are described [beloFirst run-```sh+```consolerclone config```diff --git a/docs/content/jottacloud.md b/docs/content/jottacloud.mdindex 2268558a9..9a895b95d 100644--- a/docs/content/jottacloud.md+++ b/docs/content/jottacloud.md@@ -178,7 +178,7 @@ supported by rclone, but the support will be removed in a future version.Here is an example of how to make a remote called `remote` with the default setup.First run:-```sh+```consolerclone config```@@ -281,19 +281,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Jottacloud-```sh+```consolerclone lsd remote:```List all the files in your Jottacloud-```sh+```consolerclone ls remote:```To copy a local directory to an Jottacloud directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/koofr.md b/docs/content/koofr.mdindex 8ef9641d1..15470be42 100644--- a/docs/content/koofr.md+++ b/docs/content/koofr.md@@ -19,7 +19,7 @@ giving the password a nice name like `rclone` and clicking on generate.Here is an example of how to make a remote called `koofr`. First run:-```sh+```consolerclone config```@@ -91,19 +91,19 @@ Once configured you can then use `rclone` like this,List directories in top level of your Koofr-```sh+```consolerclone lsd koofr:```List all the files in your Koofr-```sh+```consolerclone ls koofr:```To copy a local directory to an Koofr directory called backup-```sh+```consolerclone copy /home/source koofr:backup```@@ -253,7 +253,7 @@ provides a Koofr API.Here is an example of how to make a remote called `ds`. First run:-```sh+```consolerclone config```@@ -322,7 +322,7 @@ You may also want to use another, public or private storage provider that runs aHere is an example of how to make a remote called `other`. First run:-```sh+```consolerclone config```diff --git a/docs/content/linkbox.md b/docs/content/linkbox.mdindex 2cb877046..5a2076071 100644--- a/docs/content/linkbox.md+++ b/docs/content/linkbox.md@@ -14,7 +14,7 @@ Here is an example of making a remote for Linkbox.First run:-```sh+```consolerclone config```diff --git a/docs/content/local.md b/docs/content/local.mdindex f44a4b1f3..83d5ecc82 100644--- a/docs/content/local.md+++ b/docs/content/local.md@@ -8,7 +8,7 @@ versionIntroduced: "v0.91"Local paths are specified as normal filesystem paths, e.g. `/path/to/wherever`, so-```sh+```consolerclone sync --interactive /home/source /tmp/destination```@@ -184,7 +184,7 @@ This flag applies to all commands.For example, supposing you have a directory structure like this-```sh+```console$ tree /tmp/a/tmp/a├── b -> ../b@@ -196,7 +196,7 @@ $ tree /tmp/aThen you can see the difference with and without the flag like this-```sh+```console$ rclone ls /tmp/a6 one6 two/three@@ -204,7 +204,7 @@ $ rclone ls /tmp/aand-```sh+```console$ rclone -L ls /tmp/a4174 expected6 one@@ -227,7 +227,7 @@ This flag applies to all commands.For example, supposing you have a directory structure like this-```sh+```console$ tree /tmp/a/tmp/a├── file1 -> ./file4@@ -236,13 +236,13 @@ $ tree /tmp/aCopying the entire directory with '-l'-```sh+```consolerclone copy -l /tmp/a/ remote:/tmp/a/```The remote files are created with a `.rclonelink` suffix-```sh+```console$ rclone ls remote:/tmp/a5 file1.rclonelink14 file2.rclonelink@@ -250,7 +250,7 @@ $ rclone ls remote:/tmp/aThe remote files will contain the target of the symbolic links-```sh+```console$ rclone cat remote:/tmp/a/file1.rclonelink./file4@@ -260,7 +260,7 @@ $ rclone cat remote:/tmp/a/file2.rclonelinkCopying them back with '-l'-```sh+```console$ rclone copy -l remote:/tmp/a/ /tmp/b/$ tree /tmp/b@@ -271,7 +271,7 @@ $ tree /tmp/bHowever, if copied back without '-l'-```sh+```console$ rclone copyto remote:/tmp/a/ /tmp/b/$ tree /tmp/b@@ -282,7 +282,7 @@ $ tree /tmp/bIf you want to copy a single file with `-l` then you must use the `.rclonelink` suffix.-```sh+```console$ rclone copy -l remote:/tmp/a/file1.rclonelink /tmp/c$ tree /tmp/c@@ -306,7 +306,7 @@ different file systems.For example if you have a directory hierarchy like this-```sh+```consoleroot├── disk1 - disk1 mounted on the root│ └── file3 - stored on disk1@@ -319,13 +319,13 @@ rootUsing `rclone --one-file-system copy root remote:` will only copy `file1`and `file2`. E.g.-```sh+```console$ rclone -q --one-file-system ls root0 file10 file2```-```sh+```console$ rclone -q ls root0 disk1/file30 disk2/file4diff --git a/docs/content/mailru.md b/docs/content/mailru.mdindex 116ad7b6a..8390204e4 100644--- a/docs/content/mailru.md+++ b/docs/content/mailru.md@@ -48,7 +48,7 @@ give an error like `oauth2: server response missing access_token`.Now run-```sh+```consolerclone config```@@ -119,26 +119,26 @@ You can use the configured backend as shown below:See top level directories-```sh+```consolerclone lsd remote:```Make a new directory-```sh+```consolerclone mkdir remote:directory```List the contents of a directory-```sh+```consolerclone ls remote:directory```Sync `/home/local/directory` to the remote path, deleting anyexcess files in the path.-```sh+```consolerclone sync --interactive /home/local/directory remote:directory```diff --git a/docs/content/mega.md b/docs/content/mega.mdindex 4d61b1794..61e88cc84 100644--- a/docs/content/mega.md+++ b/docs/content/mega.md@@ -27,7 +27,7 @@ Paths may be as deep as required, e.g. `remote:directory/subdirectory`.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -79,19 +79,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Mega-```sh+```consolerclone lsd remote:```List all the files in your Mega-```sh+```consolerclone ls remote:```To copy a local directory to an Mega directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/memory.md b/docs/content/memory.mdindex 269ea3ac9..e1c2a21d1 100644--- a/docs/content/memory.md+++ b/docs/content/memory.md@@ -50,7 +50,7 @@ y/e/d> yBecause the memory backend isn't persistent it is most useful fortesting or with an rclone server or rclone mount, e.g.-```sh+```consolerclone mount :memory: /mnt/tmprclone serve webdav :memory:rclone serve sftp :memory:diff --git a/docs/content/netstorage.md b/docs/content/netstorage.mdindex 65434eb96..ded4a14b1 100644--- a/docs/content/netstorage.md+++ b/docs/content/netstorage.md@@ -18,7 +18,7 @@ For example, this is commonly configured with or without a CP code:See all buckets-```sh+```consolerclone lsd remote:```@@ -31,7 +31,7 @@ Here's an example of how to make a remote called `ns1`.1. To begin the interactive configuration process, enter this command:- ```sh+ ```consolerclone config```@@ -128,25 +128,25 @@ commands, visit <https://rclone.org/commands/>.### See contents of a directory in your project-```sh+```consolerclone lsd ns1:/974012/testing/```### Sync the contents local with remote-```sh+```consolerclone sync . ns1:/974012/testing/```### Upload local content to remote-```sh+```consolerclone copy notes.txt ns1:/974012/testing/```### Delete content on remote-```sh+```consolerclone delete ns1:/974012/testing/notes.txt```@@ -155,7 +155,7 @@ rclone delete ns1:/974012/testing/notes.txtYour credentials must have access to two CP codes on the same remote.You can't perform operations between different remotes.-```sh+```consolerclone move ns1:/974012/testing/notes.txt ns1:/974450/testing2/```diff --git a/docs/content/onedrive.md b/docs/content/onedrive.mdindex b7f77c7f6..da2722aef 100644--- a/docs/content/onedrive.md+++ b/docs/content/onedrive.md@@ -18,7 +18,7 @@ you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -112,19 +112,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your OneDrive-```sh+```consolerclone lsd remote:```List all the files in your OneDrive-```sh+```consolerclone ls remote:```To copy a local directory to an OneDrive directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/opendrive.md b/docs/content/opendrive.mdindex 21fba294e..dfac0aae1 100644--- a/docs/content/opendrive.md+++ b/docs/content/opendrive.md@@ -14,7 +14,7 @@ Paths may be as deep as required, e.g. `remote:directory/subdirectory`.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -57,19 +57,19 @@ y/e/d> yList directories in top level of your OpenDrive-```sh+```consolerclone lsd remote:```List all the files in your OpenDrive-```sh+```consolerclone ls remote:```To copy a local directory to an OpenDrive directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/oracleobjectstorage/_index.md b/docs/content/oracleobjectstorage/_index.mdindex aad34649c..849b89da5 100644--- a/docs/content/oracleobjectstorage/_index.md+++ b/docs/content/oracleobjectstorage/_index.md@@ -18,7 +18,7 @@ You may put subdirectories in too, e.g. `remote:bucket/path/to/dir`.Sample command to transfer local artifacts to remote:bucket in oracle object storage:-```sh+```consolerclone -vvv --progress --stats-one-line --max-stats-groups 10 --log-format date,time,UTC,longfile --fast-list --buffer-size 256Mi --oos-no-check-bucket --oos-upload-cutoff 10Mi --multi-thread-cutoff 16Mi --multi-thread-streams 3000 --transfers 3000 --checkers 64 --retries 2 --oos-chunk-size 10Mi --oos-upload-concurrency 10000 --oos-attempt-resume-upload --oos-leave-parts-on-error sync ./artifacts remote:bucket -vv```@@ -29,7 +29,7 @@ walks you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -139,19 +139,19 @@ y/e/d> ySee all buckets-```sh+```consolerclone lsd remote:```Create a new bucket-```sh+```consolerclone mkdir remote:bucket```List the contents of a bucket-```sh+```consolerclone ls remote:bucketrclone ls remote:bucket --max-depth 1```@@ -208,7 +208,7 @@ have to be stored and managed.Sample rclone configuration file for Authentication Provider Instance Principal:-```sh+```console[opc@rclone ~]$ cat ~/.config/rclone/rclone.conf[oos]type = oracleobjectstorage@@ -242,7 +242,7 @@ resources that are not compute instances such asTo use resource principal ensure Rclone process is started with these environmentvariables set in its process.-```sh+```consoleexport OCI_RESOURCE_PRINCIPAL_VERSION=2.2export OCI_RESOURCE_PRINCIPAL_REGION=us-ashburn-1export OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM=/usr/share/model-server/key.pem@@ -268,7 +268,7 @@ Workload Identity, see [Granting Workloads Access to OCI Resources](https://docsTo use workload identity, ensure Rclone is started with these environmentvariables set in its process.-```sh+```consoleexport OCI_RESOURCE_PRINCIPAL_VERSION=2.2export OCI_RESOURCE_PRINCIPAL_REGION=us-ashburn-1```diff --git a/docs/content/oracleobjectstorage/tutorial_mount.md b/docs/content/oracleobjectstorage/tutorial_mount.mdindex e24c50f17..c50937dfa 100644--- a/docs/content/oracleobjectstorage/tutorial_mount.md+++ b/docs/content/oracleobjectstorage/tutorial_mount.md@@ -21,7 +21,7 @@ In oracle linux 8, Rclone can be installed from[OL8_Developer](https://yum.oracle.com/repo/OracleLinux/OL8/developer/x86_64/index.html)Yum Repo, Please enable the repo if not enabled already.-```sh+```console[opc@base-inst-boot ~]$ sudo yum-config-manager --enable ol8_developer[opc@base-inst-boot ~]$ sudo yum install -y rclone[opc@base-inst-boot ~]$ sudo yum install -y fuse@@ -48,7 +48,7 @@ To run it as a mount helper you should symlink rclone binary to /sbin/mount.rcloand optionally /usr/bin/rclonefs, e.g. `ln -s /usr/bin/rclone /sbin/mount.rclone`.rclone will detect it and translate command-line arguments appropriately.-```sh+```consoleln -s /usr/bin/rclone /sbin/mount.rclone```@@ -65,7 +65,7 @@ Rclone configuration file needs to have 3 remote sections, one section of eachof above 3 buckets. Create a configuration file in a accessible location thatrclone program can read.-```sh+```console[opc@base-inst-boot ~]$ mkdir -p /etc/rclone[opc@base-inst-boot ~]$ sudo touch /etc/rclone/rclone.conf@@ -135,7 +135,7 @@ Create a dynamic group say rclone-dynamic-group that the oci compute instancebecomes a member of the below group says all instances belonging to compartmenta...c is member of this dynamic-group.-```sh+```consoleany {instance.compartment.id = '<compartment_ocid_a>',instance.compartment.id = '<compartment_ocid_b>',instance.compartment.id = '<compartment_ocid_c>'@@ -146,7 +146,7 @@ Now that you have a dynamic group, you need to add a policy allowing whatpermissions this dynamic-group has. In our case, we want this dynamic-group toaccess object-storage. So create a policy now.-```sh+```textallow dynamic-group rclone-dynamic-group to manage object-family in compartment compartment-aallow dynamic-group rclone-dynamic-group to manage object-family in compartment compartment-ballow dynamic-group rclone-dynamic-group to manage object-family in compartment compartment-c@@ -157,19 +157,20 @@ if not please troubleshoot any mistakes you did so far. Please note, identitycan take upto a minute to ensure policy gets reflected.## Step 4: Setup Mount Folders+Let's assume you have to mount 3 buckets, bucket-a, bucket-b, bucket-c at path/opt/mnt/bucket-a, /opt/mnt/bucket-b, /opt/mnt/bucket-c respectively.Create the mount folder and set its ownership to desired user, group.-```sh+```console[opc@base-inst-boot ~]$ sudo mkdir /opt/mnt[opc@base-inst-boot ~]$ sudo chown -R opc:adm /opt/mnt```Set chmod permissions to user, group, others as desired for each mount path-```sh+```console[opc@base-inst-boot ~]$ sudo chmod 764 /opt/mnt[opc@base-inst-boot ~]$ ls -al /opt/mnt/total 0@@ -205,7 +206,7 @@ for solutions to make mount more reliable.First lets understand the rclone mount flags and some global flags for troubleshooting.-```sh+```consolerclone mount \ossa:bucket-a \ # Remote:bucket-name/opt/mnt/bucket-a \ # Local mount folder@@ -289,7 +290,7 @@ changed relative to a remote file. Fingerprints are made from:Add this entry in /etc/fstab:-```sh+```textossa:bucket-a /opt/mnt/bucket-a rclone rw,umask=0117,nofail,_netdev,args2env,config=/etc/rclone/rclone.conf,uid=1000,gid=4,file_perms=0760,dir_perms=0760,allow_other,vfs_cache_mode=writes,cache_dir=/tmp/rclone/cache 0 0```@@ -303,7 +304,7 @@ quotes of the same type should be doubled.Then run sudo mount -av-```sh+```console[opc@base-inst-boot ~]$ sudo mount -av/ : ignored/boot : already mounted@@ -320,7 +321,7 @@ If you are familiar with configuring systemd unit files, you can also configurethe each rclone mount into a systemd units file.various examples in git search: <https://github.com/search?l=Shell&q=rclone+unit&type=Code>-```sh+```consoletee "/etc/systemd/system/rclonebucketa.service" > /dev/null <<EOF[Unit]Description=RCloneMounting@@ -345,7 +346,7 @@ Sometimes, rclone process crashes and the mount points are left in danglingstate where its mounted but the rclone mount process is gone. To clean up themount point you can force unmount by running this command.-```sh+```consolesudo fusermount -uz /opt/mnt/bucket-a```@@ -381,7 +382,7 @@ echo "Finished creating rclone nanny cron job."Ensure the crontab is added, so that above nanny script runs every 5 minutes.-```sh+```console[opc@base-inst-boot ~]$ sudo crontab -l*/5 * * * * /etc/rclone/scripts/rclone_nanny_script.sh[opc@base-inst-boot ~]$@@ -396,7 +397,7 @@ as a NFS server export so that other clients can access it by using a NFS clientInstall NFS Utils-```sh+```consolesudo yum install -y nfs-utils```diff --git a/docs/content/overview.md b/docs/content/overview.mdindex c6fc56e40..68cf44895 100644--- a/docs/content/overview.md+++ b/docs/content/overview.md@@ -405,7 +405,7 @@ and to maintain backward compatibility, its behavior has not been changed.To take a specific example, the FTP backend's default encoding is-```sh+```text--ftp-encoding "Slash,Del,Ctl,RightSpace,Dot"```@@ -439,7 +439,7 @@ To avoid this you can change the set of characters rclone should convertfor the local filesystem, using command-line argument `--local-encoding`.Rclone's default behavior on Windows corresponds to-```sh+```text--local-encoding "Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot"```@@ -447,7 +447,7 @@ If you want to use fullwidth characters `:`, `*` and `?` in your filenameswithout rclone changing them when uploading to a remote, then set the same asthe default value but without `Colon,Question,Asterisk`:-```sh+```text--local-encoding "Slash,LtGt,DoubleQuote,Pipe,BackSlash,Ctl,RightSpace,RightPeriod,InvalidUtf8,Dot"```diff --git a/docs/content/pcloud.md b/docs/content/pcloud.mdindex 902e0570a..7cd3254d0 100644--- a/docs/content/pcloud.md+++ b/docs/content/pcloud.md@@ -17,7 +17,7 @@ need to do in your browser. `rclone config` walks you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -87,19 +87,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your pCloud-```sh+```consolerclone lsd remote:```List all the files in your pCloud-```sh+```consolerclone ls remote:```To copy a local directory to a pCloud directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/pikpak.md b/docs/content/pikpak.mdindex 9f438b480..38477cab7 100644--- a/docs/content/pikpak.md+++ b/docs/content/pikpak.md@@ -16,7 +16,7 @@ Here is an example of making a remote for PikPak.First run:-```sh+```consolerclone config```diff --git a/docs/content/premiumizeme.md b/docs/content/premiumizeme.mdindex 194b49f7e..8488a29df 100644--- a/docs/content/premiumizeme.md+++ b/docs/content/premiumizeme.md@@ -18,7 +18,7 @@ walks you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -77,19 +77,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your premiumize.me-```sh+```consolerclone lsd remote:```List all the files in your premiumize.me-```sh+```consolerclone ls remote:```To copy a local directory to an premiumize.me directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/protondrive.md b/docs/content/protondrive.mdindex b18beaf87..41310c4b8 100644--- a/docs/content/protondrive.md+++ b/docs/content/protondrive.md@@ -31,7 +31,7 @@ Paths may be as deep as required, e.g. `remote:directory/subdirectory`.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -87,19 +87,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Proton Drive-```sh+```consolerclone lsd remote:```List all the files in your Proton Drive-```sh+```consolerclone ls remote:```To copy a local directory to an Proton Drive directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/putio.md b/docs/content/putio.mdindex 64d16a445..ba89f30f3 100644--- a/docs/content/putio.md+++ b/docs/content/putio.md@@ -19,7 +19,7 @@ through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -94,19 +94,19 @@ You can then use it like this,List directories in top level of your put.io-```sh+```consolerclone lsd remote:```List all the files in your put.io-```sh+```consolerclone ls remote:```To copy a local directory to a put.io directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/qingstor.md b/docs/content/qingstor.mdindex 9540849cf..9b0ae5031 100644--- a/docs/content/qingstor.md+++ b/docs/content/qingstor.md@@ -13,7 +13,7 @@ command.) You may put subdirectories in too, e.g. `remote:bucket/path/to/dir`.Here is an example of making an QingStor configuration. First run-```sh+```consolerclone config```@@ -82,26 +82,26 @@ This remote is called `remote` and can now be used like thisSee all buckets-```sh+```consolerclone lsd remote:```Make a new bucket-```sh+```consolerclone mkdir remote:bucket```List the contents of a bucket-```sh+```consolerclone ls remote:bucket```Sync `/home/local/directory` to the remote bucket, deleting any excessfiles in the bucket.-```sh+```consolerclone sync --interactive /home/local/directory remote:bucket```diff --git a/docs/content/quatrix.md b/docs/content/quatrix.mdindex 74a6cadc7..5fba6a200 100644--- a/docs/content/quatrix.md+++ b/docs/content/quatrix.md@@ -22,7 +22,7 @@ See complete [Swagger documentation for Quatrix](https://docs.maytech.net/quatriHere is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -63,19 +63,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Quatrix-```sh+```consolerclone lsd remote:```List all the files in your Quatrix-```sh+```consolerclone ls remote:```To copy a local directory to an Quatrix directory called backup-```sh+```consolerclone copy /home/source remote:backup```@@ -86,7 +86,7 @@ deactivate it in your account. After disabling, the API Key can be enabled back.If the API Key was deleted and a new key was created, you can update it in rcloneconfig. The same happens if the hostname was changed.-```sh+```console$ rclone configCurrent remotes:diff --git a/docs/content/rc.md b/docs/content/rc.mdindex 23083044f..2d7b6c818 100644--- a/docs/content/rc.md+++ b/docs/content/rc.md@@ -185,7 +185,7 @@ rc` command.You can use it like this:-```sh+```console$ rclone rc rc/noop param1=one param2=two{"param1": "one",@@ -196,14 +196,14 @@ $ rclone rc rc/noop param1=one param2=twoIf the remote is running on a different URL than the default`http://localhost:5572/`, use the `--url` option to specify it:-```sh+```consolerclone rc --url http://some.remote:1234/ rc/noop```Or, if the remote is listening on a Unix socket, use the `--unix-socket` optioninstead:-```sh+```consolerclone rc --unix-socket /tmp/rclone.sock rc/noop```@@ -216,7 +216,7 @@ remote server.`rclone rc` also supports a `--json` flag which can be used to sendmore complicated input parameters.-```sh+```console$ rclone rc --json '{ "p1": [1,"2",null,4], "p2": { "a":1, "b":2 } }' rc/noop{"p1": [@@ -236,13 +236,13 @@ If the parameter being passed is an object then it can be passed as aJSON string rather than using the `--json` flag which simplifies thecommand line.-```sh+```consolerclone rc operations/list fs=/tmp remote=test opt='{"showHash": true}'```Rather than-```sh+```consolerclone rc operations/list --json '{"fs": "/tmp", "remote": "test", "opt": {"showHash": true}}'```@@ -269,7 +269,7 @@ response timing out.Starting a job with the `_async` flag:-```sh+```console$ rclone rc --json '{ "p1": [1,"2",null,4], "p2": { "a":1, "b":2 }, "_async": true }' rc/noop{"jobid": 2@@ -279,7 +279,7 @@ $ rclone rc --json '{ "p1": [1,"2",null,4], "p2": { "a":1, "b":2 }, "_async": trQuery the status to see if the job has finished. For more informationon the meaning of these return parameters see the `job/status` call.-```sh+```console$ rclone rc --json '{ "jobid":2 }' job/status{"duration": 0.000124163,@@ -307,7 +307,7 @@ $ rclone rc --json '{ "jobid":2 }' job/status`job/list` can be used to show the running or recently completed jobs-```sh+```console$ rclone rc job/list{"jobids": [@@ -324,14 +324,14 @@ duration of an rc call only then pass in the `_config` parameter.This should be in the same format as the `main` key returned by[options/get](#options-get).-```sh+```consolerclone rc --loopback options/get blocks=main```You can see more help on these options with this command (see [theoptions blocks section](#option-blocks) for more info).-```sh+```consolerclone rc --loopback options/info blocks=main```@@ -344,7 +344,7 @@ parameter, you would pass this parameter in your JSON blob.If using `rclone rc` this could be passed as-```sh+```consolerclone rc sync/sync ... _config='{"CheckSum": true}'```@@ -371,20 +371,20 @@ pass in the `_filter` parameter.This should be in the same format as the `filter` key returned by[options/get](#options-get).-```sh+```consolerclone rc --loopback options/get blocks=filter```You can see more help on these options with this command (see [theoptions blocks section](#option-blocks) for more info).-```sh+```consolerclone rc --loopback options/info blocks=filter```For example, if you wished to run a sync with these flags-```sh+```text--max-size 1M --max-age 42s --include "a" --include "b"```@@ -396,7 +396,7 @@ you would pass this parameter in your JSON blob.If using `rclone rc` this could be passed as-```sh+```consolerclone rc ... _filter='{"MaxSize":"1M", "IncludeRule":["a","b"], "MaxAge":"42s"}'```@@ -426,7 +426,7 @@ value. This allows caller to group stats under their own name.Stats for specific group can be accessed by passing `group` to `core/stats`:-```sh+```console$ rclone rc --json '{ "group": "job/1" }' core/stats{"speed": 12345@@ -2416,7 +2416,7 @@ The response to a preflight OPTIONS request will echo the requested### Using POST with URL parameters only-```sh+```consolecurl -X POST 'http://localhost:5572/rc/noop?potato=1&sausage=2'```@@ -2431,7 +2431,7 @@ ResponseHere is what an error response looks like:-```sh+```consolecurl -X POST 'http://localhost:5572/rc/error?potato=1&sausage=2'```@@ -2447,7 +2447,7 @@ curl -X POST 'http://localhost:5572/rc/error?potato=1&sausage=2'Note that curl doesn't return errors to the shell unless you use the `-f` option-```sh+```console$ curl -f -X POST 'http://localhost:5572/rc/error?potato=1&sausage=2'curl: (22) The requested URL returned error: 400 Bad Request$ echo $?@@ -2456,7 +2456,7 @@ $ echo $?### Using POST with a form-```sh+```consolecurl --data "potato=1" --data "sausage=2" http://localhost:5572/rc/noop```@@ -2472,7 +2472,7 @@ ResponseNote that you can combine these with URL parameters too with the POSTparameters taking precedence.-```sh+```consolecurl --data "potato=1" --data "sausage=2" "http://localhost:5572/rc/noop?rutabaga=3&sausage=4"```@@ -2489,7 +2489,7 @@ Response### Using POST with a JSON blob-```sh+```consolecurl -H "Content-Type: application/json" -X POST -d '{"potato":2,"sausage":1}' http://localhost:5572/rc/noop```@@ -2505,7 +2505,7 @@ responseThis can be combined with URL parameters too if required. The JSONblob takes precedence.-```sh+```consolecurl -H "Content-Type: application/json" -X POST -d '{"potato":2,"sausage":1}' 'http://localhost:5572/rc/noop?rutabaga=3&potato=4'```@@ -2528,7 +2528,7 @@ To use these, first [install go](https://golang.org/doc/install).To profile rclone's memory use you can run:-```sh+```consolego tool pprof -web http://localhost:5572/debug/pprof/heap```@@ -2537,7 +2537,7 @@ memory.You can also use the `-text` flag to produce a textual summary-```sh+```console$ go tool pprof -text http://localhost:5572/debug/pprof/heapShowing nodes accounting for 1537.03kB, 100% of 1537.03kB totalflat flat% sum% cum cum%@@ -2562,7 +2562,7 @@ alive which should have been garbage collected.See all active go routines using-```sh+```consolecurl http://localhost:5572/debug/pprof/goroutine?debug=1```diff --git a/docs/content/release_signing.md b/docs/content/release_signing.mdindex 64a2ff6cd..2a75969cf 100644--- a/docs/content/release_signing.md+++ b/docs/content/release_signing.md@@ -44,7 +44,7 @@ developers at once.In the release directory you will see the release files and some filescalled `MD5SUMS`, `SHA1SUMS` and `SHA256SUMS`.-```sh+```console$ rclone lsf --http-url https://downloads.rclone.org/v1.63.1 :http:MD5SUMSSHA1SUMS@@ -62,7 +62,7 @@ binary files in the release directory along with a signature.For example:-```sh+```console$ rclone cat --http-url https://downloads.rclone.org/v1.63.1 :http:SHA256SUMS-----BEGIN PGP SIGNED MESSAGE-----Hash: SHA1@@ -90,7 +90,7 @@ as these are the most secure. You could verify the other types of hashalso for extra security. `rclone selfupdate` verifies just the`SHA256SUMS`.-```sh+```consolemkdir /tmp/checkcd /tmp/checkrclone copy --http-url https://downloads.rclone.org/v1.63.1 :http:SHA256SUMS .@@ -103,7 +103,7 @@ First verify the signatures on the SHA256 file.Import the key. See above for ways to verify this key is correct.-```sh+```console$ gpg --keyserver keyserver.ubuntu.com --receive-keys FBF737ECE9F8AB18604BD2AC93935E02FF3B54FAgpg: key 93935E02FF3B54FA: public key "Nick Craig-Wood <[email protected]>" importedgpg: Total number processed: 1@@ -112,7 +112,7 @@ gpg: imported: 1Then check the signature:-```sh+```console$ gpg --verify SHA256SUMSgpg: Signature made Mon 17 Jul 2023 15:03:17 BSTgpg: using DSA key FBF737ECE9F8AB18604BD2AC93935E02FF3B54FA@@ -128,14 +128,14 @@ Repeat for `MD5SUMS` and `SHA1SUMS` if desired.Now that we know the signatures on the hashes are OK we can verify thebinaries match the hashes, completing the verification.-```sh+```console$ sha256sum -c SHA256SUMS 2>&1 | grep OKrclone-v1.63.1-windows-amd64.zip: OK```Or do the check with rclone-```sh+```console$ rclone hashsum sha256 -C SHA256SUMS rclone-v1.63.1-windows-amd64.zip2023/09/11 10:53:58 NOTICE: SHA256SUMS: improperly formatted checksum line 02023/09/11 10:53:58 NOTICE: SHA256SUMS: improperly formatted checksum line 1@@ -150,7 +150,7 @@ $ rclone hashsum sha256 -C SHA256SUMS rclone-v1.63.1-windows-amd64.zipYou can verify the signatures and hashes in one command line like this:-```sh+```console$ h=$(gpg --decrypt SHA256SUMS) && echo "$h" | sha256sum - -c --ignore-missinggpg: Signature made Mon 17 Jul 2023 15:03:17 BSTgpg: using DSA key FBF737ECE9F8AB18604BD2AC93935E02FF3B54FAdiff --git a/docs/content/remote_setup.md b/docs/content/remote_setup.mdindex e5c1cd052..3e3a68c0b 100644--- a/docs/content/remote_setup.md+++ b/docs/content/remote_setup.md@@ -81,13 +81,13 @@ sure).Start by running [rclone config](/commands/rclone_config) to create theconfiguration file on your desktop machine.-```sh+```consolerclone config```Then locate the file by running [rclone config file](/commands/rclone_config_file).-```sh+```console$ rclone config fileConfiguration file is stored at:/home/user/.rclone.conf@@ -103,7 +103,7 @@ If you have an SSH client installed on your local machine, you can set up anSSH tunnel to redirect the port 53682 into the headless machine by using thefollowing command:-```sh+```consolessh -L localhost:53682:localhost:53682 username@remote_server```diff --git a/docs/content/s3.md b/docs/content/s3.mdindex 51a034a4e..12a254d2b 100644--- a/docs/content/s3.md+++ b/docs/content/s3.md@@ -68,26 +68,26 @@ you can use it like this:See all buckets-```sh+```consolerclone lsd remote:```Make a new bucket-```sh+```consolerclone mkdir remote:bucket```List the contents of a bucket-```sh+```consolerclone ls remote:bucket```Sync `/home/local/directory` to the remote bucket, deleting any excessfiles in the bucket.-```sh+```consolerclone sync --interactive /home/local/directory remote:bucket```@@ -98,7 +98,7 @@ Most applies to the other providers as well, any differences are described [beloFirst run-```sh+```consolerclone config```@@ -329,7 +329,7 @@ metadata `X-Amz-Meta-Md5chksum` which is a base64 encoded MD5 hash (inthe same format as is required for `Content-MD5`). You can use base64 -d andhexdump to check this value manually:-```sh+```consoleecho 'VWTGdNx3LyXQDfA0e2Edxw==' | base64 -d | hexdump```@@ -404,7 +404,7 @@ individually. This takes one API call per directory. Using thememory first using a smaller number of API calls (one per 1000objects). See the [rclone docs](/docs/#fast-list) for more details.-```sh+```consolerclone sync --fast-list --checksum /path/to/source s3:bucket```@@ -419,7 +419,7 @@ instead of through directory listings. You can do a "top-up" sync verycheaply by using `--max-age` and `--no-traverse` to copy only recentfiles, eg-```sh+```consolerclone copy --max-age 24h --no-traverse /path/to/source s3:bucket```@@ -448,7 +448,7 @@ the objects, as no data is transferred.For rclone to use server-side copy, you must use the same remote for thesource and destination.-```sh+```consolerclone copy s3:source-bucket s3:destination-bucket```@@ -469,7 +469,7 @@ For example, with AWS S3, if you can increase the number of checkers to valueslike 200. If you are doing a server-side copy, you can also increase the numberof transfers to 200.-```sh+```consolerclone sync --transfers 200 --checkers 200 --checksum s3:source-bucket s3:destination-bucket```@@ -589,7 +589,7 @@ version followed by a `cleanup` of the old versions.Show current version and all the versions with `--s3-versions` flag.-```sh+```console$ rclone -q ls s3:cleanup-test9 one.txt@@ -602,7 +602,7 @@ $ rclone -q --s3-versions ls s3:cleanup-testRetrieve an old version-```sh+```console$ rclone -q --s3-versions copy s3:cleanup-test/one-v2016-07-04-141003-000.txt /tmp$ ls -l /tmp/one-v2016-07-04-141003-000.txt@@ -611,7 +611,7 @@ $ ls -l /tmp/one-v2016-07-04-141003-000.txtClean up all the old versions and show that they've gone.-```sh+```console$ rclone -q backend cleanup-hidden s3:cleanup-test$ rclone -q ls s3:cleanup-test@@ -627,7 +627,7 @@ When using `--s3-versions` flag rclone is relying on the file nameto work out whether the objects are versions or not. Versions' namesare created by inserting timestamp between file name and its extension.-```sh+```text9 file.txt8 file-v2023-07-17-161032-000.txt16 file-v2023-06-15-141003-000.txt@@ -2598,7 +2598,7 @@ upload_cutoff = 0Here is an example of making an [Alibaba Cloud (Aliyun) OSS](https://www.alibabacloud.com/product/oss/)configuration. First run:-```sh+```consolerclone config```@@ -2875,7 +2875,7 @@ use the secret key as `xxxxxx/xxxx` it will work fine.Here is an example of making an [China Mobile Ecloud Elastic Object Storage (EOS)](https:///ecloud.10086.cn/home/product-introduction/eos/)configuration. First run:-```sh+```consolerclone config```@@ -3131,7 +3131,7 @@ services.Here is an example of making a Cloudflare R2 configuration. First run:-```sh+```consolerclone config```@@ -3916,7 +3916,7 @@ v2_auth>Here is an example of making an [IDrive e2](https://www.idrive.com/e2/)configuration. First run:-```sh+```consolerclone config```@@ -4435,7 +4435,7 @@ leviia s3Here is an example of making a [Liara Object Storage](https://liara.ir/landing/object-storage)configuration. First run:-```sh+```consolerclone config```@@ -4538,7 +4538,7 @@ storage_class =Here is an example of making a [Linode Object Storage](https://www.linode.com/products/object-storage/)configuration. First run:-```sh+```consolerclone config```@@ -4695,7 +4695,7 @@ endpoint = eu-central-1.linodeobjects.comHere is an example of making a [Magalu Object Storage](https://magalu.cloud/object-storage/)configuration. First run:-```sh+```consolerclone config```@@ -4818,7 +4818,7 @@ included in existing Pro plans.Here is an example of making a configuration. First run:-```sh+```consolerclone config```@@ -5361,7 +5361,7 @@ acl = privateHere is an example of making a [Petabox](https://petabox.io/)configuration. First run:-```sh+```consolerclone config```@@ -5532,7 +5532,7 @@ To configure rclone for Pure Storage FlashBlade:First run:-```sh+```consolerclone config```@@ -5833,7 +5833,7 @@ FileLu S5 is designed for scalability, security, and simplicity, with predictablHere is an example of making a configuration. First run:-```sh+```consolerclone config```diff --git a/docs/content/seafile.md b/docs/content/seafile.mdindex e2f5ea74b..b15044b04 100644--- a/docs/content/seafile.md+++ b/docs/content/seafile.md@@ -30,7 +30,7 @@ There are two distinct modes you can setup your remote:Here is an example of making a seafile configuration for a user with **no**two-factor authentication. First run-```sh+```consolerclone config```@@ -108,26 +108,26 @@ server and can now be used like this:See all libraries-```sh+```consolerclone lsd seafile:```Create a new library-```sh+```consolerclone mkdir seafile:library```List the contents of a library-```sh+```consolerclone ls seafile:library```Sync `/home/local/directory` to the remote library, deleting anyexcess files in the library.-```sh+```consolerclone sync --interactive /home/local/directory seafile:library```@@ -215,26 +215,26 @@ pointing at the root of the library `My Library`:See all files in the library:-```sh+```consolerclone lsd seafile:```Create a new directory inside the library-```sh+```consolerclone mkdir seafile:directory```List the contents of a directory-```sh+```consolerclone ls seafile:directory```Sync `/home/local/directory` to the remote library, deleting anyexcess files in the library.-```sh+```consolerclone sync --interactive /home/local/directory seafile:```@@ -264,16 +264,16 @@ as they can't be used in JSON strings.Rclone supports generating share links for non-encrypted libraries only.They can either be for a file or a directory:-```sh-rclone link seafile:seafile-tutorial.doc+```console+$ rclone link seafile:seafile-tutorial.dochttp://my.seafile.server/f/fdcd8a2f93f84b8b90f4/```or if run on a directory you will get:-```sh-rclone link seafile:dir+```console+$ rclone link seafile:dirhttp://my.seafile.server/d/9ea2455f6f55478bbb0d/```diff --git a/docs/content/sftp.md b/docs/content/sftp.mdindex ab717bdb6..f53541892 100644--- a/docs/content/sftp.md+++ b/docs/content/sftp.md@@ -42,7 +42,7 @@ the server, see [shell access considerations](#shell-access-considerations).Here is an example of making an SFTP configuration. First run-```sh+```consolerclone config```@@ -100,39 +100,39 @@ This remote is called `remote` and can now be used like this:See all directories in the home directory-```sh+```consolerclone lsd remote:```See all directories in the root directory-```sh+```consolerclone lsd remote:/```Make a new directory-```sh+```consolerclone mkdir remote:path/to/directory```List the contents of a directory-```sh+```consolerclone ls remote:path/to/directory```Sync `/home/local/directory` to the remote directory, deleting anyexcess files in the directory.-```sh+```consolerclone sync --interactive /home/local/directory remote:directory```Mount the remote path `/srv/www-data/` to the local path`/mnt/www-data`-```sh+```consolerclone mount remote:/srv/www-data/ /mnt/www-data```@@ -158,7 +158,7 @@ key_pem = -----BEGIN RSA PRIVATE KEY-----\nMaMbaIXtE\n0gAMbMbaSsd\nMbaass\n-----This will generate it correctly for key_pem for use in the config:-```sh+```consoleawk '{printf "%s\\n", $0}' < ~/.ssh/id_rsa```@@ -202,7 +202,7 @@ merged file in both places.Note: the cert must come first in the file. e.g.-```sh+```consolecat id_rsa-cert.pub id_rsa > merged_key```@@ -229,7 +229,7 @@ known_hosts_file = ~/.ssh/known_hostsAlternatively you can create your own known hosts file like this:-```sh+```consolessh-keyscan -t dsa,rsa,ecdsa,ed25519 example.com >> known_hosts```@@ -272,13 +272,13 @@ Note that there seem to be various problems with using an ssh-agent onmacOS due to recent changes in the OS. The most effective work-aroundseems to be to start an ssh-agent in each session, e.g.-```sh+```consoleeval `ssh-agent -s` && ssh-add -A```And then at the end of the session-```sh+```consoleeval `ssh-agent -k````diff --git a/docs/content/sharefile.md b/docs/content/sharefile.mdindex c40105f9c..eef5ecdc6 100644--- a/docs/content/sharefile.md+++ b/docs/content/sharefile.md@@ -17,7 +17,7 @@ through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -96,19 +96,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your ShareFile-```sh+```consolerclone lsd remote:```List all the files in your ShareFile-```sh+```consolerclone ls remote:```To copy a local directory to an ShareFile directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/sia.md b/docs/content/sia.mdindex 2ffdd0233..35b11d290 100644--- a/docs/content/sia.md+++ b/docs/content/sia.md@@ -61,7 +61,7 @@ Notes:Here is an example of how to make a `sia` remote called `mySia`.First, run:-```sh+```consolerclone config```@@ -117,19 +117,19 @@ Once configured, you can then use `rclone` like this:- List directories in top level of your Sia storage- ```sh+ ```consolerclone lsd mySia:```- List all the files in your Sia storage- ```sh+ ```consolerclone ls mySia:```- Upload a local directory to the Sia directory called *backup*- ```sh+ ```consolerclone copy /home/source mySia:backup```diff --git a/docs/content/smb.md b/docs/content/smb.mdindex 7fcd91266..1ef15a7eb 100644--- a/docs/content/smb.md+++ b/docs/content/smb.md@@ -36,7 +36,7 @@ Here is an example of making a SMB configuration.First run-```sh+```consolerclone config```diff --git a/docs/content/storj.md b/docs/content/storj.mdindex 53ab22010..c133b1904 100644--- a/docs/content/storj.md+++ b/docs/content/storj.md@@ -119,7 +119,7 @@ To make a new Storj configuration you need one of the following:Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -333,7 +333,7 @@ Once configured you can then use `rclone` like this.Use the `mkdir` command to create new bucket, e.g. `bucket`.-```sh+```consolerclone mkdir remote:bucket```@@ -341,7 +341,7 @@ rclone mkdir remote:bucketUse the `lsf` command to list all buckets.-```sh+```consolerclone lsf remote:```@@ -351,24 +351,32 @@ Note the colon (`:`) character at the end of the command line.Use the `rmdir` command to delete an empty bucket.- rclone rmdir remote:bucket+```console+rclone rmdir remote:bucket+```Use the `purge` command to delete a non-empty bucket with all its content.- rclone purge remote:bucket+```console+rclone purge remote:bucket+```### Upload objectsUse the `copy` command to upload an object.- rclone copy --progress /home/local/directory/file.ext remote:bucket/path/to/dir/+```console+rclone copy --progress /home/local/directory/file.ext remote:bucket/path/to/dir/+```The `--progress` flag is for displaying progress information.Remove it if you don't need this information.Use a folder in the local path to upload all its objects.- rclone copy --progress /home/local/directory/ remote:bucket/path/to/dir/+```console+rclone copy --progress /home/local/directory/ remote:bucket/path/to/dir/+```Only modified files will be copied.@@ -376,57 +384,70 @@ Only modified files will be copied.Use the `ls` command to list recursively all objects in a bucket.-```sh+```consolerclone ls remote:bucket```-Add the folder to the remote path to list recursively all objects in this folder.-```sh-rclone ls remote:bucket-```+```console+$ rclone ls remote:bucket/path/to/dir/+```Use the `lsf` command to list non-recursively all objects in a bucket or a folder.- rclone lsf remote:bucket/path/to/dir/+```console+rclone lsf remote:bucket/path/to/dir/+```### Download objectsUse the `copy` command to download an object.- rclone copy --progress remote:bucket/path/to/dir/file.ext /home/local/directory/+```console+rclone copy --progress remote:bucket/path/to/dir/file.ext /home/local/directory/+```The `--progress` flag is for displaying progress information.Remove it if you don't need this information.Use a folder in the remote path to download all its objects.- rclone copy --progress remote:bucket/path/to/dir/ /home/local/directory/+```console+rclone copy --progress remote:bucket/path/to/dir/ /home/local/directory/+```### Delete objectsUse the `deletefile` command to delete a single object.- rclone deletefile remote:bucket/path/to/dir/file.ext+```console+rclone deletefile remote:bucket/path/to/dir/file.ext+```Use the `delete` command to delete all object in a folder.- rclone delete remote:bucket/path/to/dir/+```console+rclone delete remote:bucket/path/to/dir/+```### Print the total size of objectsUse the `size` command to print the total size of objects in a bucket or a folder.- rclone size remote:bucket/path/to/dir/+```console+rclone size remote:bucket/path/to/dir/+```### Sync two LocationsUse the `sync` command to sync the source to the destination,changing the destination only, deleting any excess files.- rclone sync --interactive --progress /home/local/directory/ remote:bucket/path/to/dir/+```console+rclone sync --interactive --progress /home/local/directory/ remote:bucket/path/to/dir/+```The `--progress` flag is for displaying progress information.Remove it if you don't need this information.@@ -436,15 +457,21 @@ to see exactly what would be copied and deleted.The sync can be done also from Storj to the local file system.- rclone sync --interactive --progress remote:bucket/path/to/dir/ /home/local/directory/+```console+rclone sync --interactive --progress remote:bucket/path/to/dir/ /home/local/directory/+```Or between two Storj buckets.- rclone sync --interactive --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/+```console+rclone sync --interactive --progress remote-us:bucket/path/to/dir/ remote-europe:bucket/path/to/dir/+```Or even between another cloud storage and Storj.- rclone sync --interactive --progress s3:bucket/path/to/dir/ storj:bucket/path/to/dir/+```console+rclone sync --interactive --progress s3:bucket/path/to/dir/ storj:bucket/path/to/dir/+```## Limitationsdiff --git a/docs/content/sugarsync.md b/docs/content/sugarsync.mdindex 2075e00c7..deb13145d 100644--- a/docs/content/sugarsync.md+++ b/docs/content/sugarsync.md@@ -17,7 +17,7 @@ can do with rclone. `rclone config` walks you through it.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -82,19 +82,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories (sync folders) in top level of your SugarSync-```sh+```consolerclone lsd remote:```List all the files in your SugarSync folder "Test"-```sh+```consolerclone ls remote:Test```To copy a local directory to an SugarSync folder called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/swift.md b/docs/content/swift.mdindex 4c221f876..fd5e0c2ca 100644--- a/docs/content/swift.md+++ b/docs/content/swift.md@@ -23,7 +23,7 @@ command.) You may put subdirectories in too, e.g. `remote:container/path/to/dirHere is an example of making a swift configuration. First run-```sh+```consolerclone config```@@ -126,26 +126,26 @@ This remote is called `remote` and can now be used like thisSee all containers-```sh+```consolerclone lsd remote:```Make a new container-```sh+```consolerclone mkdir remote:container```List the contents of a container-```sh+```consolerclone ls remote:container```Sync `/home/local/directory` to the remote container, deleting anyexcess files in the container.-```sh+```consolerclone sync --interactive /home/local/directory remote:container```diff --git a/docs/content/ulozto.md b/docs/content/ulozto.mdindex 823d1c4d2..18eda03a3 100644--- a/docs/content/ulozto.md+++ b/docs/content/ulozto.md@@ -17,7 +17,7 @@ The initial setup for Uloz.to involves filling in the user credentials.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -77,19 +77,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList folders in root level folder:-```sh+```consolerclone lsd remote:```List all the files in your root folder:-```sh+```consolerclone ls remote:```To copy a local folder to a Uloz.to folder called backup:-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/union.md b/docs/content/union.mdindex 0a6fe6291..b3107c9a1 100644--- a/docs/content/union.md+++ b/docs/content/union.md@@ -35,7 +35,7 @@ mydrive:private/backup/../desktop`.Here is an example of how to make a union called `remote` for local folders.First run:-```sh+```consolerclone config```@@ -101,20 +101,20 @@ Once configured you can then use `rclone` like this,List directories in top level in `remote1:dir1`, `remote2:dir2` and `remote3:dir3`-```sh+```consolerclone lsd remote:```List all the files in `remote1:dir1`, `remote2:dir2` and `remote3:dir3`-```sh+```consolerclone ls remote:```Copy another local directory to the union directory called source, which will beplaced into `remote3:dir3`-```sh+```consolerclone copy C:\source remote:source```diff --git a/docs/content/uptobox.md b/docs/content/uptobox.mdindex 2e4ca3617..58f10756b 100644--- a/docs/content/uptobox.md+++ b/docs/content/uptobox.md@@ -22,7 +22,7 @@ it in your [account settings](https://uptobox.com/my_account).Here is an example of how to make a remote called `remote` with the default setup.First run:-```sh+```consolerclone config```@@ -76,19 +76,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your Uptobox-```sh+```consolerclone lsd remote:```List all the files in your Uptobox-```sh+```consolerclone ls remote:```To copy a local directory to an Uptobox directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/webdav.md b/docs/content/webdav.mdindex 127f3f79b..45490ea23 100644--- a/docs/content/webdav.md+++ b/docs/content/webdav.md@@ -18,7 +18,7 @@ connecting to then rclone can enable extra features.Here is an example of how to make a remote called `remote`. First run:-```sh+```consolerclone config```@@ -93,19 +93,19 @@ Once configured you can then use `rclone` like this (replace `remote` with the nList directories in top level of your WebDAV-```sh+```consolerclone lsd remote:```List all the files in your WebDAV-```sh+```consolerclone ls remote:```To copy a local directory to an WebDAV directory called backup-```sh+```consolerclone copy /home/source remote:backup```diff --git a/docs/content/yandex.md b/docs/content/yandex.mdindex 9eb35f653..70174cf8b 100644--- a/docs/content/yandex.md+++ b/docs/content/yandex.md@@ -12,7 +12,7 @@ versionIntroduced: "v1.26"Here is an example of making a yandex configuration. First run-```sh+```consolerclone config```@@ -73,26 +73,26 @@ Once configured you can then use `rclone` like this (replace `remote` with the nSee top level directories-```sh+```consolerclone lsd remote:```Make a new directory-```sh+```consolerclone mkdir remote:directory```List the contents of a directory-```sh+```consolerclone ls remote:directory```Sync `/home/local/directory` to the remote path, deleting anyexcess files in the path.-```sh+```consolerclone sync --interactive /home/local/directory remote:directory```diff --git a/docs/content/zoho.md b/docs/content/zoho.mdindex df4efee97..a5efd3c50 100644--- a/docs/content/zoho.md+++ b/docs/content/zoho.md@@ -13,7 +13,7 @@ created by [Zoho](https://zoho.com).Here is an example of making a zoho configuration. First run-```sh+```consolerclone config```@@ -93,26 +93,26 @@ Once configured you can then use `rclone` like this (replace `remote` with the nSee top level directories-```sh+```consolerclone lsd remote:```Make a new directory-```sh+```consolerclone mkdir remote:directory```List the contents of a directory-```sh+```consolerclone ls remote:directory```Sync `/home/local/directory` to the remote path, deleting anyexcess files in the path.-```sh+```consolerclone sync --interactive /home/local/directory remote:directory```diff --git a/lib/http/auth.go b/lib/http/auth.goindex babd91163..d883cba64 100644--- a/lib/http/auth.go+++ b/lib/http/auth.go@@ -34,7 +34,7 @@ authentication. Bcrypt is recommended.To create an htpasswd file:-` + "```sh" + `+` + "```console" + `touch htpasswdhtpasswd -B htpasswd userhtpasswd -B htpasswd anotherUserdiff --git a/lib/http/server.go b/lib/http/server.goindex 83d0162dd..835030cf7 100644--- a/lib/http/server.go+++ b/lib/http/server.go@@ -90,7 +90,7 @@ It can be configured with .socket and .service unit files as described inSocket activation can be tested ad-hoc with the ` + "`systemd-socket-activate`" + `command-` + "```sh" + `+` + "```console" + `systemd-socket-activate -l 8000 -- rclone serve` + "```" + `diff --git a/lib/transform/gen_help.go b/lib/transform/gen_help.goindex ec93ea2a0..9abd65a50 100644--- a/lib/transform/gen_help.go+++ b/lib/transform/gen_help.go@@ -97,7 +97,7 @@ func (e example) output() string {func sprintExamples() string {s := "Examples:\n"for _, e := range examples {- s += fmt.Sprintf("\n```sh\n%s\n", e.command())+ s += fmt.Sprintf("\n```console\n%s\n", e.command())s += fmt.Sprintf("// Output: %s\n```\n", e.output())}return sdiff --git a/lib/transform/transform.md b/lib/transform/transform.mdindex d1c674b30..42a31ce09 100644--- a/lib/transform/transform.md+++ b/lib/transform/transform.md@@ -151,82 +151,82 @@ SquareBracketExamples:-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,uppercase"-// Output: STORIES/THE QUICK BROWN FOX!.TXT+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,uppercase"+STORIES/THE QUICK BROWN FOX!.TXT```-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,replace=Fox:Turtle" --name-transform "all,replace=Quick:Slow"-// Output: stories/The Slow Brown Turtle!.txt+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,replace=Fox:Turtle" --name-transform "all,replace=Quick:Slow"+stories/The Slow Brown Turtle!.txt```-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,base64encode"-// Output: c3Rvcmllcw==/VGhlIFF1aWNrIEJyb3duIEZveCEudHh0+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,base64encode"+c3Rvcmllcw==/VGhlIFF1aWNrIEJyb3duIEZveCEudHh0```-```sh-rclone convmv "c3Rvcmllcw==/VGhlIFF1aWNrIEJyb3duIEZveCEudHh0" --name-transform "all,base64decode"-// Output: stories/The Quick Brown Fox!.txt+```console+$ rclone convmv "c3Rvcmllcw==/VGhlIFF1aWNrIEJyb3duIEZveCEudHh0" --name-transform "all,base64decode"+stories/The Quick Brown Fox!.txt```-```sh-rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,nfc"-// Output: stories/The Quick Brown 🦊 Fox Went to the Café!.txt+```console+$ rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,nfc"+stories/The Quick Brown 🦊 Fox Went to the Café!.txt```-```sh-rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,nfd"-// Output: stories/The Quick Brown 🦊 Fox Went to the Café!.txt+```console+$ rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,nfd"+stories/The Quick Brown 🦊 Fox Went to the Café!.txt```-```sh-rclone convmv "stories/The Quick Brown 🦊 Fox!.txt" --name-transform "all,ascii"-// Output: stories/The Quick Brown Fox!.txt+```console+$ rclone convmv "stories/The Quick Brown 🦊 Fox!.txt" --name-transform "all,ascii"+stories/The Quick Brown Fox!.txt```-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,trimsuffix=.txt"-// Output: stories/The Quick Brown Fox!+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,trimsuffix=.txt"+stories/The Quick Brown Fox!```-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,prefix=OLD_"-// Output: OLD_stories/OLD_The Quick Brown Fox!.txt+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,prefix=OLD_"+OLD_stories/OLD_The Quick Brown Fox!.txt```-```sh-rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,charmap=ISO-8859-7"-// Output: stories/The Quick Brown _ Fox Went to the Caf_!.txt+```console+$ rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,charmap=ISO-8859-7"+stories/The Quick Brown _ Fox Went to the Caf_!.txt```-```sh-rclone convmv "stories/The Quick Brown Fox: A Memoir [draft].txt" --name-transform "all,encoder=Colon,SquareBracket"-// Output: stories/The Quick Brown Fox: A Memoir [draft].txt+```console+$ rclone convmv "stories/The Quick Brown Fox: A Memoir [draft].txt" --name-transform "all,encoder=Colon,SquareBracket"+stories/The Quick Brown Fox: A Memoir [draft].txt```-```sh-rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,truncate=21"-// Output: stories/The Quick Brown 🦊 Fox+```console+$ rclone convmv "stories/The Quick Brown 🦊 Fox Went to the Café!.txt" --name-transform "all,truncate=21"+stories/The Quick Brown 🦊 Fox```-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,command=echo"-// Output: stories/The Quick Brown Fox!.txt+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,command=echo"+stories/The Quick Brown Fox!.txt```-```sh-rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}"-// Output: stories/The Quick Brown Fox!-20250830+```console+$ rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{YYYYMMDD}"+stories/The Quick Brown Fox!-20250830```-```sh-rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}"-// Output: stories/The Quick Brown Fox!-2025-08-30 1234AM+```console+$ rclone convmv "stories/The Quick Brown Fox!" --name-transform "date=-{macfriendlytime}"+stories/The Quick Brown Fox!-2025-08-30 1234AM```-```sh-rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,regex=[\\.\\w]/ab"-// Output: ababababababab/ababab ababababab ababababab ababab!abababab+```console+$ rclone convmv "stories/The Quick Brown Fox!.txt" --name-transform "all,regex=[\\.\\w]/ab"+ababababababab/ababab ababababab ababababab ababab!abababab```diff --git a/vfs/vfs.md b/vfs/vfs.mdindex 612facf36..ba2b891c7 100644--- a/vfs/vfs.md+++ b/vfs/vfs.md@@ -34,20 +34,20 @@ You can send a `SIGHUP` signal to rclone for it to flush alldirectory caches, regardless of how old they are. Assuming only onerclone instance is running, you can reset the cache like this:-```sh+```consolekill -SIGHUP $(pidof rclone)```If you configure rclone with a [remote control](/rc) then you can userclone rc to flush the whole directory cache:-```sh+```consolerclone rc vfs/forget```Or individual files or directories:-```sh+```consolerclone rc vfs/forget file=path/to/file dir=path/to/dir```@@ -462,7 +462,7 @@ Note that some backends won't create metadata unless you pass in theFor example, using `rclone mount` with `--metadata --vfs-metadata-extension .metadata`we get-```sh+```console$ ls -l /mnt/total 1048577-rw-rw-r-- 1 user user 1073741824 Mar 3 16:03 1G